如何使用 Nano Banana Pro/Nano Banana 2 API - 开发人员分步指南

如果你搜索了“Nano Banana Pro API”，首先让人感到困惑的就是这个名称。产品名称是 Nano Banana Pro。你在代码中实际使用的 API 名称是 gemini-3-pro-image. 一旦这一点弄清楚了，剩下的设置就没那么令人费解了。.

当图像需要保持整体一致性时，请使用 Nano Banana Pro：例如需要确保文字可读、产品细节清晰、品牌元素准确、布局本地化，或是视觉方案中存在大量细微限制的情况。如果你仍在针对同一个创意尝试十种不同版本，建议先从 Nano Banana 2 开始，待确定设计方向值得投入更多资源时，再升级至 Pro 版本。.

如果你的团队仍在完善提示词，而不是发布应用，, GlobalGPT 的 Nano Banana Pro 工作区 这是一个在开发人员接入正式 API 之前，用于比较输出结果的实用工具。它是一种富有创意的流程捷径，但不能替代 Google 的 API 控制台、计费、日志或企业级控制功能。.

快速回答

若要通过 API 使用 Nano Banana Pro，请创建一个 Google AI Studio 或 Google Cloud 项目，生成一个 Gemini API 密钥，安装 Google Gen AI SDK，然后调用 gemini-3-pro-image. 先从一个简单的文本转图像请求开始。如果你在构建 API 之前仍在验证访问权限，那么 Gemini 3 Pro 免费试用指南 是一本很有用的辅助读物。.

Nano Banana Pro API 究竟是什么

Nano Banana Pro 是谷歌 Gemini 图像系列中的高端原生图像生成模型。在开发者文档中，谷歌将其命名为 双子座 3 Pro 图像. 这就是为什么型号字符串与营销名称看起来不同。.

该 API 能够根据文本生成图像、使用一张或多张参考图像，并根据书面指令编辑现有图像。这使其在产品效果图、广告变体、图表、本地化创意以及图像工作流（其中图像内的文本必须保持可读性）等场景中非常实用；对于无代码探索，该 GlobalGPT 图像生成器 这是先测试创意方向的更合适的地方。.

Nano Banana Pro 与 Nano Banana 2 对比

选择时，关键不在于哪个名称听起来更新潮，而在于你当前的工作阶段。Pro 适用于精心打磨的版本。Nano Banana 2 则适用于杂乱的草稿迭代；如果你需要走这条更快的路线，请阅读 Nano Banana 2 免费试用指南 在围绕 Pro 设计整个工作流之前。.

使用真实的入口点配置 API

对于原型开发，Google AI Studio 通常是捷径。对于企业级应用，请使用您团队已经信赖的 Google Cloud 配置，特别是当您需要共享计费、访问控制、日志记录或 Vertex AI 治理功能时。如果访问决策确实取决于 Google 套餐等级，请在 Google AI Plus 与 Pro 版本对比指南 在将API配置视为唯一问题之前。.

公开文档是最清晰的起点。它能帮助您确认当前是否处于 Nano Banana 图像生成页面，检查该页面是否使用了推荐的 Interactions API 路径，并从该页面跳转至 API 密钥或 AI Studio 的入口。.

1. 创建或打开一个 Google AI Studio 或 Google Cloud 项目。.
2. 创建一个 Gemini API 密钥。.
3. 将密钥作为服务器端的环境变量进行存储。.
4. 在您的后端项目中安装 Google Gen AI SDK。.
5. 在添加参考图片或面向用户的功能之前，先进行一次低分辨率测试。.

API 密钥页面也是公开的，但能否创建或查看密钥取决于您的 Google 账户和项目权限。关键点在于：切勿在前端 JavaScript 中暴露该密钥。浏览器或移动应用应调用您的后端，而您的后端应调用 Gemini。.

登录后，AI Studio 的直接链接确实会跳转到 Playground，并显示 纳米香蕉 Pro 被选为 gemini-3-pro-image. 在这篇报道中，AI Studio 还指出了一个实际的使用限制：Nano Banana Pro 需要 Google AI 套餐或 API 密钥，Playground 才能运行该程序。.

"(《世界人权宣言》) 获取代码 此时仍值得点击该按钮。这可以确认您处于开发者工作流中，但如果该模型对该账户处于锁定状态，代码面板可能会打开，但其中可能没有完整的可运行代码片段。这是系统设置提示，而非提示程序的错误。.

export GEMINI_API_KEY="YOUR_API_KEY"

生成第一张图片

