Skip to main content

​
概述

Nano Banana 2.1 是谷歌于 2026 年 10 月 6 日发布的图像生成模型，模型 ID 为 gemini-nano-banana-2.1，发布即为正式版（GA）。它是 Nano Banana 2（gemini-3.1-flash-image）的升级版，保持 Flash 级速度，同时提升了画质、图中文字渲染和多轮编辑的一致性，并修复了上一代的平铺伪影。谷歌官方推荐新项目直接使用 2.1。
🆕 2026 年 10 月 6 日发布：API易 已同步上线，支持按次（$0.045/次，1K / 2K / 4K 同价，2026-10-13 起由 $0.05 降价）和按量（输入 $0.66、输出 $13.2 每百万 tokens）两种计费。Nano Banana 2 继续可用、价格不变，谷歌也尚未公布它的下线日期。
图片 API 全部为同步调用：没有异步任务 ID，客户端断开连接结果即丢失、但请求仍会计费。请为本模型设置足够大的 timeout，详见 图片 API 调用须知与最佳实践。

文生图 API

输入文本提示词生成图片，带交互式 Playground 在线调试。

图片编辑 API

上传图片 + 编辑指令生成新图片，带交互式 Playground 在线调试。

​
让 AI Agent 帮你接入

复制这段提示词，粘贴给 Codex / Claude Code / Cursor

它会先抓本页的纯文本版（任意文档页地址后加 .md），再按你项目的技术栈写代码——超时、parts 防御式解析、上传压缩、分辨率参数这几个高频坑已经写死在要求里。

帮我在当前项目里接入 / 排查 Nano Banana 2.1（gemini-nano-banana-2.1）的「文生图 + 图片编辑」。

先读文档再动手：抓 https://docs.apiyi.com/api-capabilities/gemini-nano-banana-2.1/overview.md 拿到本页纯 …

  1. 超时：走 Gemini 原生格式 …

共 7 条接入要求，点下方按钮复制完整版

​
核心特性

画质升级

视觉质量较 Nano Banana 2 提升，并修复了上一代的平铺伪影

文字渲染更准

图中文字更清晰、错字更少，适合海报、营销物料、信息图

多轮编辑更稳

对话式多轮编辑时角色和画面一致性更好，逐步精调不易跑偏

三档思考

支持 minimal / medium / high 三档，默认 medium，比上一代多了中间档

4K 超清输出

1K / 2K / 4K 三档分辨率，按次计费 4K 与 1K 同价

14 种宽高比

含 1:4、4:1、1:8、8:1 超长/超宽比例，官方称宽幅格式在高分辨率下效果更好

多参考图融合

最多 10 张物体参考图 + 4 张角色参考图 + 3 张风格参考图

Google 搜索接地

可挂 googleSearch 工具，画天气卡、行情图等需要实时信息的图片

​
与 Nano Banana 2 的区别

怎么选：
  • 新项目 → 直接用 Nano Banana 2.1，画质更好，按次也更便宜
  • 已在用 Nano Banana 2 → 改一个模型名即可切换；但如果代码里用了 512 档，要先改成 1K
  • 需要 512px 缩略图 → 继续用 Nano Banana 2，或用 Nano Banana 2 Lite
  • 追求画质上限 → Nano Banana Pro（$0.09/次）

​
模型定价

计费模式选择：Nano Banana 2.1 支持两种计费方式，通过创建令牌时的「Billing model」设置选择：
  • 选择 Pay-as-you-go（按量计费）或 Pay-as-you-go Priority（按量优先）→ 按量计费
  • 选择 Pay-per-request（按次计费）或 Pay-per-request Priority（按次优先）→ 按次计费
  • ⚠️ 请勿选择 Hybrid billing（混合计费）

​
按次计费

2026-10-13 起降价 10%：$0.05 → $0.045/次（1K / 2K / 4K 同价）。
  • 为什么降：按量计费下 1K / 2K 单张本来就只要 $0.02–$0.04，按次 $0.05 显得偏贵，所以把按次价也降下来。出 4K 的话，按次比按量（$0.06 以上）便宜近三成。
  • 按量价不变：输入 $0.66、输出 $13.2 每百万 tokens。
  • 还能更低：叠加充值活动加赠 10%–20%，按次实际约 $0.038–$0.041/次。

​
按量计费

模型价格与官网对齐，且可能随官网调整；上表仅供参考，具体以顶部导航「模型价格」栏目为准：模型价格。

​
按量计费：线上真实扣费预览

