メインコンテンツへスキップ

​
HTTP ステータスコード

Status Code説明
200リクエスト成功
400リクエストパラメータが不正
401認証失敗。API キーが無効または未指定
403権限不足。トークンが対象モデルを利用できない
429レート制限超過
500内部サーバーエラー
502上流サービスが利用不可
503サービスが一時的に利用不可

​
エラーレスポンス形式

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

​
よくあるエラー

​
401 - Authentication Failed

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}
対応: API キーが正しく、sk- で始まっているか確認してください。

​
429 - Rate Limited

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}
対応: リクエスト頻度を下げるか、必要に応じて上限引き上げを相談してください。

​
403 - Insufficient Balance

{
  "error": {
    "message": "Insufficient quota",
    "type": "insufficient_quota",
    "code": "insufficient_quota"
  }
}
対応: top-up page から残高を追加してください。

​
リトライ方針

  • 429 は指数バックオフでリトライします。
  • 500/502/503 は数秒待ってからリトライします。
  • 400/401/403 はリクエスト内容、認証情報、モデル権限を確認します。