error.code と HTTP ステータスで処理を分岐してください。Phaseo のエラーはどのエンドポイントでも同じ JSON 本文を返します。その error オブジェクト(code、message、type、param)は OpenAI 互換 SDK が読み取る形式なので、SDK の例外には Phaseo のメッセージが入ります。
すべてのエラーに含まれるフィールド
一部のエラーには、さらに情報が追加されます。
エラーの種類
error.type は OpenAI の公開されているエラーの種類に従い、HTTP ステータスから決まります。
/v1/messages のエラーも同じ本文を使うため、Anthropic SDK でも error.type と error.message を読み取れます。
エラーコード
再試行すべきエラーを見分ける
試行回数の上限と全体の期限を設定してください。レート制限ヘッダーについてはレート制限を参照してください。
プロバイダーが失敗した場合
Phaseo がプロバイダーに到達したもののリクエストが失敗した場合、provider_failure_diagnostics に category、hint、provider が入ります。カテゴリーは次のとおりです。
モデルまたはエンドポイントが利用できない場合
unsupported_model_or_endpoint エラーには、provider_candidate_diagnostics、provider_enablement、missing_pricing_providers、routing_diagnostics が含まれることがあります。これらを合わせると、モデルがまだ有効でないのか、モデルがエンドポイントに対応していないのか、料金が設定されていないのか、ロールアウトの制限なのかを区別できます。
モデルが提供終了になった場合
提供終了となったモデルも、いずれかのプロバイダーが提供している間は引き続き利用できます。提供するプロバイダーがなくなると、リクエストは410 と model_retired で失敗します。
model はリクエストしたモデル、retired_at は提供終了日時(または null)、replacement_model は推奨される代替モデル(または null)です。
再試行しても解決しないため、モデル ID を変更してください。移行中もこれらのリクエストを動かし続けるには、リクエストの models リストに代替モデルを追加するか、ワークスペースで提供終了モデルのルーティングを有効にします。モデルの非推奨化と提供終了を参照してください。
ストリーム中のエラー
ストリーミング開始前にリクエストが失敗した場合は、上記の JSON エラー本文が返されます。ストリーム途中で失敗した場合、ストリームは通常の終了ではなく、エンドポイントの失敗イベントで終わります。
部分的な出力は不完全なものとして扱い、再試行を提示してください。Chat Completions の
error フレームには同じエラーオブジェクトが含まれ、error.type はコードから決まります。
502 と upstream_stream_failure が返されます。ストリーミングを参照してください。
リクエストをデバッグする
debug オブジェクトを送信すると、ルーティングのトレースと上流のペイロードを取得できます。
trace_level は summary または full です。デバッグペイロードにはリクエストの内容が含まれることがあるため、開発環境か、厳密に管理された環境でのみ使ってください。debug を参照してください。
リクエストが失敗した場合は、ステータスページで障害を確認し、ペイロードをエンドポイントのリファレンスページと比較し、generation_id をエンドポイントとモデルと一緒にログに記録してください。サポートに問い合わせる際は generation_id を伝えてください。