第一个请求应刻意设计得简单一些。你需要验证身份认证、模型访问权限、响应格式以及文件处理。那些花哨的提示功能可以等到系统运行顺畅后再考虑。.

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=(
 "创建一个不锈钢旅行杯的简洁产品效果图 "
 "放在白色桌面上。添加可读标签：MORNING LAB。"
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data:
 with open("nano-banana-pro-output.png", "wb") as f:
 f.write(part.inline_data.data)

该提示要求生成一个带有清晰可读文本的简单产品效果图。这能让你快速了解实际工作中三个关键要素：物体的真实感、构图，以及模型能否让简短的文本保持清晰锐利。若想在不修改凭据的情况下调整提示语，请尝试在 GlobalGPT 的 Nano Banana Pro 工作区 首先.

带参考文献的图片编辑

基于参考图片的编辑功能，正是 Nano Banana Pro 开始展现其价值之处。无需从头开始生成新图片，只需向模型提供一张图片，并明确告知哪些部分可以改变、哪些部分必须保持不变。.

如果您不是开发人员，请将此代码块视为工作流示例，而非需要实际运行的内容。文件名 product-reference.png 这只是指“你现有的产品图片”。如果你的主要工作是比较图像模型，那么更广泛的 Gemini 3 Pro 替代方案测试 可以帮你决定Pro版是否值得额外花时间进行设置。.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=[
 reference,
 (
 "保持马克杯的形状、把手和标志位置不变。 "
            "将背景改为明亮的厨房台面，添加温暖的晨光，"
 "并确保所有文字清晰可读。"
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

一条好的编辑提示听起来几乎就像是对设计师的反馈：保留这个，修改那个，不要移动徽标，确保文字清晰易读。诸如“让它看起来更高端”之类的模糊指示往往会导致浪费制作次数，因为它们给模型留下了太多需要猜测的空间。.

定价与成本控制

在发布固定预算数值之前，请以谷歌的定价页面作为权威信息来源。根据2026年7月21日的核实结果，谷歌将“Nano Banana Pro”归类在“Gemini 3 Pro Image”之下，并将文本/推理成本与图像生成成本区分开来。.

API 图像输出费用，核实于 2026 年 7 月 21 日

实际的成本模式很简单：草稿阶段降低成本，精修阶段精益求精。让 Nano Banana 2 处理早期的变体，然后将最强的提示和参考资料发送给 Nano Banana Pro 生成最终图像。此外，应根据用户等级设定分辨率上限，并在提示未发生变化时避免重复生成；如果需要产品端的草稿生成流程，, Nano Banana 2合GlobalGPT 这是较轻的选项，应先进行测试。.

制作笔记

一旦用户能够通过您的产品生成图像，您就需要设置防护措施。图像 API 的成本可能会迅速攀升，且在解释故障原因时，需避免泄露服务提供商的原始详细信息。对于仍在决定哪些用户需要付费 AI 访问权限的团队，还可以通过该平台比较订阅式工作流， ChatGPT 商业计划指南.

• 将密钥保存在服务器端： 请勿在浏览器或移动客户端中传输 Gemini API 密钥。.
• 记录足够的日志以便调试： 模型 ID、提示词哈希、输出大小、延迟、用户 ID 和结果状态。.
• 设置配额： 限制每个用户、每个工作区和每个计费周期内的图片数量。.
• 请仔细重试： 对临时故障进行重试，但不要对策略或配额错误进行循环重试。.
• 确定存储规则： 请说明生成的图像和上传的参考资料会保存多长时间。.
• 编写有用的错误信息： 告知用户问题是出在访问权限、文件格式、配额还是提示策略上。.

GlobalGPT 的应用场景

GlobalGPT 最适合在 API 构建之前或旁边使用。设计师可以将 Nano Banana Pro 与 纳米香蕉 2, ，将GPT Image、Flux及其他图像模型整合到同一个工作区中，然后将最优的提示词模式交给开发人员。.

若需使用官方 API 密钥、计费、日志、企业级访问权限或 Vertex AI 路由功能，请继续使用 Google 开发者平台。若想在提示词开发过程中更快地比较创意并减少打开的标签页数量，, GlobalGPT 的图像生成器工作区 可以使早期作品显得不那么笨拙。.

常见问题

Nano Banana Pro API 和 Gemini 3 Pro Image 是同一款产品吗？

就开发工作而言，是的。谷歌将 Nano Banana Pro 记录为 Gemini 3 Pro Image，其 API 型号 ID 为 gemini-3-pro-image.

我应该选择 Nano Banana Pro 还是 Nano Banana 2？

若最终图像需要更精细的控制、清晰的文字、参考信息或品牌一致性，请使用 Nano Banana Pro。若需更快地完成草稿并降低迭代成本，请使用 Nano Banana 2。.

我能否直接从前端 JavaScript 调用 Nano Banana Pro？

不。请将 API 密钥保存在服务器端，通过后端处理请求，并在向 Gemini API 发送请求之前应用用户配额。.

GlobalGPT 是否取代了官方的 Google API？

No. GlobalGPT 适用于提示词测试和多模型创意对比，但官方 API 密钥、计费、日志和企业级控制功能应在 Google 开发者平台上进行管理。.

我该如何估算 Nano Banana Pro API 的费用？

参考谷歌当前的 Gemini API 定价页面，根据模型、输出分辨率和图像体量进行估算。一种常见的成本控制策略是：先使用低成本模型进行草稿制作，然后针对选定的最终素材使用 Nano Banana Pro。.