按请求结果对照
表中”不扣费”以各模型页的说明为准:Nano Banana 页写明”通常不扣费”,GPT Image 页写明”一般不扣费”。扣费以调用日志为准,调用日志里没有记录的请求没有产生费用。
Nano Banana 的 HTTP 200 无图是三个家族里唯一会扣费的”无图”情况:Google 对审核拦截不返回错误码,而是返回一段拒绝说明,老张API按上游返回 HTTP 200 计一次调用。常见触发原因和避免方法见避免没有图片的扣费。
超时与重试
客户端超时不等于失败:图片可能已经在服务端生成并扣费。批量调用时按下面的顺序处理:- 为每次请求记录提交时间、模型 ID、参数和响应。
- 超时或断开后,先在调用日志按时间和模型找到这次请求,确认状态和扣费。
- 调用日志显示成功时,不要重新提交;用响应里的图片或联系支持取回结果。
429和5xx用指数退避重试,每次重试都是新的请求,成功后各自计费。- Nano Banana 的 HTTP 200 无图不要原样重试,先改提示词或参考图;同样的内容重试通常仍被拦截,每次都扣费。
- 高分辨率和高质量档位耗时更长,客户端超时至少留到 120–180 秒。
并发与限流
老张API不限制账户或令牌的并发数,拆分令牌不会提高上限。高峰时收到429 时:
- 错误正文含
insufficient_user_quota是余额不足,先充值; - 其他
429来自上游模型的速率或容量限制,用本地队列把并发降到一半再逐步调高; - 持续
503说明上游容量不足,不是参数错误,等待后重试。
扣费有疑问时怎么办
向支持团队提供以下信息,不要发送完整 API Key:- 账户邮箱;
- 请求时间、模型 ID 和调用日志中的请求标识;
- 响应状态和脱敏后的错误信息;
- 期望的处理方式。
常见问题
请求失败一定不扣费吗?
返回错误、没有进入生成的请求不扣费,包括参数错误、鉴权失败、限流和上游 5xx。例外是 Nano Banana 的审核拦截:Google 返回 HTTP 200 而不是错误码,这类请求扣一次。批量任务怎样避免重复扣费?
给每张目标图片一个任务编号,超时后先查调用日志,确认原请求没有成功再重试;不要让客户端超时自动触发重新提交。Grok Imagine 一次请求可以返回最多 10 张,按返回张数计费。调用日志里怎么看一次请求扣了多少?
调用日志按请求记录模型、分组、状态、用量和金额。按次模型显示固定金额,GPT Image 官转显示输入、输出 token 和折算金额,Nano Banana 开启搜索接地时另显示检索次数和费用。字段说明见如何查看调用日志。相关文档
- Nano Banana API 总览:五个模型的单价和计费规则
- GPT Image 2.5 API:官转、VIP 与网页版三条线路的计费
- Grok Imagine Image API:按张计费与错误处理
- 图像生成 API 选型与价格:三个家族的价格与能力对照
- 请求超时怎么办:区分超时与限流