Docs
API-Referenz

Fehler

Die zwei Fehlerformen je Oberfläche, In-Stream-Fehler und die vollständige Statuscode-Tabelle

Die API gibt je nach aufgerufener Oberfläche zwei unterschiedliche Fehlerformen zurück. Stimmen Sie Ihren Handler auf die Oberfläche ab.

Der Fehler-Body im OpenAI-Stil ist ein flaches Objekt, nicht das OpenAI-kanonische verschachtelte error-Objekt. Parsen Sie ihn nicht als error.message. Siehe die Form unten.

Fehler im OpenAI-Stil

Die Endpunkte im OpenAI-Stil (Chat Completions und Files) geben auf dem Standard-Fehlerpfad ein flaches JSON-Objekt zurück.

{
  "error": "Invalid request: messages is required",
  "code": "HTTP_400",
  "request_id": "req_..."
}
  • error ist die Nachrichtenzeichenkette.
  • code ist HTTP_<status>, zum Beispiel HTTP_400.
  • request_id entspricht dem X-Request-Id-Response-Header.

Dies ist nicht das OpenAI-kanonische verschachtelte Fehlerobjekt. Ein OpenAI-Client, der error.message erwartet, findet es hier nicht.

In-Stream-Fehler

Wenn mitten im Stream ein Inferenzfehler auftritt, gibt der Stream einen Fehler-Chunk aus und schließt dann mit [DONE].

{
  "error": {
    "message": "inference backend unavailable",
    "type": "service_unavailable",
    "code": "inference_error"
  }
}
data: [DONE]

Fehler im Anthropic-Stil

Die Endpunkte im Anthropic-Stil (Messages und Batches) geben die Anthropic-Fehlerform zurück.

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "max_tokens is required"
  }
}

Der error.type wird aus dem HTTP-Status abgeleitet.

Statuserror.type
400invalid_request_error
422invalid_request_error
401authentication_error
403permission_error
404not_found_error
413request_too_large
429rate_limit_error
500api_error
503overloaded_error
529overloaded_error

Statuscodes

CodeWann er auftritt
200Erfolg
201Ressource erstellt (zum Beispiel eine Datei oder ein Batch)
204Erfolg ohne Body (zum Beispiel ein Löschvorgang)
400Fehlerhafte oder ungültige Anfrage
401Fehlender oder ungültiger API-Schlüssel
403Schlüssel ohne Berechtigung oder 0 Agent-Slots
404Unbekannter Pfad oder Ressource
413Anfrage-Body überschreitet das Kontextlimit
415Nicht unterstützter Medientyp
422Anfrage hat die Validierung nicht bestanden
429Rate-Limit, Concurrency, Slot oder Budget überschritten
500Interner Fehler
502Upstream-Gateway-Fehler
503Dienst nicht verfügbar. Trägt Retry-After

Weiter