把参考素材组织成新画面
将产品照片与风格参考一起提交，并说明每张图片的作用，例如保留产品外形、借用背景色调、调整场景布局。nano-banana 能围绕这些线索生成融合画面，适合在已有品牌素材基础上探索新构图，而不是每次从空白描述开始。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 型号对应
- Google Gemini 2.5 Flash Image
- 创作方式
- 文本生成图像；文字结合参考图编辑
- 编辑控制
- 自然语言指定背景、光照、物体与风格变化
- 专用入口
- POST /nano-banana/images；generate、edit
- 专用入口画幅
- 1:1、3:2、2:3、16:9、9:16、4:3、3:4
- 专用入口数量
- count 请求范围 1–4，默认 1
- 结果交付
- 专用入口返回 image_url；OpenAI 风格入口可选择 URL 或 Base64 响应
创作与编辑能力对应 Gemini 2.5 Flash Image；画幅、数量和结果字段按本平台所选调用入口区分。
核心能力
了解 nano-banana 能为你的工作带来什么。
用具体指令做渐进修改
编辑时可以直接描述“背景换成木桌”“光线改为柔和晨光”或“替换画面中的物体”。更实用的方式是同时写清哪些元素需要保留，把一次修改集中在明确目标上，便于比较前后差异，也减少整幅画面反复重做的成本。
围绕同一主体制作变体
当一组素材需要反复出现同一产品或角色时，可持续使用相同参考图，并固定外观、配色与风格描述。模型有助于保持主体辨识度，让场景、灯光和构图成为主要变化项，适合连续海报、品牌角色故事和分镜概念的视觉探索。
适用场景
从具体任务出发，找到模型发挥作用的位置。
产品换景与广告创意
输入清晰的产品图，描述目标环境、镜头视角和光线，生成桌面、居家或户外场景素材。随后围绕同一产品尝试不同背景与留白布局，交付一组供设计师筛选的广告候选图；商品标识、包装文字和关键结构应在发布前逐项检查。
品牌角色与分镜草案
以角色参考图为基础，描述每个场景的动作、环境与情绪，制作连续故事的视觉草案。把角色外观要求与场景变化分开书写，可以更清楚地控制每幅图的目标。交付物适合用于讨论镜头和叙事方向，而非直接替代精确的角色设定稿。
短文案海报与封面
先准备准确的标题和少量辅助文字，再指定主次层级、背景与留白位置，生成活动海报、菜单概念或社交封面。简单布局更便于检查文字与视觉关系；选定构图后再逐步调整颜色和元素位置，需要严格排版时可把最终文字交给设计工具完成。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
日常迭代优先考虑基础型号
如果任务主要是产品换景、角色变体和创意草案，nano-banana 的快速生成与自然语言编辑定位较为贴合。它对应 Gemini 2.5 Flash Image，而 nano-banana-2 对应 Gemini 3.1 Flash Image，二者不是同一型号的不同拼写。已有成熟模板时，可先用基础型号验证画面方向。
精细交付不要混用版本规格
nano-banana-pro 对应 Gemini 3 Pro Image，是另一种版本选择。对于精细品牌视觉，可用同一组素材与提示词比较候选结果，再按文字、结构和细节要求决定使用哪个型号。不要把 Pro 或 nano-banana-2 的分辨率、工具能力直接套用到 nano-banana，切换时也应重新检查参数组合。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 主体一致性是创作辅助，不等于每次都能精确保留包装结构、面部细节或商标形状。参考图应清晰、用途明确，避免多个素材同时提出互相矛盾的要求；系列图尤其需要检查主体外观是否在不同场景中发生变化。
- 图中文字适合短标题和简单层级，不宜把长段说明、密集小字或严格字体规范全部交给一次生成。提供准确文案后仍应检查错字、漏字、间距和换行，涉及商品信息或活动规则时，建议在最终排版阶段完成校对。
- 迭代编辑时，应把上一轮图片作为下一轮素材提交，并重述需要保持的元素，不要默认请求会自动记住历史。画幅与分辨率也不是同一概念；选择横版或竖版只表达构图要求，不能据此推定最终输出像素。
常见问题
解答使用 nano-banana 时的常见疑问。
nano-banana 是 Nano Banana 2 吗？
不是。nano-banana 对应 Gemini 2.5 Flash Image；nano-banana-2 对应 Gemini 3.1 Flash Image。Nano Banana 是前者的公开昵称。接入时应使用完整调用 ID，避免因为名称相近而把不同版本的参数和创作能力混在一起。
文生图和编辑应该怎样调用？
使用 /nano-banana/images 时，文生图设置 action=generate，并提交 prompt；编辑设置 action=edit，通过 image_urls 提供素材并描述修改目标。建议显式填写 model=nano-banana，同时说明主体、场景和哪些元素需要保留。
能把产品图和风格图合成一张吗？
可以用多张参考图指导融合创作。关键是写清每张图的用途，例如产品图负责外形，风格图负责配色和氛围。尽量选择目标一致的素材，并在提示词里指定主要主体，生成后重点检查产品细节是否被风格变化影响。
已有 OpenAI 图像接口集成能使用吗？
可以使用 /openai/images/generations 或 /openai/images/edits，并明确设置 model=nano-banana。生成提交 prompt，编辑额外提交 image 的图片 URL 或 URL 数组。不同入口的素材字段和结果字段不同，接入时不要混用 image_urls 与 image。
生成结果怎样交给应用处理？
专用入口的图片地址位于 data[].image_url，可用于后续展示或下载；OpenAI 风格入口通过 data 返回 URL 或 Base64 数据。接口还提供 async、callback_url 等任务处理参数，应用应区分图片结果与 task_id，避免把任务提交成功当作图片已经完成。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。
Top-up
You pay$13,584for 142,800 credits · $0.0951 / credits
Official output $0.039−65%vs official
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
Your API key is pre-filled in the snippet — copy and run it in your terminal or IDE.
This is only a basic call example. See the full docs for more parameters and advanced usage.