# Nano Banana Pro 在 Gemini 里是什么：官方模型名与正确用法 > 把 Nano Banana Pro 的昵称映射到官方 Gemini 3 Pro Image Preview 模型，了解它在 Gemini 应用与 API 里的出现方式，并确认你调用的是正确的模型 ID。 - Source: https://www.aifreeapi.com/zh/posts/nano-banana-pro-gemini - Language: zh - Published: 2026-03-28 - Updated: 2026-03-28 - Publisher: AI Free API (https://www.aifreeapi.com) **Nano Banana Pro 对应的就是 Gemini 3 Pro Image Preview 模型。** 在 Gemini API 里需要使用 `gemini-3-pro-image-preview`，而在 Gemini 应用里则是“生成图片 → Thinking”这条路径。 这个答案之所以重要，是因为**昵称**主要出现在面向用户的界面和新闻报道里，而**官方模型 ID**才是开发接入的真实依据。Google 在 [图像生成文档](https://ai.google.dev/gemini-api/docs/image-generation) 里把 Nano Banana 系列明确映射到具体模型，但大多数搜索结果并不会把这件事放在最前面讲清楚。 截至 **2026 年 3 月 28 日**，官方对应关系如下： | Nano Banana 昵称 | 官方 Gemini 模型名 | API 模型 ID | 常见出现位置 | | --- | --- | --- | --- | | Nano Banana Pro | Gemini 3 Pro Image Preview | `gemini-3-pro-image-preview` | Gemini 应用（Thinking）、AI Studio、Gemini API、Vertex AI | | Nano Banana 2 | Gemini 3.1 Flash Image Preview | `gemini-3.1-flash-image-preview` | Gemini 应用默认图像通道、AI Studio、Gemini API | | Nano Banana | Gemini 2.5 Flash Image | `gemini-2.5-flash-image` | 旧的快速通道、API 回退 | 如果你追求的是高质量、文字可读性和复杂构图，**Nano Banana Pro 是更稳的路线**。如果更在意速度或批量吞吐，Nano Banana 2 往往更合适。需要更深入对比可以看 [Gemini 3.1 Flash Image Preview vs Gemini 3 Pro Image Preview](/zh/posts/gemini-3-1-flash-image-preview-vs-gemini-3-pro-image-preview)。 ![Nano Banana Pro 与 Gemini 3 Pro Image Preview 在应用与 API 中的对应关系图](https://www.aifreeapi.com/posts/zh/nano-banana-pro-gemini/img/cover.png) ## 要点速览 - **Nano Banana Pro = Gemini 3 Pro Image Preview**，API 里用 `gemini-3-pro-image-preview`。 - **Gemini 应用路径：**生成图片 → Thinking。 - **AI Studio 路径：**直接选择 Gemini 3 Pro Image Preview。 - **只需要速度：**优先选 Nano Banana 2（Gemini 3.1 Flash Image Preview）。 | 你关心的问题 | 第一步怎么做 | 为什么有效 | | --- | --- | --- | | “Nano Banana Pro 在 Gemini 里是什么？” | 直接当成 **Gemini 3 Pro Image Preview** | 这是官方文档的模型名 | | “API 里该用哪个模型 ID？” | 使用 `gemini-3-pro-image-preview` | 这是官方 API 的标准字符串 | | “应用里在哪里找到它？” | 生成图片 → **Thinking** | 应用显示的是昵称而不是 ID | 如果只记一件事：**昵称在界面里，模型 ID 在代码里**。拿不准时，把“Nano Banana Pro”翻译成 `gemini-3-pro-image-preview` 就不会出错。 ## 为什么有昵称（以及为什么模型 ID 更关键） Google 在用户界面里使用更“友好”的昵称，但官方开发文档使用的是模型 ID。Gemini API 文档把 Nano Banana 定义为 Gemini 原生图像生成能力的总称，并进一步映射到具体模型。因此你可能在新闻或应用里看到 “Nano Banana Pro”，但开发时必须使用 `gemini-3-pro-image-preview`。 如果团队里既有人看应用界面又有人写代码，建议一开始就统一以模型 ID 为准，避免后续口径不一致。 写内部文档时可以同时保留两种写法，例如：“Nano Banana Pro（Gemini 3 Pro Image Preview / gemini-3-pro-image-preview）”，这能节省大量沟通成本。 ## 常见命名误区（以及如何避免） 第一类误区是把“Gemini 3 Pro”和“Gemini 3 Pro Image Preview”混为一谈。前者是文本模型线，后者才是图像模型。如果某个页面只写了“Gemini 3 Pro”而没有 “Image” 或 “Image Preview”，就要确认它是不是在讲图像生成。 第二类误区是直接复制第三方平台的别名。有些网关或 SDK 允许用 “nano-banana-pro” 之类的短别名，但 Google 原生 API 需要 `gemini-3-pro-image-preview`。用错位置会导致请求失败，甚至被路由到别的模型。 第三类误区是把 “Preview” 省略掉。官方文档仍把它标记为预览，这意味着名称和可用性可能变化。内部文档最好保留 “Preview”，提醒团队定期复核。 还有一点：Pro 并不是速度最快的路线。如果你的场景需要高并发或实时响应，依旧可以让 Nano Banana 2 做默认通道，而把 Pro 留给真正需要高保真输出的任务。 ## Nano Banana Pro 会出现在哪里（App / AI Studio / API） ![Nano Banana Pro 在 Gemini 应用、AI Studio 与 API 中的命名对照图](https://www.aifreeapi.com/posts/zh/nano-banana-pro-gemini/img/surface-map.png) Nano Banana Pro 同时出现在 **消费者应用、开发平台和企业通道**，但不同界面显示的标签不同。关键是把“显示的名字”和“真正要选的动作”对应起来。 - **Gemini 应用：**选择“生成图片”，切到 **Thinking** 模型时会看到 Nano Banana Pro。 - **Google AI Studio：**模型列表会显示官方名称 Gemini 3 Pro Image Preview。 - **Gemini API / Vertex AI：**必须使用模型 ID `gemini-3-pro-image-preview`。 在 Gemini 应用里，免费档或低档计划有时会默认回到更快的通道，所以每次生成前都建议看一眼模型标签。即使界面上显示的是昵称，也要以模型 ID 作为最终确认依据。 官方发布说明也强调，不同计划、区域和产品线的可用性存在差异。所以界面里看不到并不代表模型不存在，多数是滚动发布或额度条件限制。 企业场景里，无论是直接调用 Gemini API 还是通过 Vertex AI，使用的都是同一个模型 ID。只要团队统一这个 ID，就能跨环境复用配置。 | 场景 | 你会看到的标签 | 该选什么 | | --- | --- | --- | | Gemini 应用 | Nano Banana Pro（昵称） | 生成图片 → Thinking | | Google AI Studio | Gemini 3 Pro Image Preview | 选择官方模型名 | | Gemini API / Vertex AI | `gemini-3-pro-image-preview` | 在请求中设置模型 ID | 只要把这张表记住，绝大多数命名混乱就会消失。任何新闻或 UI 上的昵称，都能快速映射回真实的模型 ID。 如果只是做体验验证，AI Studio 往往是最快确认模型名的方式；如果你在做产品功能，Gemini API 才是最终的契约。 更关注价格可以看 [Gemini 3 Pro Image Preview 定价](/zh/posts/gemini-3-pro-image-preview-pricing)，更关注限额可以看 [Gemini 3 Pro Image Preview 限额](/zh/posts/gemini-3-pro-image-preview-rate-limit)。 ## 如何自己核对官方名称 不确定时，直接回到一手资料： - [Gemini 图像生成文档](https://ai.google.dev/gemini-api/docs/image-generation) 给出了 Nano Banana 系列与模型 ID 的对应关系。 - [Google DeepMind 模型卡索引](https://deepmind.google/models/model-cards/) 展示了 Gemini 3 Pro Image 的官方模型卡及更新日期。 - [官方发布说明](https://blog.google/innovation-and-ai/products/nano-banana-pro/) 会写清楚它正在覆盖哪些产品线。 这些来源一旦更新，往往就是命名或可用性发生变化的最早信号。 如果发现文档或模型卡更新，建议立刻同步内部映射表和入门文档，避免团队继续使用旧名称或旧路径。对外承诺或客户交付场景下，这一步尤其关键。 模型卡列表还能提供“日期锚点”。如果你看到 Gemini 3 Pro Image 刚刚更新，就应该重新检查内部文档和上线策略。 如果你需要跟踪预览状态或发布节奏，[Gemini API 更新日志](https://ai.google.dev/gemini-api/docs/changelog) 是最快的确认入口。任何变动都值得触发一次回归检查。 建议在内部文档里写明“最近核对日期”，并设置月度或季度复核提醒。这样即使名称或可用性调整，团队也能第一时间同步到产品说明和配置清单，避免重复踩坑。 ## Nano Banana Pro 与 Nano Banana 2 / Nano Banana 的区别 ![Nano Banana Pro、Nano Banana 2 与 Nano Banana 的官方模型名对比图](https://www.aifreeapi.com/posts/zh/nano-banana-pro-gemini/img/model-comparison.png) 最简单的判断方式是：**质量 vs 速度**。 - **Nano Banana Pro（Gemini 3 Pro Image Preview）：**强调高保真、复杂指令、文本可读性，是高阶路线。 - **Nano Banana 2（Gemini 3.1 Flash Image Preview）：**强调速度与吞吐，适合大量迭代。 - **Nano Banana（Gemini 2.5 Flash Image）：**更老的快速通道，可作为回退选择。 Google 把 Pro 定位为“工作室级”精度路线，而 Flash 系列用速度换取效率。如果你需要稳定的文字渲染、复杂构图或多图组合，优先选 Pro。若你需要高频生成或快速试错，Nano Banana 2 往往更合适。 简单记忆法： - **选 Pro**：对文本、品牌一致性、复杂布局要求高。 - **选 Nano Banana 2**：需要高频迭代与吞吐量。 - **选 Nano Banana**：只有旧快通道可用时再用。 很多团队会先用 Pro 做质量基线，再评估 Nano Banana 2 是否足够快且质量可接受。这样既不牺牲质量，又能逐步提升效率。 如果你在从旧模型或其他厂商迁移，建议先用 Pro 做第一轮对比，确定质量基线，再决定是否切换到更快的通道。 ## 如何确认你真的在用 Pro 模型 ![确认 Nano Banana Pro 使用路径的检查清单](https://www.aifreeapi.com/posts/zh/nano-banana-pro-gemini/img/confirmation-checklist.png) **在 Gemini 应用里** - 进入“生成图片”，打开模型选择。 - 确认选择的是 **Thinking**。 - 如果生成几次后回退到更快通道，可能是额度或计划限制。 **在 Google AI Studio 里** - 直接选择 **Gemini 3 Pro Image Preview**。 - 如果只能看到 Flash 模型，可能是区域或账户权限未开放。 **在 Gemini API 里** - 请求里必须写 `gemini-3-pro-image-preview`。 - 在日志里记录模型 ID，方便排查是否被默认值覆盖。 如果你总是拿到错误模型，原因通常只有三个：默认模型回退、区域或计划限制、模型 ID 写错。 如果你通过第三方 SDK 或兼容层接入，建议记录运行时最终模型 ID。这个小动作可以避免“Pro vs Flash”长期争论。 尤其在生产环境里，默认值或路由策略有时会变化，把最终解析出的模型 ID 写进日志能让排查更快、更准。 ## 水印与识别 官方文档明确指出：**所有生成图片都带有 SynthID 水印**。而面向消费者的产品可能还会加可见水印，并且与计划和产品线有关。Gemini 应用中，免费与 Pro 可能带可见水印，Ultra 与 AI Studio 可能不显示。 对外输出或客户交付时，这一点尤其重要。可见水印是体验层面的策略，SynthID 则是溯源层面的策略，两者都有可能调整。 可见水印与 SynthID 不等价：前者影响展示和品牌观感，后者影响溯源与合规。任何对外承诺前，都应该先核实当前计划和产品线的最新政策。 要点如下： - 默认假设图片一定可被 SynthID 识别。 - 可见水印会随计划或滚动发布而变化。 - 需要无可见水印输出时，务必先核实官方最新政策。 如果你需要对外交付或展示素材，可以在交付说明里提示“可能带可见水印”，避免因计划或区域差异引发误解。 ## 常见困惑的快速排查 如果你感觉“找不到”或“用错了”，可以按以下顺序排查： - **“应用里找不到 Nano Banana Pro。”**检查是否是最新版本，确认模型选择器；受计划和区域影响。 - **“生成几次后回退到 Nano Banana。”**通常是额度用完或默认通道回退。 - **“API 调用失败。”**确认是否写了 `gemini-3-pro-image-preview`。 - **“我需要速度更快的通道。”**选 Nano Banana 2（Gemini 3.1 Flash Image Preview）。 内部分享时请标记“官方模型 ID + 最近核对日期”，这样后续更新会更快。 如果你对外提供图像服务或交付客户素材，可以在说明里注明模型名称仍处于 preview 阶段，并以官方文档为准。提前声明可减少因命名变更带来的沟通成本。 如果你需要合规或可追溯性，可以把 SynthID 检查纳入发布流程；而可见水印是否出现取决于计划与产品线，发布前建议再确认一次。 对外合作或交付时，可在清单里注明当前使用的模型 ID 与核对日期，便于后续回溯。 这类标注也方便复盘与责任归因。 后续复查也会更省时间。 如果你的团队同时面对应用用户和 API 开发者，建议把昵称、官方模型名、模型 ID 放在同一页的引导文档里。绝大多数困惑都来自“界面名”和“代码名”的混用。 对跨角色团队来说，一张统一的对照表往往比多段描述更有用：它能让产品、运营和开发在同一个名词体系下沟通，减少重复确认。 把 Gemini 应用和 Gemini API 看成同一个模型的两个入口，而不是一组可互换的标签。UI 名称会变，但 API 模型 ID 才是集成依赖的基石。 如果仍然不放心，建议回到官方文档和最新发布说明核对，确认命名与发布状态是否有变化。