ドキュメント

エラー / レートリミット

エラー

HTTPエラーは、code と message を含む error オブジェクトを返します。正常に受け付けられたタスクであっても後から失敗することがあるため、タスクのステータスを確認するか、失敗時のコールバックを適切に処理してください。

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	フィールド	対処方法
400	`invalid_request`	JSONの構文、プロンプトの有無、パラメータの範囲、またはメディアURLに問題があります。修正して再試行してください。
401	`invalid_api_key`	Bearer トークンが正しいか、およびAPIキーが有効化されているかを確認してください。
402	`insufficient_credits`	クレジットを追加するか、タスクの消費想定を減らしてください。レスポンスには、必要なクレジット数と現在の保有クレジット数が含まれる場合があります。
403	`forbidden`	エラーメッセージに記載されているアカウントレベルの制限事項を確認してください。
404	`not_found`	タスクIDが正しいか、およびそのキーがタスクの作成者と一致しているかを確認してください。
429	`rate_limited`	Retry-After ヘッダーに示された秒数が経過した後に再試行してください。
500	`internal_error`	エラーメッセージとAPIログを確認してください。注意深く再試行してください。作成リクエストを再送信すると、新たに課金対象となるタスクが作成される可能性があります。

タスクの作成：デフォルトでは、APIキー1つにつき1分あたり最大100回のリクエストが可能です。現在、カスタムレート制限の設定はご利用いただけません。

タスクの照会：デフォルトでは、APIキー1つにつき1分あたり最大120回のリクエストが可能です。照会リクエストとタスク作成リクエストは別々にカウントされます。

画像生成と動画生成のリクエストは、同一の API キーのレート制限を共有します。

HTTP 429 レスポンスの Retry-After は、タスク作成時には 60、タスク確認時には 5 が設定されます。エクスポネンシャルバックオフなどの仕組みを導入し、必要以上の頻度でポーリングを行わないようにしてください。

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}