はじめにエラー

エラー

エラーは、4xxまたは5xxのステータスとともにJSONで返されます。形式はエンドポイントのプロトコルに従うため、OpenAI SDKとAnthropic SDKはそれぞれ通常の例外クラスを送出します。例外が1つあります。非ストリーミングリクエストが90秒実行された後に発生したエラーは、ステータス200のレスポンスボディで届きます(長時間のリクエストを参照)。

エラーコード

コードステータス発生条件
invalid_api_key401APIキーがない、形式が不正、不明、無効化済み、または期限切れです。期限切れのキーの場合、メッセージにその有効期限が記載されます。
account_suspended403アカウントが一時停止されています。停止が解除されるまで、このアカウントのすべてのキーが拒否されます。サポートにお問い合わせください。
account_banned403アカウントが永久停止されています。キーは無効化され、残りのクレジットは没収されます。
card_network_blocked403カードでのチャージを拒否しました:リクエストがVPN、Tor、またはデータセンターのネットワークから送信されました。
card_account_risk403カードでのチャージを拒否しました:Stripeの不正検知でアカウントが最高リスクと判定されたため、カードではチャージできません。暗号資産でのチャージは引き続き利用できます。
model_not_found404modelに指定したIDは、有効化されているモデルではありません。IDの一覧はGET /v1/modelsで取得できます。
unsupported_content400リクエストに、モデルが受け付けないパートが含まれています:input_modalitiesに含まれない画像や動画のパート、https:// URLではない動画(base64の動画を含む)、https://・http://・data:のいずれでもない画像URL、またはどのモデルも受け付けない音声やファイルのパートです。
content_policy_violation400リクエストが自動の安全性チェックによってブロックされました。
stateless_only400/v1/responsesのリクエストでprevious_response_idまたはbackground: trueが指定されました。代わりに、backgroundを指定せずに会話全体をinputで送信してください。
invalid_request400ボディが検証に失敗した(例:/v1/messagesでmax_tokensがない、nが1以外、/v1/completionsのprompt配列に4件を超えるプロンプトがある、優先ティアのないモデルでservice_tier: "priority"を指定した、ツールの種類がfunction以外(/v1/responsesではcustomとnamespaceも可)、補完エンドポイントのないモデルで/v1/completionsを使用した)、ボディが時間内に受信されなかった(ステータス408)か16 MiBを超えている(ステータス413)、またはモデルがリクエストを拒否した(例:プロンプトがコンテキストウィンドウより長い、モデルが受け付ける数より多くの画像がある)場合です。モデルによる拒否では、モデル自身の4xxステータスとメッセージがそのまま返されます。
insufficient_balance402残高が、推定入力と最低256トークンの出力枠の合計に足りません。チャージしてください。
key_spend_cap_reached402このリクエストの仮押さえ額を、キーの確定済みの利用額と処理中の他のリクエストに加えると、キーの1日・月間・累計のいずれかの支出上限を超えます。
rate_limit_exceeded429キーまたはアカウントの1分あたりのリクエストが多すぎる、アカウントの同時リクエストが多すぎる、アカウントの大きなアップロードが処理中ボディの容量枠を使いすぎている、またはトライアルアカウントで、同じネットワークから1時間以内に2つを超えるトライアルアカウントがリクエストを送信した場合です。1分あたりの制限とトライアルのネットワーク制限ではRetry-Afterが返されます。
capacity_exhausted42930秒間の再試行の間、モデルのすべてのレプリカがビジー状態だった(トライアルアカウントは再試行されず、すぐに失敗します)か、ゲートウェイが一時的に容量の上限に達しているか再起動中です(ステータス503)。Retry-Afterの秒数だけ待ってください。提供能力がまったくないモデルでは、代わりにmodel_unavailableが返されます。料金は発生しません。
model_unavailable503モデルに現在提供能力がありません(GPUの交換中など)。リクエストは再試行されず、すべてのアカウントで即座に失敗します。Retry-Afterは、当社が次にモデルを確認するまでの秒数です。その後に再試行するか、別のモデルを使用してください。料金は発生しません。
safety_unavailable503安全性チェックがタイムアウトしたか失敗したため、チェックなしで送信せずにリクエストを拒否しました。しばらくしてから再試行してください。
card_network_check_unavailable503ネットワークの確認が一時的に利用できないため、カードでのチャージを拒否しました。再試行するか、暗号資産でお支払いください。
upstream_error502モデルのバックエンドが失敗したか、リクエストが10分の制限時間、モデルからの出力がないまま2分経過、または再起動によって停止されました。予期しない内部障害ではステータス500、当社側の短時間の障害や再起動ではステータス503とRetry-After、バックエンドの失敗ではステータス502でこのコードが返され、いずれもレスポンスの送信前です。制限時間に達するのはそれより後です:制限時間はストリームを終了させます。また、90秒を過ぎても実行中の非ストリーミングレスポンスはすでにステータス200で送信されているため、このエラーは、制限時間によるものもそれ以外のものも、Retry-Afterなしでボディ内に返されます(「長時間のリクエスト」を参照)。モデルがまだ出力を生成していなければ、料金は発生しません。リクエストを再試行してください。出力の生成後であれば、推定入力と、失敗または停止までに生成された出力の分が課金されます。切断したクライアントにこのエラーが返されることはなく、出力が生成されていない場合でも推定入力の分が課金されます。

