エラー

HTTP エラーコード、応答形式、および再試行ルール。

HTTP	意味	推奨されるアクション
400	無効なリクエスト	正しい JSON と必須フィールド
401	無効、凍結、または取り消されたキー	キーをローテーションまたはフリーズ解除する
402	アカウント残高が不足しているか、キーの使用制限に達しています	資金を追加するか、キー制限をリセット/増加します
403	API 許可リストによって拒否されたキーまたはソース IP に対してモデルを使用できません	キーの権限を更新するか、許可された送信元 IP を使用します
404	不明なエンドポイント、モデル、または非同期リクエスト	識別子とパスを確認してください
413	リクエストが大きすぎます	コンテキストサイズを減らす
429	RPM または同時実行性を超えました	名誉 `Retry-After`
500	ゲートウェイエラー	ログの再試行と検査
502/503/504	アップストリームが利用できないかタイムアウトしました	指数バックオフを使用して再試行します

支払いが必要です

会社/アカウントの残高が不十分な場合は HTTP が返されます 402 Payment Required OpenAI 互換エンベロープ内:

{
  "error": {
    "message": "Insufficient account balance.",
    "type": "payment_required",
    "code": "insufficient_balance"
  }
}

同じ安定した理由/コードがリクエスト履歴に記録されます。あ 402 リクエストはプロバイダーの実行前に拒否されるため、資金調達または該当する支出制限が修正されるまで自動的に再試行しないでください。

IP許可リストの拒否

認証された API キーが有効でも、送信元アドレスが有効な個人またはビジネス組織の API 許可リストの外にある場合、Model Gate はアップストリームの実行前にリクエストを拒否します。 OpenAI 互換の応答は HTTP を使用します 403 コード付き ip_not_allowed。 Anthropic 互換の応答は、HTTP で Anthropic エラーエンベロープを使用します 403 そして authentication_error。同じ許可されていないソースから再試行しないでください。構成された許可リストを変更するか、許可されたアドレスからリクエストを送信します。

リトライ 429 後 Retry-After。リトライ 500、 502、 503、そして 504 1/2/4 秒のバックオフで最大 3 回。検証、認証、バランス、または見つからないエラーに対して自動的に再試行しません。

からのリクエストパブリック ID を使用します。 X-Request-ID 応答をリクエストログ。

ストリームヘッダーの後のエラー

HTTP200 がすでに送信された後は、SSE が失敗する可能性があります。応答にはプロトコル互換のエラーイベントが含まれます。ゲートウェイ要求履歴には、ワイヤのステータスとは関係なく、端末の障害が記録されます。不明なアップストリームメッセージはデフォルトで非表示になり、承認されたメッセージは管理者ポリシーによって公開される可能性があり、アップストリームエラーの完全な公開は明示的です。内部アップストリームメタデータと一時的な RAW は引き続き管理者のみが使用できます。ストリームが中断された後の欠落した使用量は不明/確認が必要であり、ワイヤーバイトからの自動推定ではありません。リクエスト ID を保存し、部分的な出力を確認した後でのみ慎重に再試行してください。