Konzepte

Fehler

Die OpenAI-förmige Fehler-Taxonomie.

Als Markdown anzeigen

Fehler haben immer die OpenAI-Form:

1{ "error": { "message": "…", "type": "…", "code": "…" } }

Statusreferenz

HTTPcodetypeBedeutung / Client-Aktion
400invalid_requestinvalid_request_errorFehlerhafter Body, über 2 MiB oder fehlendes model.
401invalid_api_keyinvalid_request_errorUngültiger oder widerrufener Schlüssel — nicht erneut versuchen.
402insufficient_creditsinsufficient_quotaGuthaben ≤ 0 — aufladen, dann erneut versuchen.
404model_not_foundinvalid_request_errorUnbekannte oder deaktivierte Modell-ID.
429rate_limit_exceededrate_limit_errorRPM pro Schlüssel erreicht — Backoff (gleitendes 60-s-Fenster).
429upstream_rate_limitedrate_limit_errorAnbieter hat uns gedrosselt — mit Backoff erneut versuchen.
500internal_errorapi_errorGateway-Bug — wiederholbar.
502upstream_auth_errorapi_errorAnbieter hat unsere Anmeldedaten abgelehnt — unser Problem.
502upstream_errorapi_errorAnbieter-5xx / Verbindungsfehler — wiederholbar.

Durchgereichte Fehler

Upstream-4xx-Bodies, die bereits die OpenAI-Form haben (z. B. anbieterseitige Validierung Ihrer Parameter), werden mit ihrem ursprünglichen Status durchgereicht statt neu verpackt.

Hinweise zum erneuten Versuch

Wiederholbar

429, 500, 502 upstream_error. Nutzen Sie exponentiellen Backoff mit Jitter.

So nicht wiederholbar

400, 401, 404. Beheben Sie zuerst die Anfrage oder den Schlüssel. 402 ist nur nach einer Aufladung wiederholbar.