コンソール

エラーコード

プラットフォーム共通のエラーコードはこのページにまとめています。リソース固有のエラーコードは、対応するリファレンスページに記載しています。

共通エラーコード

HTTP共通エラーコード / タイプ説明
400invalid_request_errorリクエストパラメータまたはリクエスト構造が正しくありません。
400missing_required_field必須フィールドがありません。
400invalid_field_valueフィールド値が不正です。
400invalid_rangeフィールド値が許容範囲外です。
400unsupported_response_formatサポートされていない出力形式です。
400unsupported_feature_for_model現在のモデルはこの機能をサポートしていません。
400invalid_urlURLの形式が不正です。
400 / 403url_not_allowedURLがセキュリティルールにより拒否されました。
401authentication_error認証に失敗しました。フレームワークはこのステータスコードをサポートしています。
403permission_errorAPIキーがないか無効である、権限が不足している、またはセキュリティポリシーによってブロックされたことを示します。現在のゲートウェイは403を返す場合があります。
402billing_error / insufficient_credits課金に失敗したか、残高が不足しています。
429rate_limit_error / rate_limit_exceededリクエスト頻度が上限を超えました。
429concurrency_limit_exceeded同時実行数が上限を超えました。
409conflict_errorリソースが競合しています。
404not_found_errorリソースが存在しないことを示す汎用タイプです。具体的なリソースのcodeは各APIページに記載しています。
403safety_guardrail_blocked安全ポリシーによりブロックされました。
500 / 502 / 503 / 504internal / upstream / service / timeoutサーバー側エラー、上流エラー、サービス利用不可、またはタイムアウト。

エラー構造の分類

エラー構造記載ページ適用範囲
共通の同期HTTPエラー構造「リソース → エラーコード」すべてのAPIでレスポンス開始前に返される通常のJSONエラー。
SSE errorイベント単一話者の音声生成のストリーミングセクションSSEの開始後に返されるストリーム内エラー。
非同期タスクの失敗構造タスクの取得タスクの作成には成功したが、最終的にFAILEDになった場合。
生PCMの途中失敗単一話者の音声生成のストリーミングセクションJSONエラーボディはなく、接続が途中で終了します。

共通の同期HTTPエラー構造

JSON
{
  "error": {
    "message": "Error description",
    "type": "error_type",
    "param": null,
    "code": "error_code"
  }
}

共通の同期HTTPエラーは上記の構造に従います。具体的なerror.codeとパラメータは、対応するAPIの説明と実際のレスポンスに準じます。