Nano Banana Pro API 定价与成本估算指南

即使是看起来价格低廉的图像模型，如果误读了其计费单位，也可能产生令人惊讶的账单。TokenLab 上的 Nano Banana Pro API 定价就是一个很好的例子。nano-banana-pro 列出的是单张图像的价格，而其 Gemini 系列的邻居 gemini-3-pro-image 和 gemini-3.1-flash-image 列出的则是按 token 计费。本指南将这些条目进行对比，通过批量估算进行演示，并展示您实际会发送的两种请求格式。它还解释了如何确认最终费用。所有数据均来自 TokenLab 的实时模型 API 和文档，观察日期为 2026 年 10 月 3 日。

关键要点

• nano-banana-pro 列出的基础价格为每张图像 0.067 美元，其价格条目中列出的范围为 0.067 到 0.12 美元（实时模型 API，观察日期 2026 年 10 月 3 日）。
• nano-banana-2 列出的价格为每张 0.0335 美元，nano-banana-2-lite 为 0.0168 美元，因此 Pro 的基础价格大约是前者的两倍，是后者的四倍。
• gemini-3-pro-image 和 gemini-3.1-flash-image 是按 token 计费的，因此单张图像的预算公式不适用于它们。
• Nano Banana 参考图像（reference-image）请求应发送至 /v1/images/generations 并设置 operation: "image-to-image"，而不是发送至 /v1/images/edits。
• 最终费用记录在 Usage（使用量）和 billing_transaction_id 中，而不是您的估算中。
• 本指南不包含任何基准测试数据，因此不声称 Pro 的输出效果优于更便宜的 ID。

Nano Banana Pro API 定价概览

我们阅读了五个图像模型的目录条目，并将它们整理在下表中。nano-banana-pro 的价格区块显示“有额外的价格条目”，我们在证据中没有找到按分辨率细分的明细。因此，下表仅显示已列出的内容。

模型 ID	计费单位	已列出的价格条目 (USD)	来源	观察日期
nano-banana-pro	per_image	基础 per_request 0.067；范围摘要 0.067 至 0.12；文本输出条目 native-gemini-text-output-20260723 (per_token)：输入 1，输出 6	实时模型 API	2026-10-03 (定价更新于 2026-10-02T16:53:30.068Z)
nano-banana-2	per_image	基础 per_request 0.0335；范围 0.0225 至 0.0755；文本输出条目 (per_token)：输入 0.25，输出 1.5	实时模型 API	2026-10-03
nano-banana-2-lite	per_image	基础 per_request 0.0168；单一范围值 0.0168；条目 google-1k (1k，文本转图像和图像转图像)：0.0168	实时模型 API	2026-10-03
gemini-3-pro-image	per_token	文本输出每 1M 输入 1，输出 6；图像输出条目：60	实时模型 API	2026-10-03
gemini-3.1-flash-image	per_token	文本输出每 1M 输入 0.25，输出 1.5；图像输出条目：30	实时模型 API	2026-10-03

表中有两个细节很容易被忽略。

• 目录称 nano-banana-pro 图像输出“保留现有的每张图像分辨率层级”。它没有说明哪个层级对应 0.067，哪个对应 0.12。在确定预算之前，请阅读 GET /v1/models/nano-banana-pro/pricing 以获取该映射，正如计费指南所建议的那样。
• nano-banana-pro 上的文本输出条目是按 token 计费的。请将其视为与单张图像费用分开的独立项目，并检查您的请求是否会产生文本输出。

计费文档还警告不要硬编码复制的价格表。我们的表格是一个过时的快照，您的代码应该在需要时读取价格。

进行批量估算

假设一个团队在一次运行中生成 200 张产品图像。我们将列出的价格相乘以查看差异。这些只是估算值，而非报价。

模型	计算方式	估算值 (USD)
nano-banana-pro，基础价格	200 × 0.067	13.40
nano-banana-pro，列出范围上限	200 × 0.12	24.00
nano-banana-2，基础价格	200 × 0.0335	6.70
nano-banana-2，列出范围上限	200 × 0.0755	15.10
nano-banana-2-lite	200 × 0.0168	3.36

现在加上重新生成的情况。如果团队拒绝了 20% 的结果并使用 nano-banana-pro 以基础价格重新生成，那就是 40 张额外的图像。总数变为 240 × 0.067 = 16.08，这同样是一个估算值。异步文档称失败的任务不会被收费，但对失败生成的重试会创建一个新任务，并可能产生新的费用。重试成功的任务将像任何其他已完成的图像一样计费。

13.40 到 24.00 之间的差额是真正的不确定性所在。它源于我们仅凭证据无法映射到分辨率的价格条目。请在您的目标分辨率下运行一个小规模测试批次，然后将 Usage 记录与上述算术结果进行比较。

何时选择 nano-banana-pro 而非更便宜的 ID

文档中记载的区别可能比您预期的要少。以下是文档和目录支持的内容。

