Skip to main content

​
概述

Nano Banana 2（代号）是谷歌于 2026 年 2 月 26 日发布的最新图像生成模型，模型 ID 为 gemini-3.1-flash-image-preview。它以 Pro 级画质 + Flash 级速度和成本 重新定义了图像生成的性价比，是 Nano Banana 系列的最新旗舰。
🔥 2026年2月26日发布：Nano Banana 2 上线！Pro 级画质、Flash 级速度，支持按量计费（低至官网 36%），512px 低至 $0.025/张！支持 4K 输出、14 种宽高比、图像搜索 Grounding 等独家特性。
🆕 2026年5月29日更新（去掉 -preview）：谷歌更新了官方文档，推出去掉 -preview 的正式模型名 gemini-3.1-flash-image，API易已同步上线支持。
  • 原模型名仍可用：gemini-3.1-flash-image-preview 继续正常调用，价格不变，现有代码无需改动。
  • 两个名字都能跑：可按需选用新名 gemini-3.1-flash-image 或原 -preview 名。
话说在前面：正式版相比 preview 版在效果表现、安全审核机制等方面是否存在差异，谷歌官方暂未明确说明，欢迎大家在实际使用中一起测试反馈。
图片 API 全部为同步调用：没有异步任务 ID，客户端断开连接结果即丢失、但请求仍会计费。请为本模型设置足够大的 timeout，详见 图片 API 调用须知与最佳实践。

文生图 API

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

图片编辑 API

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

​
让 AI Agent 帮你接入

在用 Codex / Claude Code / Cursor 开发的话，把下面这段提示词复制给它。它会先抓本页的纯文本版（任意文档页地址后加 .md），再按你项目的技术栈写代码——超时、parts 防御式解析、上传压缩、分辨率参数这几个高频坑已经写死在要求里。

让编程 Agent 接入或排查 Nano Banana 2 的文生图与图片编辑。复制后直接粘贴给 Codex、Claude Code、Cursor 等。

​
为什么选 API易 的 Nano Banana 2

Nano Banana Pro / 2 是 API易 消耗量排名第一的图像模型——稳定、可靠、速度快。如果你期望跟专业的团队合作，那选 API易 就对了。 针对 Nano Banana 2 这种谷歌官方刚发布、产能仍紧张的新模型，API易 在稳定性、成本、接入体验三方面做了深度优化：

官方通道 · 与 Gemini 一致

完全兼容谷歌官方 Gemini API 格式（/v1beta/models/.../generateContent），同时支持 OpenAI SDK 模式，请求体、响应字段、错误码与官方一致，迁移零改造。

不限并发 · 企业可放量

无谷歌 AI Studio 的 RPM/RPD 硬限制，企业批量出图、高峰流量都能线性放大，避免被官方配额打断。

官网 28-36% 价格

按次 $0.055/张（官方 $0.151）、按量 512px 低至 $0.025/张（官方 $0.045），叠加 充值加赠活动 最低可达官方 30.3%。

全球零门槛接入

无需海外服务器或代理，国内机房、家宽网络、海外节点均可直连 api.apiyi.com，延迟稳定、免去出海改造。

模型生态齐全

同系列覆盖 Nano Banana Pro（极致画质）、Nano Banana 2（性价比）、Nano Banana 第一代（基础版），按场景自由组合。

专业服务 · 企业陪跑

团队深耕图像生成场景，具备丰富的选型、调优与集成经验，可为企业客户提供从 PoC 到生产上线的完整技术支持。

​
核心特性

Pro 级画质

生动光影、丰富纹理、锐利细节，画质媲美 Nano Banana Pro，速度却快得多

4K 超清输出

支持 512px、1K、2K、4K 四档分辨率，最高 4096×4096

14 种宽高比

新增 1:4、4:1、1:8、8:1，共支持 14 种宽高比，覆盖更多场景

图像搜索 Grounding

Nano Banana 2 独家功能，可从 Google 图片搜索拉取视觉上下文

精准文字渲染

