用修改意图驱动画面编辑
可以围绕已有图片描述移除反光、替换物体、调整背景色调等目标，而不必把整个画面重新描述一遍。提示词宜同时写明修改区域和需要保留的主体、构图与光线，让编辑更有方向，适合产品换景和素材更新。
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 模型定位
- Nano Banana 2／Gemini 3.1 Flash Image；调用 ID：nano-banana-2: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
- 结果与任务
- 返回 image_url、task_id、trace_id；支持 async 和 callback_url
Gemini 3.1 Flash Image 是模型身份，以上画幅、分辨率、数量和任务控制为本平台此调用入口的选项。
核心能力
了解 nano-banana-2:official 能为你的工作带来什么。
把文字纳入视觉创作
图中文字生成与修改是 Nano Banana 2 的具体强项，适合包含标题、标签和短文案的海报、菜单与界面草图。可以把准确文案、文字位置和版面层级一起写入提示词，使画面与信息同步设计；交付前仍应逐字校对。
结合参考图组织系列视觉
通过参考图片提供人物、产品或风格线索，再用文字说明各素材的角色和组合关系，适合制作同一主题下的场景变化。重点是让主体辨识度和视觉风格有连续性，而非仅生成彼此无关的图片；关键细节仍需逐张检查。
适用场景
从具体任务出发，找到模型发挥作用的位置。
电商产品场景扩展
输入产品图片，说明希望出现的桌面、室内环境、光线和留白位置，生成用于商品展示或广告测试的场景素材。再围绕背景、氛围或配色继续编辑，可探索不同视觉方向；产品标识、包装文字和外形应作为重点验收项。
活动海报与文案换版
输入活动主题、准确标题、日期和画幅要求，制作带文字的海报候选图；已有设计则可作为参考，修改文案或季节氛围。横版适合展示构图，竖版适合移动端内容，最终交付物是图像，不是可直接拆分图层的设计文件。
品牌内容的多方案制作
提供主体参考图与统一的风格说明，为不同内容主题生成候选视觉。可在同一请求中设置生成数量，并用异步任务和回调衔接素材管理流程。筛选时比较主体一致性、版面空间和文案准确性，再保留适合发布的版本。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
从基础版转向第二代
基础 nano-banana 对应 Gemini 2.5 Flash Image，Nano Banana 2 对应 Gemini 3.1 Flash Image。若任务重点是带文字的图像、参考图组合和持续修改，第二代值得优先试用。选择时用相同产品图与文案比较结果，不把代际变化理解为每张图都必然更好。
与 Pro 按任务比较
Nano Banana 2 适合把生成与编辑放在同一工作流中反复迭代；nano-banana-pro 则是系列中的高质量取向选择，对应 Gemini 3 Pro Image。旗舰视觉可以并行测试两者，依据文字、材质和构图验收。:official 是公开调用 ID 变体，不代表另一个独立原生模型。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 图中文字能力不等于排版软件的精确控制。密集小字、多语言混排、品牌专名和数字信息都应逐项检查；重要海报可先生成视觉底图，再完成最终文字排版，不把一次生成结果直接视为印刷定稿。
- 参考图编辑仍可能改变未指定修改的细节。产品结构、人物面部、商标和包装需要重点对照；提示词应明确哪些内容保持不变，并将复杂修改拆成可检查的步骤，避免同时提出过多相互牵制的要求。
- 1K、2K、4K 是分辨率选项，不是细节准确或印刷适用性的自动保证。请求数量上限为四张，也不代表四张结果必然保持完全相同的主体；正式交付前应检查实际尺寸、画面细节与系列一致性。
常见问题
解答使用 nano-banana-2:official 时的常见疑问。
nano-banana-2:official 是独立的新模型吗？
它是 Nano Banana 2 的公开调用 ID 变体，模型对应 Gemini 3.1 Flash Image。调用时使用完整 ID；不要把 :official 理解成新的模型代际，也不要据此推断额外创作能力或固定生成速度。
如何修改已有产品图片？
向 /nano-banana/images 发送 POST 请求，选择 action=edit，通过 image_urls 提供图片，并在 prompt 中描述修改目标。建议同时说明保留产品外形与标识、只调整背景或光线，以便检查结果是否符合要求。
可以生成哪些尺寸和画幅？
分辨率可选择 1K、2K 或 4K，画幅包括方形、横向和竖向的七种比例。先按发布位置选择 aspect_ratio，再选择 resolution；这些选项用于控制输出方向，具体图片尺寸以返回文件为准。
海报中的中文可以直接作为成稿吗？
可以尝试生成含中文标题与短文案的海报，但仍要校对每个字、数字和标点。提示词中应提供完整准确文案，并交代位置与层级；文字较多或需要严格品牌排版时，建议把最终排字作为单独步骤。
批量制作时如何接收结果？
单次请求可用 count 设置一至四张，也可结合 async 与 callback_url 组织任务。响应包含 task_id、trace_id 和图像结果中的 image_url，便于关联业务记录；接收后再执行下载、筛选与质量验收。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。