ガイド
エラー
Cheapest Imagen API が返すすべての HTTP ステータスとエラーコードについて、意味、課金の有無、次にすべきことを説明します。
エラーの形式は OpenAI と同じです。
{
"error": {
"message": "Not enough credits for this request.",
"type": "invalid_request_error",
"param": null,
"code": "insufficient_credits"
}
}すべてのレスポンスに x-request-id ヘッダーが付きます。サポートへのお問い合わせの際は、この値をお伝えください。
| ステータス | code | 意味 | 対処 |
|---|---|---|---|
| 400 | missing_required_parameter | 必須のフィールドがありません | param に示されたフィールドを追加してください |
| 400 | invalid_value | フィールドの値が受け付けられません | param に示されたフィールドを修正してください |
| 400 | unsupported_parameter | そのフィールドは使えないか、このモデルでは使えません(たとえば SVG 出力のないモデルでの svg) | フィールドを削除するか、対応するモデルを選んでください |
| 400 | model_not_found | モデルが存在しないか、公開されていません | GET /v1/models にあるモデルを使ってください |
| 400 | moderation_blocked | プロンプトまたは画像がコンテンツチェックで拒否されました | プロンプトを変更してください。課金されません(Nano Banana の stable チャンネル(-1k、-2k、-4k)を除く) |
| 401 | invalid_api_key | キーがないか、誤っています | Authorization ヘッダーを確認してください |
| 402 | insufficient_credits | クレジットが足りません | チャージしてください |
| 403 | account_suspended | アカウントまたはキーが無効です | サポートにご連絡ください |
| 409 | idempotency_key_in_use | その Idempotency-Key はすでに使われています | 最初のリクエストを待つか、新しいキーを使ってください |
| 413 | request_too_large | リクエストまたは画像が大きすぎます | 画像を小さくするか、枚数を減らしてください |
| 429 | rate_limit_exceeded | 1 分間に 300 を超えるリクエストがありました | 間隔をあけて再試行してください |
| 429 | concurrency_limit_exceeded | 同時に 50 を超えるリクエストがありました | 1 件が終わるのを待ってください |
| 429 | moderation_paused | 1 時間に 10 回を超えてリクエストが拒否されました | 1 時間待ってください |
| 502 | upstream_error | 画像を生成できませんでした | 再試行してください。課金されません |
| 504 | upstream_timeout | 生成に 420 秒を超える時間がかかりました | 再試行してください。課金されません |
課金されるとき
受け取った画像の分だけです。失敗、タイムアウト、拒否されたリクエストに料金はかかりません。例外は Nano Banana の stable チャンネル(-1k、-2k、-4k)で、提供元が課金するため、コンテンツを理由に拒否された画像にも課金されます。