エラーと制限
すべての失敗は1つのエンベロープを使用します。コードは安定しており、メッセージはユーザーに表示できる英語のフォールバックです。
{
"error": {
"code": "insufficient_credits",
"message": "You need more credits to generate."
}
}ステータス
| HTTP | 典型的なコード | 何をすべきか |
|---|---|---|
| 400 | invalid_request, prompt_too_long, invalid_reference_image | リクエストを修正してください。変更せずに再試行しないでください |
| 401 | unauthorized | キーを確認してください。ループで再試行しないでください |
| 402 | insufficient_credits | クレジットをチャージする。再試行しない |
| 403 | unauthorized | 未払いのキー作成、またはプレミアムなしでリクエストされた音声 |
| 404 | not_found | 不明なジョブ、またはこのアカウントのものではありません |
| 409 | invalid_request | Idempotency-Key が競合しています。新しいキーを使用してください |
| 413 / 415 | invalid_request / unsupported_image_type | より小さいJPEG、PNG、またはWebPをアップロードしてください |
| 429 | rate_limited | Retry-After を待ってください |
| 500 / 503 | internal | バックオフして再試行 |
400
- 典型的なコード
invalid_request,prompt_too_long,invalid_reference_image- 何をすべきか
- リクエストを修正してください。変更せずに再試行しないでください
401
- 典型的なコード
unauthorized- 何をすべきか
- キーを確認してください。ループで再試行しないでください
402
- 典型的なコード
insufficient_credits- 何をすべきか
- クレジットをチャージする。再試行しない
403
- 典型的なコード
unauthorized- 何をすべきか
- 未払いのキー作成、またはプレミアムなしでリクエストされた音声
404
- 典型的なコード
not_found- 何をすべきか
- 不明なジョブ、またはこのアカウントのものではありません
409
- 典型的なコード
invalid_request- 何をすべきか
Idempotency-Keyが競合しています。新しいキーを使用してください
413 / 415
- 典型的なコード
invalid_request/unsupported_image_type- 何をすべきか
- より小さいJPEG、PNG、またはWebPをアップロードしてください
429
- 典型的なコード
rate_limited- 何をすべきか
Retry-Afterを待ってください
500 / 503
- 典型的なコード
internal- 何をすべきか
- バックオフして再試行
失敗した生成は、status: "failed" とコード internal の error オブジェクトを含む 200 のジョブレスポンスです。完了したジョブは終端です。再送信しないでください。
リトライポリシー
- HTTP
429、timeout、internalの応答のみを再試行します。 insufficient_creditsを再試行しないでください。また、すでにfailedで終了したジョブを再送信しないでください。- 作成時に
Idempotency-Keyを使用して、リトライで二重に課金されないようにします。 - 指数関数的にバックオフし、ジッターを加え、約1秒から開始する。
レート制限
制限はキーごと、特記なき限り固定の1分間ウィンドウです。デフォルト:
- 全体で毎分60リクエスト。
- 1分あたり10世代を生成。
- 1分間に5回のアップロード。
- 120
GET /v1/modelsリクエスト/分 クライアントIPごと(このルートは公開です)。 - アカウントあたり1時間に5回のAPIキー作成。
429 には X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset、Retry-After が含まれます。
可用性
/v1 が一時的に利用できない場合、すべてのルートはコード internal とともに 503 を返します。時間をおいてバックオフしながら再試行してください。