> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 画像APIの課金と失敗時の扱い：画像なし・タイムアウト・429

> Nano Banana、GPT Image、Grok Imagineのリクエストが課金される条件を、エラー、モデレーション、HTTP 200で画像なし、タイムアウト、リトライ、同時実行の場合ごとに説明します。

LaoZhang APIは、画像モデルを1回または返された画像1枚ごとに課金します。課金の有無は、HTTPステータスだけでなく、生成まで進んだかと上流の返答で決まります。3系統のルールを1つの表にまとめました（最終確認日は**2026年10月10日**）。

| 項目 | 内容 |
| - | - |
| 課金単位 | Nano Bananaは1回ごと。GPT Imageの公式APIフォワーディングはトークン課金、`-vip` とWebのモデルは1回ごと。Grok Imagineは正常に返された画像1枚ごと |
| プラットフォームの同時実行数の上限 | アカウントにもトークンにも上限はありません。`429` は上流の処理能力か残高が原因です。[同時リクエストと429](https://docs.laozhang.ai/ja/faq/api-concurrency.md)を参照 |
| リクエストごとの課金額 | コンソールの[呼び出しログ](https://docs.laozhang.ai/en/faq/call-logs.md)に、リクエストごとのモデル、ステータス、使用量、金額が記録されます |
| 元になるルール | [Nano Bananaの課金](https://docs.laozhang.ai/ja/api-capabilities/nano-banana-image.md)、[GPT Image 2.5](https://docs.laozhang.ai/ja/api-capabilities/gpt-image-2-5.md)、[Grok Imagine](https://docs.laozhang.ai/ja/api-capabilities/grok-imagine-image.md) |

## リクエストの結果ごとの課金

| リクエストの結果 | Nano Banana | GPT Image 公式APIフォワーディング | GPT Image VIP / Web | Grok Imagine |
| - | - | - | - | - |
| パラメーターの誤り（400） | 生成まで進まないため課金なし | 課金なし | 課金なし | 画像の課金なし |
| 認証の失敗（401） | 課金なし | 課金なし | 課金なし | 画像の課金なし |
| レート制限・上流の処理能力不足（429、503） | 課金なし | 課金なし | 課金なし | 画像の課金なし |
| 上流の5xxエラー | 課金なし | 課金なし | 課金なし | 画像の課金なし |
| モデレーションによるブロック | GoogleがHTTP 200でテキストの拒否メッセージを返し、画像なし。**1回分を課金** | エラーが返り、課金なし | エラーが返り、課金なし | エラーが返り、画像の課金なし |
| 画像なしのHTTP 200 | **1回分を課金** | 画像が返されたときだけトークンを課金 | 画像が返されたときだけ1回分を課金 | 返された画像ごとの課金のため、0枚なら0 |
| クライアントのタイムアウト・切断 | サーバー側で処理が完了し、課金される場合があります | 同左 | 同左 | 同左 |
| 画像が返ったが保存しなかった | 課金される | 課金される | 課金される | 課金される。返されるURLは一時的です |
| 1回のリクエストで複数枚 | 非対応。1回につき画像1枚 | 実際のトークン数 | 1回ごと | `n` は1〜10、返された画像ごとに課金 |

3系統共通のルールとして、上流が200以外を返したリクエストは課金されません。判断の基準は呼び出しログです。呼び出しログに記録がないリクエストは、課金されていません。

3系統のうち、「画像なし」で課金されるのはNano BananaのHTTP 200だけです。Googleはモデレーションでブロックしたとき、エラーコードではなく短い拒否メッセージを返すため、LaoZhang APIは上流のHTTP 200を1回の呼び出しとして数えます。よくある原因と回避方法は、[Nano Banana](https://docs.laozhang.ai/ja/api-capabilities/nano-banana-image.md)のガイドの課金の節を参照してください。

## タイムアウトとリトライ

クライアントのタイムアウトは失敗とは限りません。サーバー側で画像がすでに生成され、課金されている場合があります。バッチ処理では、次の順番で扱ってください。

1. すべてのリクエストについて、送信時刻、モデルID、パラメーター、レスポンスを記録します。
2. タイムアウトまたは切断が起きたら、[呼び出しログ](https://api.laozhang.ai/log)で時刻とモデルからそのリクエストを探し、ステータスと課金額を確認します。
3. 呼び出しログが成功を示していれば、再送しないでください。返された画像を使うか、サポートに取得を依頼します。
4. `429` と `5xx` は、指数バックオフでリトライします。リトライは新しいリクエストで、成功すればそれぞれ別に課金されます。
5. Nano Bananaで画像なしのHTTP 200が返った場合、同じ内容のまま再送しないでください。先にプロンプトか参照画像を変更します。同じ内容はたいていまたブロックされ、毎回課金されます。
6. クライアントのタイムアウトは、[リクエストのタイムアウト](https://docs.laozhang.ai/ja/faq/request-timeout.md)の推奨に従い、画像リクエストは360秒、4Kまたは参照画像が多い場合は600秒にします。モデルのガイドに独自のタイムアウトの案内がある場合は、そちらを優先してください。

## 同時実行数とレート制限

LaoZhang APIは、アカウントごとにもトークンごとにも同時実行数を制限しません。トークンを分けてもその上限は上がりません。負荷がかかって `429` が返ったときは、次のように判断します。

* エラーのボディに `insufficient_user_quota` が含まれる場合は残高が不足しているため、先にチャージします。
* それ以外の `429` は、上流モデルのレート制限または処理能力の制限が原因です。ローカルのキューで同時実行数を半分に減らし、少しずつ戻してください。
* `503` が続く場合は、パラメーターの誤りではなく、上流の処理能力が足りていません。待ってからリトライしてください。

キューとセマフォの例は、[同時リクエストと429](https://docs.laozhang.ai/ja/faq/api-concurrency.md)にあります。

## 課金内容の問い合わせ

サポートには、次の内容を送ってください。APIキー全体は送らないでください。

* アカウントのメールアドレス
* リクエストの時刻、モデルID、呼び出しログにあるリクエスト識別子
* レスポンスのステータスと、伏せ字にしたエラー内容
* ご希望の対応

連絡先は [hi@laozhang.ai](mailto:hi@laozhang.ai) またはTelegramの [@laozhang\_cn](https://t.me/laozhang_cn) です。返金と残高の調整は、[利用規約](https://www.laozhang.ai/terms)の第6条に従います。

## よくある質問

### 失敗したリクエストは必ず無料ですか？

上流が200以外を返したリクエストは課金されません。パラメーターの誤り、認証の失敗、レート制限、上流の5xxエラーが該当します。例外は、Nano Bananaのモデレーションによるブロックです。Googleがエラーコードではなく HTTP 200 を返すため、1回分が課金されます。

### バッチで二重課金を避けるには？

目標とする画像ごとにジョブIDを付け、タイムアウトの後は呼び出しログを確認して、元のリクエストが成功していなかった場合にだけリトライしてください。クライアントのタイムアウトで自動的に再送する実装は避けましょう。Grok Imagineは1回のリクエストで最大10枚を返し、返された画像ごとに課金します。

### 1回の課金額はどこで見られますか？

呼び出しログに、リクエストごとのモデル、グループ、ステータス、使用量、金額が記録されます。各フィールドは[呼び出しログの見方](https://docs.laozhang.ai/en/faq/call-logs.md)で説明しています。

* 回数課金のモデル：固定額が表示されます。
* GPT Imageの公式APIフォワーディング：入力・出力のトークン数と換算後の金額が表示されます。
* Nano Banana：Google検索によるグラウンディングが有効な場合、検索回数と費用が表示されます。

## 関連ドキュメント

* [Nano Banana APIの概要](https://docs.laozhang.ai/ja/api-capabilities/nano-banana-image.md)：5モデルの料金と課金ルール
* [GPT Image 2.5 API](https://docs.laozhang.ai/ja/api-capabilities/gpt-image-2-5.md)：公式APIフォワーディング、VIP、Webの各ルートの課金
* [Grok Imagine API](https://docs.laozhang.ai/ja/api-capabilities/grok-imagine-image.md)：画像1枚ごとの課金とエラー処理
* [画像生成APIの比較](https://docs.laozhang.ai/ja/api-capabilities/image-generation-guide.md)：3系統のモデルを並べて比較
* [リクエストのタイムアウト](https://docs.laozhang.ai/ja/faq/request-timeout.md)：タイムアウトとレート制限の見分け方


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.