メインコンテンツへスキップ
メッセージのテキストではなく、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 を伝えてください。
最終更新日 2026年11月5日