content_policy_violationでブロックされる内容は、利用ポリシーで定義されています。

OpenAI形式

/v1/chat/completions、/v1/responses、/v1/models、/v1/balanceで使われます。codeは上記のコードのいずれかです。例:

json
{
  "error": {
    "type": "rate_limit_error",
    "code": "capacity_exhausted",
    "message": "All model replicas are busy. Retry shortly."
  }
}

Anthropic形式

/v1/messagesで使われます。この形式にはcodeフィールドがないため、HTTPステータスとerror.typeを確認してください。例:

json
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "max_tokens is required."
  }
}

ステータス別のエラータイプ

ステータスOpenAIのerror.typeAnthropicのerror.type
400invalid_request_errorinvalid_request_error
401authentication_errorauthentication_error
402insufficient_quotabilling_error
403permission_errorpermission_error
404not_found_errornot_found_error
408invalid_request_errorinvalid_request_error
413invalid_request_errorrequest_too_large
429rate_limit_errorrate_limit_error
500, 502, 503api_errorapi_error

ヘッダー

  • x-request-idは、エラーを含むすべてのレスポンスに付きます。サポートに問い合わせる際は、この値を伝えてください。
  • Retry-After(秒単位)は、capacity_exhausted、model_unavailable(モデルを次に確認するまでの秒数で、最大15)、1分あたりの制限とトライアルのネットワーク制限によるrate_limit_exceeded、503のupstream_error(当社側の短時間の障害または再起動)に付きます。

リトライのタイミング

エラー対処
capacity_exhaustedRetry-Afterの秒数だけ待ってからリトライしてください。429の場合、有料リクエストはすでに最大30秒間リトライされています。503の場合は、ゲートウェイがキャパシティの上限に達しているか再起動中で、リクエストはモデルに届いていません。
model_unavailableRetry-Afterの秒数だけ待ってからリトライしてください。それが次にモデルを確認するタイミングです。モデルに提供可能なキャパシティがなかったため、リクエストはリトライされずにただちに失敗しました。このような障害は数分続くことがあるため、エラーが続く場合は別のモデルに切り替えてください。
rate_limit_exceeded1分あたりの制限の場合は、Retry-Afterの秒数だけ待ってください。同時実行数の制限の場合は、実行中のリクエストのいずれかが終わってからリトライしてください。ネットワークごとのトライアルアカウント数の制限の場合は、Retry-Afterの秒数だけ待つか、チャージしてください。有料アカウントにはこの制限はありません。
safety_unavailable数秒待ってからリトライしてください。安全性チェックはフェイルクローズで動作します。チェックを実行できないときは、チェックせずに転送するのではなく、リクエストを拒否します。
upstream_errorステータスが503の場合は、Retry-Afterの秒数だけ待ってからリトライしてください。それ以外の場合(200のボディで届いた場合を含む)は、指数バックオフでリトライしてください。
insufficient_balance, key_spend_cap_reachedチャージするか、上限を引き上げるか、上限がリセットされるまで待ってください。早めにリトライしても解決しません。
その他の4xxリクエストを修正してください。変更せずにリトライすると、同じエラーが返ります。

出力を生成しなかった失敗リクエストには、時間制限や再起動で停止したものも含めて料金はかかりません。唯一の例外はクライアント側の切断で、出力が生成されていなくても推定入力に対して課金されます。モデルが出力を生成した後に失敗または停止したリクエストは、推定入力と、終了までに生成された出力に対して課金されます。リクエストの課金方法を参照してください。

長時間のリクエスト

非ストリーミングのレスポンスは1つのJSONオブジェクトで、モデルの処理が終わった時点で完成します。リクエストの到着から90秒以内に完成すれば、通常どおり送信されます。結果またはエラーが、それぞれのステータスとヘッダーとともに返されます。

90秒経っても完成しないレスポンスは、接続を維持するためにその時点で送信が始まります。ステータス200とContent-Type: application/jsonが(x-request-idとともに)送られ、ボディは改行(\n)で始まり、以後15秒ごとに改行が追加されます。結果が完成するとJSONオブジェクトが続き、レスポンスが終わります。JSONパーサーは値の前の空白を読み飛ばすため、OpenAI SDKとAnthropic SDK、JSON.parse、json.loads、response.json()はそのまま読み取れます。これにより、非ストリーミングリクエストでも10分の時間制限をフルに使えます。

ステータスが200になった後は、エラーが発生してもステータスは変わりません。それ以降のエラー(10分の時間制限、モデルからの出力が2分間ないこと、バックエンドの障害、再起動)は、通常のエラーオブジェクトとして200のボディで届きます。形式はOpenAI形式、/v1/messagesではAnthropic形式です。この場合、Retry-Afterヘッダーは送信できません。ステータスだけを確認するクライアントではエラーに気づけないため、ボディにトップレベルのerrorメンバーがあるかを確認してください。課金はほかの失敗または停止したリクエストと同じで(上記を参照)、待機中に接続を閉じるとクライアント側の切断として扱われます。

長い生成には、引き続き"stream": trueによるストリーミングが適しています。最初のトークンを早く受け取れ、出力を生成されるそばから確認できます。ただし、タイムアウトを避けるために必須というわけではありません。