リクエストの結果ごとの課金
3系統共通のルールとして、上流が200以外を返したリクエストは課金されません。判断の基準は呼び出しログです。呼び出しログに記録がないリクエストは、課金されていません。
3系統のうち、「画像なし」で課金されるのはNano BananaのHTTP 200だけです。Googleはモデレーションでブロックしたとき、エラーコードではなく短い拒否メッセージを返すため、LaoZhang APIは上流のHTTP 200を1回の呼び出しとして数えます。よくある原因と回避方法は、Nano Bananaのガイドの課金の節を参照してください。
タイムアウトとリトライ
クライアントのタイムアウトは失敗とは限りません。サーバー側で画像がすでに生成され、課金されている場合があります。バッチ処理では、次の順番で扱ってください。- すべてのリクエストについて、送信時刻、モデルID、パラメーター、レスポンスを記録します。
- タイムアウトまたは切断が起きたら、呼び出しログで時刻とモデルからそのリクエストを探し、ステータスと課金額を確認します。
- 呼び出しログが成功を示していれば、再送しないでください。返された画像を使うか、サポートに取得を依頼します。
429と5xxは、指数バックオフでリトライします。リトライは新しいリクエストで、成功すればそれぞれ別に課金されます。- Nano Bananaで画像なしのHTTP 200が返った場合、同じ内容のまま再送しないでください。先にプロンプトか参照画像を変更します。同じ内容はたいていまたブロックされ、毎回課金されます。
- クライアントのタイムアウトは、リクエストのタイムアウトの推奨に従い、画像リクエストは360秒、4Kまたは参照画像が多い場合は600秒にします。モデルのガイドに独自のタイムアウトの案内がある場合は、そちらを優先してください。
同時実行数とレート制限
LaoZhang APIは、アカウントごとにもトークンごとにも同時実行数を制限しません。トークンを分けてもその上限は上がりません。負荷がかかって429 が返ったときは、次のように判断します。
- エラーのボディに
insufficient_user_quotaが含まれる場合は残高が不足しているため、先にチャージします。 - それ以外の
429は、上流モデルのレート制限または処理能力の制限が原因です。ローカルのキューで同時実行数を半分に減らし、少しずつ戻してください。 503が続く場合は、パラメーターの誤りではなく、上流の処理能力が足りていません。待ってからリトライしてください。
課金内容の問い合わせ
サポートには、次の内容を送ってください。APIキー全体は送らないでください。- アカウントのメールアドレス
- リクエストの時刻、モデルID、呼び出しログにあるリクエスト識別子
- レスポンスのステータスと、伏せ字にしたエラー内容
- ご希望の対応
よくある質問
失敗したリクエストは必ず無料ですか？
上流が200以外を返したリクエストは課金されません。パラメーターの誤り、認証の失敗、レート制限、上流の5xxエラーが該当します。例外は、Nano Bananaのモデレーションによるブロックです。Googleがエラーコードではなく HTTP 200 を返すため、1回分が課金されます。バッチで二重課金を避けるには？
目標とする画像ごとにジョブIDを付け、タイムアウトの後は呼び出しログを確認して、元のリクエストが成功していなかった場合にだけリトライしてください。クライアントのタイムアウトで自動的に再送する実装は避けましょう。Grok Imagineは1回のリクエストで最大10枚を返し、返された画像ごとに課金します。1回の課金額はどこで見られますか？
呼び出しログに、リクエストごとのモデル、グループ、ステータス、使用量、金額が記録されます。各フィールドは呼び出しログの見方で説明しています。- 回数課金のモデル：固定額が表示されます。
- GPT Imageの公式APIフォワーディング：入力・出力のトークン数と換算後の金額が表示されます。
- Nano Banana：Google検索によるグラウンディングが有効な場合、検索回数と費用が表示されます。
関連ドキュメント
- Nano Banana APIの概要：5モデルの料金と課金ルール
- GPT Image 2.5 API：公式APIフォワーディング、VIP、Webの各ルートの課金
- Grok Imagine API：画像1枚ごとの課金とエラー処理
- 画像生成APIの比較：3系統のモデルを並べて比較
- リクエストのタイムアウト：タイムアウトとレート制限の見分け方