エラー

エラーには機械可読コードとメッセージが含まれます。拒否されたリクエストと、既に提供元の処理能力を使用した可能性のある結果不明を区別してください。

エラー形式

JSONエラー

{
  "error": {
    "message": "Insufficient available credit for this request. Add credit or resolve pending reservations.",
    "type": "invalid_request_error",
    "code": "insufficient_credit"
  }
}

応答の x-request-id とアクティビティ記録で調べてください。サポート報告にシークレットキーや会話内容を含めないでください。

ステータスコード

ステータス	意味 / 対応
400	本文の不正、未定義フィールド、コンテキスト超過、非対応機能。
401	Bearerキーが未指定、無効、または失効しています。
402	利用可能クレジット不足、またはAPIキーの利用上限に達しました。
403	利用不可のアカウント、またはキーの許可リスト外のモデル。
404	未定義のエンドポイントまたは未承認モデルID。
409	この冪等性参照は既に使用されています。
413 / 415	本文が大きすぎるか、コンテンツタイプがapplication/json以外です。
429	レート・リクエスト数・同時実行数の制限です。Retry-Afterの期間を待って再試行してください。保留中の確保額には照合が必要な場合があります。
502	提供元の障害、不正なストリーム、使用量不明。
503	メンテナンス、提供元の準備状態、公開設定。

結果不明

上流のタイムアウトや usage_unavailable 応答で保留が残る場合があります。これらは X-Should-Retry: false を含み、SDKの自動再送を抑止します。エラーコードは非公開情報を返さず、モデル利用不可、無効パラメータ、認証、割当超過、レート制限を区別します。再度呼び出す前にアクティビティを調べ、最初の結果を照合してください。

冪等性

任意の Idempotency-Key は英数字、ピリオド、アンダースコア、コロン、ハイフンの1–128文字です。同じ参照は409を返し、推論を再実行しません。重複防止であり、キャッシュ応答の再送ではありません。