Fehlercodes und Fehlermeldungen

Liefert die API einen Statuscode außerhalb des Intervalls von 200 bis 399 zurück, liegt ein Fehler in der Anfrage vor. Folgende Fehler sind erwartbar:

• 400 Bad Request: Die Anfrage kann nicht verarbeitet werden. Es sollte eine Fehlernachricht mitgeliefert werden, die die Gründe dafür erläutert:
  • At most n image(s) may be provided in one request.: Die Anzahl der maximal erlaubten Bilder im gesamten übermittelten Context überschreitet die Kapazitäten des Modells. Entweder müssen Bilder aus dem übermittelten Context entfernt oder ein neuer Context muss eröffnet werden.
  • max_tokens must be at least…: Die maximale Context-Länge des Modells wurde für die Generierung von Text überschritten. Die Fehlermeldung gibt zudem die Anzahl der Überschreitung als Differenz (negativer Wert, Anzahl Token) aus. Der Context muss gekürzt werden.
• 401 Unauthorized: Es wurde kein API-Key im Authorization-Header übermittelt oder der API-Key ist ungültig.
• 408 Request Timeout: Die Anfrage hat die maximal erlaubte Laufzeit von 1.800 Sekunden (30 Minuten) überschritten und wurde abgebrochen. Umfangreiche Aufgaben sollten in kleinere, unabhängige Anfragen aufgeteilt werden.
• 429 Too Many Requests: Das Rate-Limit wurde erreicht. Weitere Anfragen sind innerhalb des aktuellen Zeitfensters nicht möglich. Nach Ablauf des Fensters wird das Limit zurückgesetzt. Rate-Limit-Antworten enthalten keinen Retry-After-Header — implementiere in deinem Client eine feste Wartezeit oder ein exponentielles Backoff.
• 502 Bad Gateway / 503 Service Unavailable: Das Modell ist vorübergehend nicht erreichbar, z. B. aufgrund eines Neustarts oder einer Überlastung. Die Anfrage sollte nach einer kurzen Wartezeit erneut gestellt werden.