Zum Hauptinhalt springen
Verzweige anhand von error.code und dem HTTP-Status, nicht anhand des Meldungstexts. Jeder Phaseo-Fehler hat auf jedem Endpunkt denselben JSON-Body, und sein error-Objekt (code, message, type, param) hat die Form, die OpenAI-kompatible SDKs lesen. Ihre Ausnahmen enthalten daher die Meldung von Phaseo.

Felder in jedem Fehler

Manche Fehler enthalten zusätzlichen Kontext:

Fehlertypen

error.type folgt den dokumentierten Fehlertypen von OpenAI und wird aus dem HTTP-Status abgeleitet: Fehler auf /v1/messages verwenden denselben Body, sodass auch Anthropic-SDKs error.type und error.message finden.

Fehlercodes

Die richtigen Fehler wiederholen

Lege ein Versuchslimit und eine Gesamtfrist fest. Die Ratenlimit-Header findest du unter Ratenlimits.

Wenn ein Anbieter ausfällt

Wenn Phaseo einen Anbieter erreicht hat und die Anfrage trotzdem fehlgeschlagen ist, enthält provider_failure_diagnostics eine category, einen hint und den provider. Kategorien:

Wenn ein Modell oder Endpunkt nicht verfügbar ist

unsupported_model_or_endpoint-Fehler können provider_candidate_diagnostics, provider_enablement, missing_pricing_providers und routing_diagnostics enthalten. Zusammen unterscheiden sie ein Modell, das noch nicht aktiv ist, ein Modell, das den Endpunkt nicht unterstützt, fehlende Preise und Rollout-Einschränkungen.

Wenn ein Modell eingestellt wird

Ein eingestelltes Modell wird weiter bedient, solange irgendein Anbieter es bereitstellt. Sobald keiner es mehr tut, schlagen Anfragen mit 410 und model_retired fehl:
model ist das angefragte Modell, retired_at der Zeitpunkt der Einstellung (oder null) und replacement_model der vorgeschlagene Ersatz (oder null). Ein erneuter Versuch hilft nicht; ändere die Modell-ID. Damit diese Anfragen während der Migration weiter funktionieren, füge den Ersatz zur models-Liste der Anfrage hinzu oder aktiviere das Routing eingestellter Modelle für den Workspace. Siehe Einstellung und Außerbetriebnahme von Modellen.

Fehler während eines Streams

Schlägt eine Anfrage fehl, bevor das Streaming beginnt, erhältst du den oben gezeigten JSON-Fehler-Body. Schlägt sie mitten im Stream fehl, endet der Stream statt mit einem normalen Abschluss mit dem Fehlerereignis des Endpunkts: Behandle die Teilausgabe als unvollständig und biete einen erneuten Versuch an. Der error-Frame von Chat Completions enthält dasselbe Fehlerobjekt, wobei error.type aus dem Code abgeleitet wird:
Eine Anfrage ohne Streaming, deren Anbieter mittendrin ausfällt, gibt 502 mit upstream_stream_failure zurück, keine Teilantwort. Siehe Streaming.

Eine Anfrage debuggen

Sende ein debug-Objekt, um Routing-Traces und die Upstream-Payloads zu erhalten:
trace_level ist summary oder full. Debug-Payloads können den Inhalt deiner Anfrage enthalten, nutze sie daher nur in der Entwicklung oder in streng kontrollierten Umgebungen. Siehe debug. Wenn eine Anfrage fehlschlägt, prüfe die Statusseite auf Störungen, vergleiche deine Payload mit der Referenzseite des Endpunkts und protokolliere generation_id zusammen mit Endpunkt und Modell. Gib generation_id an, wenn du dich an den Support wendest.
Zuletzt geändert am 5. November 2026