Nano Banana 2 API
Nano Banana 2（上游 ID gemini-3.1-flash-image）是 Google 的高效图像生成与编辑模型。Roko 当前目录提供 1K $0.02、2K $0.024、4K $0.03 的异步调用；Google 当前弃用页未公布该上游的关停日期，并列出 2.1 作为建议替代型号。
- 公开模型 ID
nano-banana-2- 输出档位
1K / 2K / 4K（默认 1K）- 计费方式
按输出张数与分辨率- 生成接口
POST /v1/images/tasks- 目录快照
Nano Banana 2 是什么？
Nano Banana 2 对应上游 gemini-3.1-flash-image，面向高效图像生成与编辑，强调文字渲染、主体一致性与现实世界知识。
截至 2026-10-07，Google 当前 Gemini API 弃用页没有公布 gemini-3.1-flash-image 的关停日期，并把 gemini-nano-banana-2.1 列为建议替代型号。新项目可比较 2.1，但不应宣称存在已公布的强制迁移截止日。
Roko 当前公开 1K、2K、4K 三档和 14 种宽高比，价格分别为 $0.02、$0.024、$0.03，采用异步任务。
核心能力
高效主力定位
Flash 级速度与成本、Pro 级出图质量的组合，曾是 Google 图像系列性价比最高的档位。
现实世界知识
官方把 Pro 版的现实世界知识下放：生成真实人物、地点与事件时更准确。
14 种宽高比
与 2.1 相同的 14 种比例（含 1:4、4:1、1:8、8:1 超宽），默认 1:1。
1K $0.02 的低价位
Roko 目录中价格低于 2.1 的对应档位，存量工作流迁移前的低成本选择。
Nano Banana 2 效果案例
以下案例取自第三方同题评测（PicLumen，2026 年 8 月测试，明确使用 Nano Banana 2）与 OpenArt 官方模型页展示素材（已标注来源，非 Roko 实测）；Roko 实测案例将在测试密钥就位后补充。
插画叙事：奥德修斯与海景
Nano Banana illustration of Odysseus on a seaside cliff beneath an olive tree, mythological scene
同题评测样例：插画风格下的场景叙事与氛围构图，展示 NB2 的美学处理方向。
第三方同题评测（PicLumen，2026-08 测试） · 2026-10-07 核验
纪实摄影：雨夜街头
A woman carrying an umbrella and paper bags on a rain-soaked street at night, documentary photo
雨夜氛围、湿地面反光与人物动态的纪实处理，是同题评测中的 NB2 输出。
第三方同题评测（PicLumen，2026-08 测试） · 2026-10-07 核验
文字排版：Field Notes 海报
Minimalist Field Notes Berlin poster with a red accent, clean grid layout
极简网格排版与单一强调色，展示 NB2 的文字渲染与版式控制。
第三方同题评测（PicLumen，2026-08 测试） · 2026-10-07 核验
产品摄影：NOMA 香水
NOMA No. 03 perfume product shot with a glass bottle, sliced fruit and ice, studio lighting
玻璃质感与道具氛围的产品静物处理，来自同题评测的 NB2 输出。
第三方同题评测（PicLumen，2026-08 测试） · 2026-10-07 核验
超现实场景：香蕉城市
A surreal city built entirely from bananas with roads, bridges and construction vehicles, miniature style
OpenArt 官方页的现实感与风格化展示：超大规模场景的结构一致性与材质趣味。
OpenArt 官方 Nano Banana 2 模型页展示素材 · 2026-10-07 核验
电影感场景：夜市霓虹
Two figures walking through a neon-lit night market street, cinematic composition, atmospheric lighting
OpenArt 官方页的复杂场景构图展示：多人物、招牌文字与光影层次并存。
OpenArt 官方 Nano Banana 2 模型页展示素材 · 2026-10-07 核验Nano Banana 2 API 价格
价格由当前 Roko 模型目录生成，按输出张数与所选分辨率计费。官方按 token 计价（1K $0.067），Roko 按张结算且价格更低；本页只呈现 Roko 目录价。
| 分辨率 | 价格 | 计费单位 |
|---|---|---|
| 1k | $0.02 | 每张输出 |
| 2k | $0.024 | 每张输出 |
| 4k | $0.03 | 每张输出 |
费用怎么算？
存量工作流迁移前的低成本选择。
最高档输出；失败图片不计入生成数量。
参数与支持范围
以下字段来自当前公开 generation_config。宽高比与 2.1 相同的 14 种（默认 1:1）；表单之外的能力以实际请求校验为准。
| 参数 | 可用值 | 说明 |
|---|---|---|
prompt | textarea | 描述要生成的画面，或说明要对参考图做哪些修改。 · 必填 |
image_urls | url / base64 | 参考图可使用 URL 或 Base64；编辑时说明要保持和改变的部分。 · 可选 |
aspect_ratio | 1:1 / 1:4 / 1:8 / 2:3 / 3:2 / 3:4 / 4:1 / 4:3 / 4:5 / 5:4 / 8:1 / 9:16 / 16:9 / 21:9 | 选择输出宽高比；auto 交由模型按内容决定。 · 默认: 1:1 · 可选 |
resolution | 1K / 2K / 4K | 选择当前模型配置的输出分辨率档位；该值可能直接影响价格。 · 默认: 1K · 可选 |
用 Roko API 调用 Nano Banana 2
走异步任务流程：提交任务拿到 task_id，再轮询查询结果。不要在前端代码中暴露 API Key。
发起图片生成
curl https://api.rokoapi.com/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
-d '{
"model": "nano-banana-2",
"prompt": "A quiet mountain lake at dawn, crystal water reflecting snow peaks, documentary photography",
"aspect_ratio": "16:9",
"resolution": "2K"
}'查询恢复任务
curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
-H "Authorization: Bearer $API_KEY"POST /v1/images/tasks 返回 202 与 task_id，生成完成后通过 GET /v1/tasks/{task_id} 查询结果或失败原因。Idempotency-Key 需唯一；相同 Key 的重放会返回原任务而不重复计费。
适合哪些场景？
存量工作流延续
现有 NB2 工作流可继续按目录调用，同时用相同提示词评估 2.1。
保持现有提示词生成一批季节性营销素材，并与 2.1 对比。
低成本批量配图
1K $0.02 的档位适合大批量网页与社媒配图。
为一组博客文章生成 20 张风格统一的题图，扁平插画风格。
超宽幅横幅
1:4、1:8 超宽比例覆盖网页横幅与全景展示。
8:1 全景横幅：连绵山脉与晨雾，极简色调，文字留白。
4K 高分辨率输出
需要更高分辨率时直接升 4K，无需外挂放大。
4K 展板主视觉：抽象几何渐变，品牌蓝白配色，大量留白。
使用前要知道的限制
- Google 当前没有公布 gemini-3.1-flash-image 的 Gemini API 关停日期；2.1 是建议替代型号。Roko 可用性以实时目录为准。
- Google 官方价格与 Roko 目录价格口径不同，结算以 Roko 提交时估价为准。
- 异步任务提交成功不等于生成成功，以任务查询结果为准。
- 文字、手部和细节仍可能出错，发布前应人工复核；输出权利取决于输入素材与适用条款。
Nano Banana 2、2.1 与 Lite 怎么选？
Nano Banana 2 当前仍可用；2.1 是 Google 建议替代型号。需要最低价 1K 小图可比较 Lite，需要新能力可比较 2.1；选择以实时目录和实测结果为准。
全部模型 →Nano Banana 2 常见问题
Nano Banana 2 API 的模型 ID 是什么？
Roko API 当前公开模型 ID 是 nano-banana-2。Google 官方上游 ID 为 gemini-3.1-flash-image。
Nano Banana 2 API 多少钱？
当前目录价格为 1K 每张 $0.02、2K 每张 $0.024、4K 每张 $0.03。价格可能调整，请以任务提交时的控制台估价和最终结算记录为准。
Nano Banana 2 何时停止服务？
Google 当前没有公布 gemini-3.1-flash-image 的 Gemini API 关停日期；2.1 是建议替代型号。Roko 可用性以实时目录为准。
NB2 和 2.1 有什么区别？
2.1 是官方对 NB2 的升级：画质、提示词遵循、多轮主体一致性与文字渲染均有提升，新增 1:4/4:1/1:8/8:1 超宽比例，官方 API 价格约为 NB2 的一半。NB2 的 512px 档在 2.1 上不受支持。
支持哪些宽高比？
14 种：1:1（默认）、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9。表单无 auto 档，以请求校验为准。
应该直接迁移到 2.1 吗？
官方建议如此：2.1 是官方指定的迁移目标，能力更强且官方定价更低。迁移前建议用同提示词对比两代输出，确认质量达标后切换。
通过哪个接口调用？
通过 POST /v1/images/tasks 提交异步任务并拿到 task_id，再用 GET /v1/tasks/{task_id} 轮询结果或失败原因。
NB2 生成的图有水印吗？
Google 对 Gemini 图像产品使用 SynthID 隐形水印等溯源手段；Roko 不额外添加可见水印，输出以实际返回为准。