Zum Hauptinhalt springen
Jeder Chat-Endpunkt gibt Fehler in derselben Struktur wie der API-Standard zurück, mit dem er kompatibel ist (OpenAI, Anthropic oder Gemini). Jede Fehlerantwort enthält außerdem einen X-Request-Id-Header und liefert nur die Informationen, die du zum Debuggen deiner Anfrage benötigst.

​
OpenAI — /v1/chat/completions (sowie Bild-/Video-Endpunkte)

{
  "error": {
    "message": "Insufficient credits",
    "type": "insufficient_quota",
    "code": "insufficient_credits",
    "param": null
  }
}

​
Anthropic — /v1/messages

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key"
  }
}

​
Gemini — /v1beta/models/{model}:generateContent

{
  "error": {
    "code": 400,
    "message": "model is required",
    "status": "INVALID_ARGUMENT"
  }
}

​
Statuszuordnung

Der Fehler-type / status wird aus dem HTTP-Status abgeleitet:
HTTPOpenAI typeAnthropic typeGemini status
400invalid_request_errorinvalid_request_errorINVALID_ARGUMENT
401authentication_errorauthentication_errorUNAUTHENTICATED
403permission_errorpermission_errorPERMISSION_DENIED
404not_found_errornot_found_errorNOT_FOUND
402insufficient_quotainvalid_request_errorRESOURCE_EXHAUSTED
429rate_limit_errorrate_limit_errorRESOURCE_EXHAUSTED
5xxapi_errorapi_error / overloaded_errorSERVER_ERROR / UNAVAILABLE