把文字纳入视觉设计
Nano Banana Pro 的突出方向是图中文字渲染，适合标题、产品卖点和说明性画面。创作时可明确提供文案、位置和层级，让文字与主体一起参与构图，而不是只生成无字背景。正式发布前，仍应逐字检查拼写、标点和小字号内容。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 模型定位
- Nano Banana Pro，基于 Gemini 3 Pro Image；调用 ID 为 nano-banana-pro:official
- 创作方式
- generate 文生图；edit 图像编辑
- 输入素材
- 文字提示词；image_urls 参考图数组
- 分辨率选项
- 平台入口支持 1K、2K、4K
- 画幅选项
- 1:1、3:2、2:3、16:9、9:16、4:3、3:4
- 生成数量
- count 为 1—4，默认 1
- 结果交付
- 图像 URL、task_id、trace_id；支持 async 与 callback_url
Gemini 3 Pro Image 是基础模型名称；以上分辨率、画幅、数量及交付方式为本平台此入口的调用规格。
核心能力
了解 nano-banana-pro:official 能为你的工作带来什么。
多份素材组成完整场景
通过文字与参考图组合，可把人物、产品和环境融入同一画面，或围绕已有素材调整背景、色彩与构图。提示词应说明每张图承担的角色，以及哪些外观需要保留，适合有明确主体约束的产品合成和系列视觉创作。
用语言推进图像修改
编辑模式适合表达具体变化，例如替换背景、调整光线或改变材质。将上一轮结果作为下一轮参考图，再说明修改目标，可以逐步收敛画面。分辨率与画幅独立选择，便于从同一创意制作方形展示、竖版封面和横向主视觉。
适用场景
从具体任务出发，找到模型发挥作用的位置。
品牌海报与活动主视觉
输入活动主题、准确文案、品牌色和构图要求，生成带标题与卖点的海报方案。需要延续既有视觉时，可加入品牌素材作为参考。先确认布局和文字，再选择适合交付的分辨率，得到可供审稿和后续排版的图像。
产品换景与陈列展示
提供产品图片，描述使用环境、光线方向和陈列关系，制作居家、办公或户外场景图。编辑时明确要求保留包装文字、颜色和结构，有助于聚焦变化范围。交付前应对照原图检查产品外观，避免把生成细节误当作实物特征。
系列内容与组合创意
将人物、服装、道具或背景作为不同参考素材，说明它们在画面中的关系，制作主题一致的内容方案。可用 count 获取多个候选，再把选中的结果继续编辑。这种方式适合内容策划、穿搭概念展示和不同构图的视觉探索。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
重文字与合成时选择 Pro
如果画面不仅需要好看，还要承载清晰标题、产品说明或多份参考素材之间的关系，Nano Banana Pro 更符合这一任务方向。与偏向日常生成的 Nano Banana 2 相比，选择 Pro 的重点是文字与合成要求，而不是假定所有任务都获得相同提升。
原型与精修分开安排
基础 nano-banana 基于 Gemini 2.5 Flash Image，适合快速内容生产与原型验证；Pro 更适合品牌视觉和精细编辑。可以先验证主题与构图，再用 Pro 完善重点画面。:official 是本型号的公开调用 ID 后缀，不是新的 Google 模型版本，也不意味着结果免于审核。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 文字渲染是强项，但不能替代最终校对。长段文字、密集表格和细小标签应重点检查；涉及价格、日期或产品说明时，逐项核对内容。要求严格字距、字体或印刷排版的成品，可在图像生成后继续进行专业排版。
- 多图合成不等于逐像素保真。人物细节、产品边缘、包装标识和材质可能在生成中变化；应明确保留项与可修改项，避免一次要求过多互相牵制的变化。用于商品展示时，尤其需要核对外观是否忠于原物。
- 编辑需要显式提供参考图和修改说明，不能把连续调用视为自动记住历史。此入口交付图像链接与任务信息，不是分层设计文件；4K 是可选分辨率档位，也不代表画面中的文字、结构或事实会自动准确。
常见问题
解答使用 nano-banana-pro:official 时的常见疑问。
nano-banana-pro:official 是独立的新模型吗？
它是 Nano Banana Pro 的公开调用 ID，基础模型为 Google Gemini 3 Pro Image。:official 用于区分调用入口，不应理解为新的原生版本。使用时填写完整 ID，并按这一入口提供的操作、画幅和分辨率选项组织请求。
生成新图和修改旧图怎么选择？
从文字开始创作时使用 generate；需要围绕已有图片修改或合成时使用 edit，并通过 image_urls 提供参考图。两种操作都需要 prompt。编辑提示词最好分别说明要改变的部分和必须保留的主体、颜色或布局。
如何提高海报中文字的可用性？
提供准确文案，并明确标题、说明文字的位置和视觉层级；避免把所有信息挤进很小的区域。生成后逐字校对，必要时缩短文字或分次修改。对于必须严格使用指定字体的设计，可把生成结果作为视觉底稿继续排版。
可以直接生成 4:5 的图片吗？
此入口的画幅选项不包含 4:5，可选择 1:1、3:2、2:3、16:9、9:16、4:3 或 3:4。若交付需要 4:5，建议先用接近的竖向比例生成，并在提示词中预留边缘空间，再裁切到目标尺寸，避免切掉文字和主体。
怎样继续编辑，并接收生成结果？
把已生成的图像 URL 放入下一次编辑请求的 image_urls，并写出具体修改目标。通过 POST /nano-banana/images 提交后，结果包含任务标识和图像链接；批量工作流可结合 async 与 callback_url，在任务完成后接收结果。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。
Pricing
$0.049–$0.0735· per generation
Top-up
You pay$13,584for 142,800 credits · $0.0951 / credits46% OFF
You're billed in credits. Pick a top-up tier to see its per-credit rate — the larger the top-up, the cheaper each credit.
Quickstart
Try the API
API Key
Please obtain an API Key first
This is only a basic call example. See the full docs for more parameters and advanced usage.
View Docs