エラー

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 応答を リクエストログ。