Nano Banana 2.1 默认就会先思考再出图（默认档 medium），每张图除了图片 tokens，还会产生约 400–1300 个思考和其它输出 tokens，它们与图片一起按 $13.2/M 计费。所以按量计费的单张费用不是定值，有高有低。下表摘自 2026-10-07 线上按量计费的真实请求，金额为控制台实际扣费（分辨率按输出 tokens 推断）： 当天 60 次按量请求的分布：
怎么选计费方式：
  • 出 1K / 2K → 选按量，单张通常 $0.02–$0.04，比按次 $0.045 更低
  • 出 4K → 选按次，固定 $0.045/次，按量要 $0.06 以上
  • 一次塞很多参考图（如 10 张以上）时，输入 tokens 会让按量费用接近甚至超过 $0.045，这类请求也建议走按次
结合 充值加赠活动，实际成本更低。
为什么不能只按图片 tokens 估成本：usageMetadata 里的 thoughtsTokenCount（思考 tokens）不包含在 candidatesTokenCount 里，但会计入 API易 日志的输出 tokens 一起计费。按 1120 / 1680 / 3780 估算会低估 20%–40%。对账请以控制台日志的扣费为准。

​
影响计费的参数

​
thinkingLevel：默认 medium，high 只贵一点

与 Nano Banana 2 不同（它默认 minimal、开 high 要贵 54%），2.1 默认就已经在思考，high 只是多想一点。对画面内文字排版、数据图表比例有硬要求时可以放心开。

​
Google 搜索接地：按检索次数另收费

需要实时信息才能画对的场景（天气卡、行情图、近期活动海报），可以挂 googleSearch 工具：
实测 3/3 触发接地，每次请求模型自主发起 2 次检索，每次检索收 $0.014（即 $14 / 1000 次）。检索次数由模型决定，无法预先控制，做成本预估时按每次请求 2–3 次检索算。
按次计费下检索费照样另收：$0.045/次只覆盖出图本身，挂了 googleSearch 后检索费按次数叠加在上面。

​
分组介绍

Nano Banana 2.1 在 API易 提供两个分组，可在后台「令牌设置」中切换： 令牌「计费模式」推荐：选 按量优先（Pay-as-you-go Priority）——同时兼容 Nano Banana 2 / 2.1 的按量计费和 Nano Banana Pro 的按次计费，一把令牌跑全系列。主分组放 Default、兜底分组挂上 NB-Enterprise，主分组 429 时会自动回退继续出图。

​
支持的分辨率与宽高比

​
输出分辨率

不支持 512：传 "imageSize": "512" 会直接返回 400 Image size 512 is not supported for this model（不计费）。从 Nano Banana 2 迁移时注意改掉。

​
支持的宽高比（14 种）

1:1、1:4、4:1、1:8、8:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9 不传 aspectRatio 时，模型会按内容自己选比例：实测风景类提示词多出 16:9，海报类多出 2:3 或 3:4。需要固定比例请显式传。

​
实测输出尺寸（像素）

以上为 2026-10-07 实测值，「—」为尚未实测。注意 8:1 在 1K 下是 2928×352，与 Nano Banana 2 的 3072×384 不同，不要照搬 Nano Banana 2 的尺寸表做前端预留。

​
常见问题

不是。2.1 是独立的新模型 ID gemini-nano-banana-2.1，画质、文字渲染和多轮一致性更好，计费结构也不同（输入更贵、图片输出更便宜、4K 单张 tokens 更多）。两个模型在 API易 同时可用，互不影响。
  1. 模型名从 gemini-3.1-flash-image（或 -preview）改为 gemini-nano-banana-2.1
  2. 如果用了 "imageSize": "512"，改成 1K
  3. 如果你按 tokens 估算成本，重新按上方「每张实际多少钱」的表核一遍
请求格式、返回结构、多图编辑和多轮编辑的写法都不用改。
截至 2026 年 10 月 7 日，谷歌没有公布 gemini-3.1-flash-image 的下线日期，只是把 2.1 列为推荐替代。API易 上的 Nano Banana 2 继续可用、价格不变。如有变化我们会提前通知。
因为 2.1 默认就会思考，每张图多出约 400–1300 个思考和其它输出 tokens，与图片一起按输出价计费。这部分在返回的 thoughtsTokenCount 里能看到。如果你出 4K 为主，改用按次计费（$0.045/次）更划算。
API 不限制并发，可以放心自行并发调用，请求之间不排队、不互相阻塞。真正要注意的是 timeout：4K 或高峰时单次耗时可能较长（实测 4K 多在 30–50 秒，个别超过 2 分钟），建议客户端超时设到 360 秒。偶发 429 时，把令牌兜底分组挂上 NB-Enterprise 即可。
所有输出图片都带有 SynthID 隐形数字水印（Google 的 AI 生成内容标识技术），肉眼不可见，不影响使用。

​
相关文档