图片内文字清晰可读，支持多语言文本渲染，适合海报、营销物料

多轮编辑对话

支持多轮对话式图像编辑，逐步精调画面效果

思维模式

可配置 minimal 或 high 思维级别，处理复杂提示词更精准

主体一致性

最多保持 5 个角色的相貌一致性，14 个参考物体的高保真度

​
版本对比

选择建议：
  • 🔥 追求性价比 → Nano Banana 2（按量计费低至 $0.025/张，Pro 级画质 + Flash 级速度）
  • 🎨 追求极致画质 → Nano Banana Pro（$0.09/次，最高保真度）
  • ⚡ 追求最低成本 → Nano Banana（$0.02/次，快速稳定）

​
模型定价

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

​
按次计费

Nano Banana Pro 另提供 NanoBananaEnterprise 企业 HA 通道（1.4 倍费率，即 $0.126/次），适合对可用性有更高要求的场景。

​
按量计费（Nano Banana 2 专属）

​
按量计费价格预估

💰 按量计费更省钱！ 使用按量计费，512px 低至 $0.025/张，仅为官方 36%！低分辨率场景下比按次计费（$0.055/次）更实惠。4K 场景按量计费约 $0.07/张，仍远低于谷歌官方 $0.151/次。结合充值加赠活动，实际成本更低。

​
分组介绍

Nano Banana 2 在 API易提供两个分组，可在后台「令牌设置」中切换： 1.4x 倍率怎么来的？ 1.4x 后仍约等于谷歌官方 5 折水平，远低于官网原价。这是面向更高并发需求、应对意外风控时的兜底方案，为企业客户提供高可用性保障。默认分组紧张时，把令牌切到 NanoBananaEnterprise 即可临时过渡。 令牌「计费模式」推荐：选 按量优先（Pay-as-you-go Priority）—— 同时兼容 Nano Banana 2 的按量计费 和 Nano Banana Pro 的按次计费，一把令牌跑全系列。
令牌创建界面：计费模式『按量优先』兼容 NB2 按量 + NB Pro 按次；主分组 Default + 兜底分组 NanoBananaEnterprise（1.4x 兜底通道）

令牌设置：计费模式选「按量优先」，主分组选 Default、兜底分组挂上 NanoBananaEnterprise（1.4x）

拓展玩法：如果你的令牌还覆盖其它图像模型（如 GPT-image-2），把更稳的 Default 分组放主位、NanoBananaEnterprise 放兜底位即可，主分组 429 会自动回退到企业分组继续出图，无需切换 token。

​
支持的分辨率与宽高比

​
输出分辨率

​
支持的宽高比（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

​
各宽高比的输出尺寸（像素）

下表为 Nano Banana 2 在 512px / 1K / 2K / 4K 四档分辨率下、14 种宽高比对应的实际输出像素尺寸（数据来源：谷歌官方文档）。在请求中通过 aspect_ratio 指定宽高比、image_size（或 resolution）指定分辨率即可：
相比 Nano Banana Pro 的 10 种宽高比，Nano Banana 2 新增了 1:4、4:1、1:8、8:1 四种超长/超宽比例，适合长图、信息图等特殊场景；并独有 512px 低分辨率档位，适合缩略图与快速预览。

​
常见问题

Nano Banana 2 (gemini-3.1-flash-image-preview) 基于 Gemini 3.1 Flash，Nano Banana Pro (gemini-3-pro-image-preview) 基于 Gemini 3 Pro。主要区别：
  • ✅ 速度：Nano Banana 2 更快（Flash 级速度）
  • ✅ 价格：Nano Banana 2 按量计费更便宜（低至 $0.025 vs $0.09）
  • ✅ 宽高比：Nano Banana 2 支持 14 种（多 4 种）
  • ✅ 图像搜索 Grounding：Nano Banana 2 独家
  • ⚠️ 极致画质：Nano Banana Pro 仍略优
