> ## 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 扣费与失败规则：Nano Banana、GPT Image、Grok Imagine

> 对照老张API三个图像模型家族在参数错误、限流、审核拦截、HTTP 200 无图、超时和多张输出时是否扣费，以及重试、对账和并发的规则。

老张API的图像模型按次或按成功输出的图片张数计费，是否扣费取决于请求有没有进入生成、上游返回了什么，而不是 HTTP 状态码本身。本页把 Nano Banana、GPT Image 和 Grok Imagine 的规则放在一张表里，最后核对日期为 **2026 年 10 月 10 日**。

| 项目 | 内容 |
| - | - |
| 计费单位 | Nano Banana 按次；GPT Image 官转按 token，`-vip` 与网页版按次；Grok Imagine 按成功输出的图片张数 |
| 平台并发限制 | 不限制账户或令牌并发，`429` 来自上游容量或余额，见[并发与 429](/faq/api-concurrency) |
| 每次扣费查询 | 控制台[调用日志](/faq/call-logs)按请求记录模型、状态、用量和金额 |
| 规则出处 | [Nano Banana 计费规则](/api-capabilities/nano-banana-image#计费规则)、[GPT Image 2.5](/api-capabilities/gpt-image-2-5#常见问题)、[Grok Imagine](/api-capabilities/grok-imagine-image#价格与计费) |

## 按请求结果对照

| 请求结果 | Nano Banana | GPT Image 官转 | GPT Image VIP / 网页版 | Grok Imagine |
| - | - | - | - | - |
| 参数错误（400） | 未进入生成，不扣费 | 不扣费 | 不扣费 | 不按张计费 |
| 鉴权失败（401） | 不扣费 | 不扣费 | 不扣费 | 不按张计费 |
| 限流或上游容量不足（429、503） | 通常不扣费 | 不扣费 | 不扣费 | 不按张计费 |
| 上游 5xx 错误 | 通常不扣费 | 不扣费 | 不扣费 | 不按张计费 |
| 内容审核拦截 | Google 返回 HTTP 200 和拒绝文字，不返回图片，**扣一次** | 返回错误，不扣费 | 返回错误，不扣费 | 返回错误，不按张计费 |
| HTTP 200 但没有图片 | **扣一次** | 返回图片后才按 token 扣费 | 返回图片后才按次扣费 | 按返回的张数计费，0 张即 0 |
| 客户端超时或断开 | 服务端可能已完成并扣费 | 同左 | 同左 | 同左 |
| 图片已返回但未保存 | 已扣费 | 已扣费 | 已扣费 | 已扣费，返回的 URL 是临时地址 |
| 一次请求多张 | 不支持按数量出图，每次一张 | 按实际 token | 按次 | `n` 为 1–10，按返回张数计费 |

表中"不扣费"以各模型页的说明为准：Nano Banana 页写明"通常不扣费"，GPT Image 页写明"一般不扣费"。扣费以调用日志为准，调用日志里没有记录的请求没有产生费用。

Nano Banana 的 HTTP 200 无图是三个家族里唯一会扣费的"无图"情况：Google 对审核拦截不返回错误码，而是返回一段拒绝说明，老张API按上游返回 HTTP 200 计一次调用。常见触发原因和避免方法见[避免没有图片的扣费](/api-capabilities/nano-banana-image#避免没有图片的扣费)。

## 超时与重试

客户端超时不等于失败：图片可能已经在服务端生成并扣费。批量调用时按下面的顺序处理：

1. 为每次请求记录提交时间、模型 ID、参数和响应。
2. 超时或断开后，先在[调用日志](https://api.laozhang.ai/log)按时间和模型找到这次请求，确认状态和扣费。
3. 调用日志显示成功时，不要重新提交；用响应里的图片或联系支持取回结果。
4. `429` 和 `5xx` 用指数退避重试，每次重试都是新的请求，成功后各自计费。
5. Nano Banana 的 HTTP 200 无图不要原样重试，先改提示词或参考图；同样的内容重试通常仍被拦截，每次都扣费。
6. 高分辨率和高质量档位耗时更长，客户端超时至少留到 120–180 秒。

## 并发与限流

老张API不限制账户或令牌的并发数，拆分令牌不会提高上限。高峰时收到 `429` 时：

* 错误正文含 `insufficient_user_quota` 是余额不足，先充值；
* 其他 `429` 来自上游模型的速率或容量限制，用本地队列把并发降到一半再逐步调高；
* 持续 `503` 说明上游容量不足，不是参数错误，等待后重试。

队列与信号量的示例代码见[并发与 429](/faq/api-concurrency)。

## 扣费有疑问时怎么办

向支持团队提供以下信息，不要发送完整 API Key：

* 账户邮箱；
* 请求时间、模型 ID 和调用日志中的请求标识；
* 响应状态和脱敏后的错误信息；
* 期望的处理方式。

联系方式：[hi@laozhang.ai](mailto:hi@laozhang.ai) 或 Telegram [@laozhang\_cn](https://t.me/laozhang_cn)。退款与余额调整按[用户协议](https://www.laozhang.ai/zh-cn/terms)第 6 节处理。

## 常见问题

### 请求失败一定不扣费吗？

返回错误、没有进入生成的请求不扣费，包括参数错误、鉴权失败、限流和上游 5xx。例外是 Nano Banana 的审核拦截：Google 返回 HTTP 200 而不是错误码，这类请求扣一次。

### 批量任务怎样避免重复扣费？

给每张目标图片一个任务编号，超时后先查调用日志，确认原请求没有成功再重试；不要让客户端超时自动触发重新提交。Grok Imagine 一次请求可以返回最多 10 张，按返回张数计费。

### 调用日志里怎么看一次请求扣了多少？

调用日志按请求记录模型、分组、状态、用量和金额。按次模型显示固定金额，GPT Image 官转显示输入、输出 token 和折算金额，Nano Banana 开启搜索接地时另显示检索次数和费用。字段说明见[如何查看调用日志](/faq/call-logs)。

## 相关文档

* [Nano Banana API 总览](/api-capabilities/nano-banana-image)：五个模型的单价和计费规则
* [GPT Image 2.5 API](/api-capabilities/gpt-image-2-5)：官转、VIP 与网页版三条线路的计费
* [Grok Imagine Image API](/api-capabilities/grok-imagine-image)：按张计费与错误处理
* [图像生成 API 选型与价格](/api-capabilities/image-generation-guide)：三个家族的价格与能力对照
* [请求超时怎么办](/faq/request-timeout)：区分超时与限流


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