# Nano Banana Pro API 指南：官方模型 ID、价格、限额与快速上手

> 确认 Nano Banana Pro API 对应的官方模型 ID，选择正确的 Gemini 路径，核实截至 2026 年 3 月 27 日的价格、计费与限额信息，并避开最浪费时间的接入误区。

- Source: https://www.aifreeapi.com/zh/posts/nano-banana-pro-api
- Language: zh
- Published: 2026-03-27
- Updated: 2026-03-27
- Publisher: AI Free API (https://www.aifreeapi.com)

**截至 2026 年 3 月 27 日，Nano Banana Pro API 指的就是 Google 的 `gemini-3-pro-image-preview`。** 如果你正在做新的接入，默认应该先走原生 Gemini 图像生成路线，而不是先抄第三方平台的别名，也不是默认从 Gemini 的 OpenAI 兼容层入手。只有当你已经有一套 OpenAI 形态的 SDK、客户端或调用链，并且最重要的目标是少改代码时，兼容层才是更合适的起点。

这样判断的原因并不复杂。当前这个关键词的搜索结果仍然非常碎片化。大量页面都在突出 `Nano Banana Pro API`、低价标签和几行 curl 示例，但它们通常不会先把官方模型 ID、付费层级要求，以及你的实时限额究竟在哪里查看讲清楚。Google 的答案更可靠，但被分散在 [image-generation 文档](https://ai.google.dev/gemini-api/docs/image-generation)、[OpenAI 兼容文档](https://ai.google.dev/gemini-api/docs/openai)、[pricing 页面](https://ai.google.dev/gemini-api/docs/pricing?hl=en) 和 [rate-limits 页面](https://ai.google.dev/gemini-api/docs/rate-limits) 里。

因此，使用这个关键词时最安全的顺序不是先比价，而是先把路径走对。先确认官方模型名，再选 API 入口，然后在进入生产环境前确认计费状态和实时限额。做完这三步之后，你再去比较中转平台或复制别人页面里的示例，出错概率会低很多。

![Nano Banana Pro API 指南封面，展示官方模型 ID、推荐 API 路线、当前价格和关键配置检查点](https://www.aifreeapi.com/posts/zh/nano-banana-pro-api/img/cover.png)

## 要点速览

| 你的情况 | 建议起点 | 模型 | 为什么这是更安全的默认选择 | 主要注意点 |
| --- | --- | --- | --- | --- |
| 新做 Google 官方接入 | 原生 Gemini `generateContent` | `gemini-3-pro-image-preview` | 这是 Google 当前最清晰的一方契约，和官方图像文档完全对齐 | 完整路线需要付费层级，实时限额按项目变化 |
| 已有 OpenAI 风格应用或 SDK | Gemini OpenAI 兼容端点 | `gemini-3-pro-image-preview` | 最省重写成本，便于继续沿用 OpenAI 形态客户端 | 这是兼容层，不是学习模型原生契约的最佳入口 |
| 先看成本再决定 | 先看 Google 官方价格，再比较中转平台 | `gemini-3-pro-image-preview` | 先知道官方基准价，第三方报价才有比较意义 | 很多平台页会弱化计费和限额差异 |
| 做高价值的文本海报、信息图或精细编辑 | 优先走官方路线 | `gemini-3-pro-image-preview` | 这是 Gemini 3 图像里的高阶专业路线，更适合复杂指令与高精度输出 | 比 Flash Image 路线更贵，而且目前仍带 preview 标签 |

如果你接下来更关心的是价格，可以继续看 [Nano Banana Pro API 定价](/zh/posts/nano-banana-pro-api-pricing)。如果你的重点变成 API key 获取，则更适合看 [Nano Banana Pro API Key](/zh/posts/nano-banana-pro-api-key)。如果你需要更底层的原生调用方式，可以看 [Gemini 图像生成 REST API](/zh/posts/gemini-image-generation-rest-api)。

## Nano Banana Pro API 是产品昵称，不是官方模型名

这个关键词最先要修正的，就是命名问题。`Nano Banana Pro` 是 Google 对 Gemini 3 高阶图像路线使用的产品昵称，但官方 API 模型名是 `gemini-3-pro-image-preview`。Google 目前的 [图像生成文档](https://ai.google.dev/gemini-api/docs/image-generation) 给出的映射非常明确：

- `Nano Banana 2` = `gemini-3.1-flash-image-preview`
- `Nano Banana Pro` = `gemini-3-pro-image-preview`
- `Nano Banana` = `gemini-2.5-flash-image`

这看起来只是一个命名差异，但它会影响你对第一页几乎所有结果的判断。很多第三方平台会暴露自己的模型别名，例如 `nano-banana-pro`。这个别名也许在它自己的网关里可以用，但它不是 Google 的一方标准模型字符串。如果你把这些别名直接复制到 Google 原生请求里，你其实是在错误的层上排查问题。

Google 当前的 [changelog](https://ai.google.dev/gemini-api/docs/changelog) 写明，`gemini-3-pro-image-preview` 的发布日期是 **2025 年 11 月 20 日**。这个日期重要的原因在于，许多旧页面仍然把早期命名、2.5 系列图像模型，甚至模糊的 `Gemini 3.0 Pro` 说法混在一起，导致读者以为这是同一个东西。

Google 自己对这个模型的定位也值得一起看。[DeepMind 模型页面](https://deepmind.google/models/gemini-image/pro/) 把 Nano Banana Pro 描述为强调精度与控制力的 Gemini 3 图像模型。[图像生成文档](https://ai.google.dev/gemini-api/docs/image-generation) 则说明，它面向专业资产生产和复杂指令场景，Gemini 3 图像模型最多可以混合 14 张参考图，具体的人物与物体约束因模型而异。同时，Google 还说明所有生成图像都包含 SynthID。

把这些信息合起来，正确的心智模型应该是：

- `Nano Banana Pro` 是产品层面的昵称。
- `gemini-3-pro-image-preview` 是官方 API 工作中应使用的标准模型字符串。
- 第三方页面可能会暴露自己的别名，但那只是包装层，不是 Google 的第一方名称。

一旦命名问题澄清，接下来真正重要的问题就变成了路线选择：你应该从哪条 API 路径开始？

## 应该先走哪条 API 路径？

![对比原生 Gemini 路线、OpenAI 兼容路线和中转平台接入方式的决策图](https://www.aifreeapi.com/posts/zh/nano-banana-pro-api/img/route-decision-board.png)

对大多数读者来说，答案很简单：**先走原生 Gemini API 路线。** 当你是第一次接触这个模型、使用原始 HTTP 请求、跟着官方文档学习，或者只是想先确认第一条请求能跑通时，这就是最佳默认值。

理由不是“官方信仰”，而是“排错更清晰”。Google 当前的 [image-generation 指南](https://ai.google.dev/gemini-api/docs/image-generation) 是围绕原生 Gemini `generateContent` 契约来讲图像输出的。模型映射、图像尺寸、宽高比以及当前 Gemini 3 图像路线，都是在这个表面下解释得最直接。如果你的目标是从“我搜了这个关键词”快速走到“我已经有一条正确的 Google 请求”，原生路线是最短路径。

**Gemini OpenAI 兼容路线** 当然是真实存在的，Google 也在 [OpenAI 兼容文档](https://ai.google.dev/gemini-api/docs/openai) 中正式支持它。你可以通过 `client.images.generate` 调用 `gemini-3-pro-image-preview`，这在你已经有 OpenAI 形态应用、不想大改 SDK 习惯时非常有价值。但它仍然不适合作为大多数新接入的默认入口，因为它把原生 Gemini 契约包在兼容层后面，容易让你在还没理解官方接口前就开始调试兼容差异。

更稳妥的拆分方式是：

- 当你从零开始、学习官方接口、或排查第一条成功请求时，优先走 **原生 Gemini**。
- 当你最重要的需求是保留现有 OpenAI 客户端形态时，才优先走 **Gemini OpenAI 兼容层**。
- 当你已经理解官方模型、官方价格基线和计费表面之后，再考虑 **中转平台或网关提供商**。

这一点非常关键，因为当前 SERP 上的大量页面看起来像产品本体，实际上只是某个接入渠道。如果你没先理解这层区别，就很容易把第三方网关的规则、别名和限制，当成 Google 官方 API 的行为。

## 账单、价格与真正生效的限额在哪里

![价格与限额信息图，展示官方 Nano Banana Pro API 价格、Batch 折扣、付费要求和 AI Studio 实时限额提示](https://www.aifreeapi.com/posts/zh/nano-banana-pro-api/img/pricing-limits-board.png)

路线问题和计费问题，往往比很多落地页承认得更紧密。

Google 的 [billing 页面](https://ai.google.dev/gemini-api/docs/billing/) 说明，新建的 Gemini API 账号默认从 Free Tier 开始；要切换到 Paid Tier，需要绑定 billing account，并至少预付 $10。该页面还提到从 **2026 年 3 月 23 日** 开始的临时 prepay-to-postpay 迁移状态。对实际接入来说，重点非常直接：不要把“拿到 API key”误认为“已经完成生产级接入”。即使你的模型名和请求路径都没错，如果计费状态没有按项目要求配置，图像请求仍然可能失败，或者表现和你预期的不一样。

截至 Google 当前 [pricing 页面](https://ai.google.dev/gemini-api/docs/pricing?hl=en)，官方价格基线是：

| Google 官方路线 | 当前付费价格 |
| --- | --- |
| Gemini 3 Pro Image Preview，1K 或 2K 输出 | $0.134 / 张 |
| Gemini 3 Pro Image Preview，4K 输出 | $0.24 / 张 |
| Gemini 3 Pro Image Preview，Batch API，1K 或 2K | $0.067 / 张 |
| Gemini 3 Pro Image Preview，Batch API，4K | $0.12 / 张 |

这些数字应该是你做任何比较时的第一锚点。因为搜索第一页上几乎每个提供商页面都想让你先记住它的包装价格，而不是 Google 官方基线。只有你先知道官方价格，比较第三方中转平台的报价才有意义。如果你真正想解决的问题是“有没有更便宜的调用方式”，更适合直接看 [Nano Banana Pro 低价 API](/zh/posts/nano-banana-pro-cheap-api-alternative)，而不是把所有价格路线都塞进这一页里。

限额问题是陈旧内容最容易误导人的地方。Google 的 [rate-limits 页面](https://ai.google.dev/gemini-api/docs/rate-limits) **并没有** 给出一个适用于所有用户、所有时段的统一 RPM 数字。相反，它明确说明：

- 限额按 **project** 生效
- requests per day 在 **太平洋时间午夜** 重置
- preview 模型通常有 **更严格的限制**
- 你的实时限额应当在 **AI Studio** 中查看

这就是为什么这篇文章不会重复一个固定的“通用 RPM 数字”。很多第三方页面仍在这么写，但 Google 自己的指导更强调条件化和项目级差异。对大多数开发者来说，唯一安全的默认做法，就是把 AI Studio 当成实时限额的确认入口。

## 快速上手：先发出第一条正确的 Nano Banana Pro API 请求

最稳妥的首测方式，是一条官方 Google 请求、一个正确的模型名，再加上一张成功返回的图片。第一步不要先从中转平台、批处理队列，或者复杂的第三方模型别名开始；如果你的第一目标只是验证路线，最简单的第一方请求永远更容易排错。

### 原生 Gemini 路线

```bash
curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {
          "text": "Create a clean 16:9 product hero image of a matte black travel mug on a light concrete surface with soft studio lighting and premium ecommerce styling."
        }
      ]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'
```

这条请求的价值，在于它直接证明了官方路线可用：使用 Google 官方模型字符串、当前原生 Gemini 契约，以及文档中为 Gemini 3 图像生成说明的图像配置字段。

在原生路线下，你通常会在响应体内容里拿到图片字节，而不是一个现成的托管 URL。这恰恰也是它更适合作为第一步验证的原因。你先看清真实响应结构，就能判断自己是在调试访问权限、模型选择，还是保存图片的逻辑，而不是一开始就在多个抽象层之间猜。

### Gemini OpenAI 兼容路线

如果你已经有 OpenAI 形态客户端，而且是有意选择兼容层，那么 Google 的官方文档也支持这样做：

```python
from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)

result = client.images.generate(
    model="gemini-3-pro-image-preview",
    prompt="Create a clean 16:9 product hero image of a matte black travel mug on a light concrete surface with soft studio lighting and premium ecommerce styling.",
    size="2K",
    n=1,
)
```

只有当“保留 OpenAI 风格客户端”本身就是你的目标时，才建议把这条路线当作起点，而不是因为示例看起来更短。

拿到第一条成功响应之后，你的下一步通常取决于哪里还不清楚：

- 如果卡在 **计费状态**，继续看 [Nano Banana Pro Google AI Studio Billing（英文）](/en/posts/nano-banana-pro-google-ai-studio-billing)。
- 如果卡在 **API key 获取**，继续看 [Nano Banana Pro API Key](/zh/posts/nano-banana-pro-api-key)。
- 如果你想看 **更底层的图像 REST 调用方式**，继续看 [Gemini 图像生成 REST API](/zh/posts/gemini-image-generation-rest-api)。
- 如果你更想走 **第三方聚合或国内中转**，可以看 [通过 laozhang.ai 调用 Nano Banana Pro API](/zh/posts/nano-banana-pro-api-laozhang)。

## 配置完成后最常见的失败类型

![故障排查图，展示如何判断计费问题、429 限流、503 服务错误和 IMAGE_OTHER 失败](https://www.aifreeapi.com/posts/zh/nano-banana-pro-api/img/failure-triage-map.png)

很多用户真正把这个关键词搜完以后，下一步其实不是“继续看功能介绍”，而是“为什么我已经照着配了还是报错”。这也是为什么这个部分比再堆一页特性清单更重要。

Google 的官方文档解释了计费和限额所在的位置，而真实的实现摩擦则更容易从社区讨论中看到。[Google Developers Forum 的一个帖子](https://discuss.ai.google.dev/t/gemini-3-pro-image-preview-failures-when-called-by-aws-lambda-function/111440) 记录了在 AWS Lambda 中会复现、但本地环境不复现的 `IMAGE_OTHER` 失败。[Reddit 上的一条讨论](https://www.reddit.com/r/googlecloud/comments/1pddakx/gemini_3_image_api_spamming_503_and_429_for_hours/) 则反映了用户经常把真实限流与后端容量波动混为一谈。

最实用的排查表通常是这样的：

| 你看到的现象 | 它通常意味着什么 | 第一优先检查项 |
| --- | --- | --- |
| 与计费相关的错误，或没有拿到付费能力 | 路线是对的，但项目仍处在不对的 billing 状态 | 检查 Paid Tier 是否已经配置，并确认项目绑定关系 |
| `429 Resource Exhausted` | 你打到了真实的 project 级限额，或 preview 模型更严格的配额窗口 | 先到 AI Studio 看实时限额，不要急着改代码 |
| `503 Service Unavailable` | 通常更像服务侧容量问题，而不是模型名写错 | 先重试、降压，再判断是不是端点错误 |
| `IMAGE_OTHER` 或图像生成失败，但模型 ID 正确 | 模型接受了请求结构，但在当前条件下无法完成生成 | 先简化 prompt，对比不同运行环境，再隔离运行时差异 |
| 原生路线正常，兼容路线却异常 | 你把两个不同的接口契约当成了一个来调试 | 先在一个表面上完全调通，再比较差异 |

最重要的习惯，是一层一层地排查。先证明官方模型 ID 没错，再证明计费没错，再证明原生路线没错，最后如果你确实需要兼容层或中转平台，再去比较那些额外的抽象层。这个顺序比任何“高级优化技巧”都更省时间。

## 什么时候才应该使用中转平台或提供商页面？

把官方路线理顺之后，中转平台当然可能是合理选择。它们不是天然错误的，SERP 上之所以充满这些页面，也是因为它们确实解决了一些现实需求。常见场景通常有四种：

- 你想用一个 OpenAI 风格网关统一接多个图像模型
- 你想把跨厂商的账单统一到一个平台里
- 你需要某个提供商更适合自己流量形态的价格方案
- 你需要比直接走 Google billing 更快的商业接入路径

但这些页面**不应该替代**你对官方基线的理解。如果某个平台用的是 `nano-banana-pro` 这种自己的别名，或者只强调自己的 credit 成本，你仍然应该知道它背后的官方模型是什么、Google 官方价格是多少，以及底层实时限额到底来自哪里。

这也是为什么这篇页始终保持“官方优先”的写法。你当然可以在这之后去比较第三方路线，但如果在不了解 Google 官方表面的前提下就直接从中转平台开始，你实际比较的往往不是产品本身，而是别人包装过的接入层。

如果你下一步真正要解决的是“更便宜”或“更省事”的接入路径，可以继续看：

- [Nano Banana Pro 低价 API](/zh/posts/nano-banana-pro-cheap-api-alternative)
- [How to Call Nano Banana Pro via API（英文）](/en/posts/how-to-call-nano-banana-pro-via-api)
- [Nano Banana Pro API 定价](/zh/posts/nano-banana-pro-api-pricing)

## FAQ

**Nano Banana Pro API 的官方 Google 模型名到底是什么？**

官方模型字符串是 `gemini-3-pro-image-preview`。`Nano Banana Pro` 是产品昵称，不是官方 API 模型名。

**我一定要使用原生 Gemini API 吗？可以直接走 OpenAI 兼容客户端吗？**

两者都可以。对于新的接入项目，原生 Gemini 路线是更稳妥的默认选择；当你最重要的目标是保留现有 OpenAI 形态客户端时，Gemini 的 OpenAI 兼容路线更合适。

**我应该去哪里看自己真正生效的实时限额？**

Google 当前的限额文档说明，活跃限额应当在 AI Studio 中查看。公开文档解释了规则，但你项目当下真正生效的限制，应该以 AI Studio 为准。

**要认真使用 Nano Banana Pro API，是否必须先配置 billing？**

是的。Google 的 billing 文档说明，切换到 Paid Tier 需要绑定 billing account，并至少预付 $10。不要把“拿到 API key”误认为“已经具备生产可用权限”。

**生成出来的图片会带 SynthID 吗？**

会。Google 的图像生成文档明确说明，生成图片包含 SynthID 水印。

## 结论

`Nano Banana Pro API` 并不是什么神秘的第三方产品，它就是 Google 的 `gemini-3-pro-image-preview`。

如果你是从零开始接入，先走原生 Gemini 路线；如果你已经有 OpenAI 风格客户端，并且最重要的是降低迁移成本，再有意识地使用 Gemini 的 OpenAI 兼容层。无论走哪条路，都先用 Google 官方的价格、计费和限额页面建立基线，再让第三方提供商页面进入你的决策流程。