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ältprovider_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 mit410 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:
502 mit upstream_stream_failure zurück, keine Teilantwort. Siehe Streaming.
Eine Anfrage debuggen
Sende eindebug-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.