• 选择器。 nano-banana-pro 和 nano-banana-2 都支持 aspect_ratio 和 resolution（1k、2k、4k），适用于文本转图像和图像转图像。对于 nano-banana-2-lite，我们发现的唯一价格条目是在 1k，且其接受的请求格式在目录中显示为“未列出”。如果您需要 2k 或 4k 输出，我们没有找到 Lite 支持该功能的文档记录。
• 交付。 nano-banana-pro 列出 TokenLab Verified 和 Official 交付方式均可用于这两种操作。gemini-3-pro-image 仅列出 Verified。
• 价格。 Pro 的基础价格为 0.067，而其他为 0.0335 和 0.0168。目录中没有给出除此以外的差距原因。
• 生命周期。 所有这三个模型都显示为活跃生命周期阶段，没有替代模型，也没有弃用日期。原始文章称 nano-banana 和 nano-banana-edit 已弃用，但我们没有发现相关证据，因此我们删除了该说法。在依赖任何 ID 之前，请检查模型页面。

我们未进行基准测试的内容比上述列表更重要。我们没有任何这些模型的图像质量、提示词遵循度、文本渲染或延迟数据。因此，我们不能说 Pro 看起来比 nano-banana-2 更好。一个稳妥的方法是使用 20 个相同的提示词在每个候选模型上进行渲染，并目测比较输出结果。然后比较 Usage 中每张已接受图像的成本。这也是计费文档建议的方法：最低列出价格并不总是意味着最低的单项任务成本。

一个生成请求和一个编辑请求

下面的两个调用都使用 POST /v1/images/generations。图像生成指南称 Nano Banana 风格的参考生成不属于 /v1/images/edits。请务必显式发送 model，因为图像 API 没有默认值。

文本转图像，使用 Create Image 参考中为 Google 图像系列列出的字段：

curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A cinematic portrait of a white cat sitting on a rainy windowsill",
    "aspect_ratio": "16:9",
    "resolution": "2k"
  }'

编辑，即使用 operation: "image-to-image" 和 image_urls 的参考图像生成：

curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "operation": "image-to-image",
    "prompt": "Keep the product shape, change the background to a bright studio setup",
    "image_urls": ["https://example.com/input/product.png"],
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }'

来自文档的一些规则，观察日期 2026 年 10 月 3 日：

• 参考 URL 必须是公开的 http 或 https。避免使用私有网络 URL、嵌入式凭据、片段以及可能在处理开始前过期的签名 URL。
• 对于私有或受标头保护的源图像，请发送 multipart image 文件，而不是 image_urls。
• 此端点不接受 images[] 和 file_id。
• 将 HTTP 客户端超时设置为至少 120 秒。如果响应包含 status: "pending"、task_id 或 poll_url，请跟随 poll_url 而不是等待。
• 使用 GET /v1/tasks/{id} 进行轮询。异步作业指南建议每 5 到 10 秒检查一次，并在状态为 completed 或 failed 时停止。

保存返回的 URL、任务 ID、模型和您自己的作业 ID。符合条件的返回 URL 可能会作为媒体副本保留 30 天，media_retention.items 会显示每个项目的状态和 expires_at。

确认最终费用

估算只是一个计划。计费文档描述了真实数字出现的位置。

1. 预留与释放。 一些异步任务会在创建时预留估算成本。已完成的任务会被计费一次。失败的任务会释放或退还预留金额。
2. 读取交易 ID。 非流式响应在计费完成后发送响应时会包含 billing_transaction_id。相同的值可能会出现在 X-Billing-Transaction-ID 标头中。异步任务在完成后会包含该 ID。
3. 打开 Usage。 Usage 页面按模型显示历史记录和成本明细。将其与您的估算进行比较。
4. 将 ID 放在一起。 将 request_id、task_id、billing_transaction_id 和您自己的作业 ID 存储在一条记录中。
5. 凭据升级。 如果任务完成后 Usage 中没有显示最终费用或释放金额，请发送电子邮件至 support@tokenlab.sh，并附上 Request ID 和 task ID。

交付选项也会影响价格。Verified 使用 TokenLab 公开价格，Official 使用基于制造商公开价格的价格层级，Auto 则优先尝试 Verified。您需要为完成请求的选项付费，因此请注意哪个选项服务了您的测试批次。

常见问题解答

nano-banana-pro 是按图像还是按 token 计费？

基础条目是按图像：per_request 0.067，单位为 per_image。目录还列出了一个按 token 计费的文本输出条目，输入为 1，输出为 6。请检查定价端点以查看您的请求类型触发了哪个条目。

我可以将 nano-banana-pro 编辑请求发送到 /v1/images/edits 吗？

不可以。文档称 Nano Banana 参考图像请求（包括 nano-banana-pro）属于 /v1/images/generations，并需设置 operation: "image-to-image" 和 image_urls。edits 端点是为 gpt-image-2 等模型记录的。

失败的图像任务会被收费吗？

计费指南称失败的任务不会被收费，任何预留金额都会被释放或退还。重试会创建一个新任务，并可能产生新的费用。请通过您自己的作业 ID 进行去重，以免超时触发第二次创建请求。

我选择的分辨率会改变 nano-banana-pro 的价格吗？

目录称图像输出保留每张图像的分辨率层级，其列出的范围从 0.067 到 0.12。证据中没有将层级映射到 1k、2k 或 4k。请阅读 GET /v1/models/nano-banana-pro/pricing 并通过 Usage 中的测试请求进行确认。

哪个字段证明了我实际被收取的费用？

使用 billing_transaction_id 或 X-Billing-Transaction-ID 标头，并将其与 Usage 中的记录匹配。流式传输可能在计费完成前结束，因此当标头缺失时，Usage 是备选方案。

要将这些 ID 与其他图像模型在您自己的提示词上进行比较，请从 Models 目录开始。