Fehler

Fehler enthalten einen maschinenlesbaren Code und eine Meldung. Unterscheiden Sie eine abgelehnte Anfrage von einem unklaren Ergebnis, das möglicherweise bereits Anbieterkapazität verbraucht hat.

Fehlerformat

JSON-Fehler

{
  "error": {
    "message": "Insufficient available credit for this request. Add credit or resolve pending reservations.",
    "type": "invalid_request_error",
    "code": "insufficient_credit"
  }
}

Verwenden Sie die x-request-id der Antwort und Ihre Aktivitätsaufzeichnungen, um eine Anfrage zu untersuchen. Fügen Sie einem Supportbericht niemals den geheimen Schlüssel oder Unterhaltungsinhalte bei.

Statuscodes

Status	Bedeutung / Aktion
400	Ungültiger Anfrageinhalt, unbekannte Felder, Kontextlimit oder nicht unterstützte Fähigkeit.
401	Fehlender, ungültiger oder widerrufener Bearer-Schlüssel.
402	Nicht genügend verfügbares Guthaben oder das Ausgabenlimit des API-Schlüssels wurde erreicht.
403	Nicht verfügbares Konto oder ein Modell außerhalb der Freigabeliste des Schlüssels.
404	Unbekannter Endpunkt oder nicht freigegebene Modell-ID.
409	Eine Idempotenzreferenz wurde bereits verwendet.
413 / 415	Anfrageinhalt zu groß oder anderer Inhaltstyp als application/json.
429	Raten-, Anfrage- oder Parallelitätslimit. Warten Sie vor einem erneuten Versuch das Retry-After-Intervall ab; ausstehende Reservierungen können einen Abgleich erfordern.
502	Anbieterfehler, ungültiger Stream oder nicht verfügbare Nutzungsdaten.
503	Wartung, Anbieterbereitschaft oder Startkonfiguration.

Unklare Ergebnisse

Eine Zeitüberschreitung beim vorgelagerten Anbieter oder eine Antwort usage_unavailable kann eine ausstehende Reservierung hinterlassen. Diese Fehler enthalten X-Should-Retry: false, um automatische SDK-Wiederholungen zu unterdrücken. Anbieterfehlercodes unterscheiden zwischen nicht verfügbaren Modellen, ungültigen Parametern, Authentifizierung, Kontingenten und Drosselung, ohne vertrauliche Anbieterdetails zurückzugeben. Prüfen Sie die Aktivität und gleichen Sie das erste Ergebnis ab, bevor Sie einen neuen Aufruf veranlassen.

Idempotenz

Ein optionaler Idempotency-Key enthält 1–128 Buchstaben, Ziffern, Punkte, Unterstriche, Doppelpunkte oder Bindestriche. Die Wiederverwendung einer Referenz gibt 409 zurück und führt die Inferenz nicht erneut aus. Dies verhindert Duplikate und spielt keine zwischengespeicherten Antworten erneut ab.