推荐切换！Nano Banana 2 以更低的价格提供了接近 Pro 级别的画质，速度还更快。除非你对画质有极致要求，否则 Nano Banana 2 是更好的选择。只需将模型名称从 gemini-3-pro-image-preview 改为 gemini-3.1-flash-image-preview 即可。
代码 / API 调用，建议统一用不带 -4k 后缀的通用模型名 gemini-3.1-flash-image-preview，而不是 gemini-3.1-flash-image-preview-4k。
  • 官方命名不带 -4k：谷歌官方的模型名就是 gemini-3.1-flash-image-preview。这也是我们投入最多资源持续维护的通用通道，稳定性和兼容性最有保障。
  • -4k 的由来：gemini-3.1-flash-image-preview-4k 当初是为 Chatbox 等对话式客户端的「对话出图」场景准备的配置——在聊天界面里直接对话生成图片时使用。
  • 代码 + Gemini 原生格式更推荐通用名：如果你是通过代码调用、走 Gemini 原生格式（/v1beta/models/.../generateContent），用常规模型名 gemini-3.1-flash-image-preview 会更稳定。
需要 4K 分辨率输出时，无需依赖 -4k 模型名——直接在请求参数里指定 4K 分辨率即可（见上方「支持的分辨率与宽高比」）。
图像搜索 Grounding 是 Nano Banana 2 的独家功能。它可以从 Google 图片搜索拉取视觉上下文，生成更贴合现实世界的图像。例如，当你要求生成某个真实地标的图片时，它能参考搜索结果来提高准确性。
思维模式（Thinking Mode）让模型在生成图像前进行推理分析，对复杂提示词的理解更准确。设置为 high 时效果最好，但会稍微增加生成时间。适合需要精确构图、包含文字、或涉及复杂场景的生成任务。
生成时间取决于分辨率和是否启用思维模式：
  • 1K 分辨率：约 5-10 秒
  • 2K 分辨率：约 10-15 秒
  • 4K 分辨率：约 15-25 秒
  • 启用高级思维模式会额外增加几秒
建议设置较长的超时时间（至少 360 秒）以应对偶发延迟和高峰拥塞。
API 不限制并发，也不是串行处理。 你可以放心地自行并发调用，请求之间不用排队、不会互相阻塞——20 个用户同时调用直接发起 20 个并发请求即可，无需额外申请配额或做限流。与谷歌 AI Studio 不同，API易 的通道没有 RPM/RPD 硬限制，企业批量出图、高峰流量都能线性放大。真正要注意的是 timeout 超时时间：图像生成（尤其 4K 或高峰拥塞时）单次耗时可能较长，建议把客户端超时设到 360 秒，避免请求还在正常处理就被本地超时掐断。
如果偶发 429（并发过高被限流），可把令牌的兜底分组挂上 NanoBananaEnterprise（见上方「分组介绍」），主分组打满时自动回退，进一步提升高并发下的成功率。
支持 image/png 和 image/jpeg 格式。可以通过 base64 编码或 Files API 上传。
所有输出图片都带有 SynthID 隐形数字水印（Google 的 AI 生成内容标识技术），肉眼不可见，不影响使用。
完整报错形如：
这种错误往往是上传的图片体积过大，请求体超限把连接压崩了。请按以下最佳实践处理：
  • 控制图片张数：保持在官方规则内（每个提示最多 14 张图），不要堆图。
  • 控制单图体积：每张图尽量不要超过 5MB——官方单图上限为 7MB，且 base64 编码后体积还会膨胀约 1/3，原图请留足余量。
  • 前端先压缩再上传：在前端（或服务端中转层）压缩后再提交给接口，常见做法是限制最长边、转 JPEG/WebP 并控制质量参数。
  • 改用 URL 传图：Gemini 原生格式支持 fileData.fileUri 直接传图片 URL，可避开 base64 请求体过大的问题，详见 Nano Banana 开发指南。

​
相关文档

Nano Banana 2 目前处于 Preview 状态，功能和定价可能会有调整。建议关注文档更新获取最新信息。