Nano Banana 2.1 API
Nano Banana 2.1 是 Google 于 2026 年 10 月 6 日正式发布的多模态图像生成与编辑模型，主打产品级重构图、蒙版与笔迹编辑和事实准确性。Roko API 以 1K $0.02、2K $0.03、4K $0.04 每张的价格提供异步任务调用，14 种宽高比默认 1:1。
- 公开模型 ID
nano-banana-2.1- 输出档位
1K / 2K / 4K（默认 1K）- 计费方式
按输出张数与分辨率- 生成接口
POST /v1/images/tasks- 目录快照
Nano Banana 2.1 是什么？
Nano Banana 2.1 是 Google Gemini 图像系列的最新主力（正式版发布于 2026-10-06，上游 ID gemini-nano-banana-2.1），定位是多模态图像生成与编辑，官方强调改进了产品重构图、蒙版与笔迹编辑和事实准确性，并渲染照片级肤色、材质与光照。
它基于 Gemini 3.6 Flash 底座，原生支持图像生成、多轮修改、图文交织输出、虚拟试穿与 C2PA 溯源（官方能力清单），并提供 minimal/medium/high 三档思考强度与系统指令。官方评测中其文生图整体偏好达 1050（Elo），高于上一代 Nano Banana 2 的 990。注意官方明确不支持 temperature、topP、topK、seed 和 logprobs，设置会返回 API 错误。
Roko API 当前公开 1K、2K、4K 三档输出和 14 种宽高比（默认 1:1），按输出张数计费。异步任务提交后轮询结果；表单之外的能力以实际请求校验为准。
核心能力
产品级重构图
官方主打的 product recontextualization：把产品放进全新场景并保持主体一致，电商与广告素材的刚需。
蒙版与笔迹编辑
官方改进的 mask/ink 编辑：指定区域精修、笔迹标注式修改，多轮迭代不破坏未编辑区域。
14 种宽高比
从 1:8、8:1 超宽到 21:9 影视画幅，默认 1:1，海报与横幅物料一次配齐。
照片级渲染与事实准确性
官方强调照片级肤色、材质细节、光照与连贯背景，并改进生成内容的事实准确性。
Nano Banana 2.1 效果案例
以下案例取自 OpenArt 与 fal.ai 官方模型页的公开展示素材（已标注来源，非 Roko 实测），用于展示该模型的能力方向；Roko 实测案例将在测试密钥就位后补充。
电商成稿：完整产品目录
为一个虚拟护肤品牌 ELUNEA 生成整组产品目录：洁面泡沫、精华水、精华液、面霜、发膜与护手霜，浅蓝水光背景，瓶身文字清晰，附葡萄点缀，商业摄影质感
整组 SKU 的瓶型、标签文字与光影一次成型，品牌名与产品名在瓶身保持一致；这是官方主打的设计完成度方向，适合电商与品牌物料批量产出。
OpenArt 官方模型页演示素材 · 2026-10-07 核验
批量素材：同一 SKU 40+ 场景
为桃子香氛精华 MORA Peach Dew 生成 40 张以上电商素材：同一瓶型与标签在不同桃子场景中重复出现，粉色调，水面、切片与整桃交替布景
跨数十张画面保持瓶型、字体与配色一致，正是官方强调的主体一致性升级；适合广告投放所需的多版本素材批量生产。
OpenArt 官方模型页演示素材 · 2026-10-07 核验
多参考融合：人物与道具合成
将多张参考图（人物肖像、花艺装置、天空、洒水壶）融合为一张超现实作品：人物站在悬浮的植物岛屿上浇花，天空中有小鸟与蝴蝶
官方支持最多 14 张参考图输入，最多保持 4 个人物角色与 10 个物体的特征一致；演示图中人物服装、道具形态与天空背景均来自不同参考源的融合。
OpenArt 官方模型页演示素材 · 2026-10-07 核验
照片级渲染：水上水下分割
一只黑色拉布拉多叼着网球在泳池中游动，水面线分割构图，水上水下细节同时清晰，阳光斑驳，真实摄影质感
毛发湿水质感、水面折射与背景虚化接近真实摄影；官方重点强调的 more natural-looking imagery 在这张演示输出中体现明显。
fal.ai 模型页演示输出 · 2026-10-07 核验
场景重构：客厅到奇幻花海
保持人物与沙发的位置关系不变，把背景从真实客厅重构为开满鲜花的奇幻草甸，粉色天空与巨型泰迪熊入画
同一构图的两种场景渲染对照：人物姿态与沙发结构保留，环境整体替换——对应官方产品重构图（recontextualization）主打能力。
OpenArt 官方模型页演示素材 · 2026-10-07 核验
风格转换：照片到插画
把这张人物与百合花的照片转换为细腻的插画风格，保持人物姿势、服装与花的构图完全不变
照片到插画的风格迁移中，人物姿势、衣着与花的排布高度保留；演示图左下角为原始照片（已单独裁出作为输入展示）。
OpenArt 官方模型页演示素材 · 2026-10-07 核验Nano Banana 2.1 API 价格
价格由当前 Roko 模型目录生成，按输出张数与所选分辨率计费。官方按 token 计价，Roko 按张结算，本页只呈现 Roko 目录价。
| 分辨率 | 价格 | 计费单位 |
|---|---|---|
| 1k | $0.02 | 每张输出 |
| 2k | $0.03 | 每张输出 |
| 4k | $0.04 | 每张输出 |
费用怎么算？
默认档位，社媒与网页素材的标准成本。
4K 高分辨率批量输出的典型开销；失败图片不计入生成数量。
参数与支持范围
以下字段来自当前公开 generation_config。官方还支持多轮编辑、虚拟试穿、图文交织输出等能力；表单之外的能力与参数以实际请求校验为准。
| 参数 | 可用值 | 说明 |
|---|---|---|
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.1
走异步任务流程：提交任务拿到 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.1",
"prompt": "Product hero shot: matte ceramic mug centered on a linen surface, morning window light, soft shadows, editorial style",
"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 的重放会返回原任务而不重复计费。
适合哪些场景？
电商产品场景图
官方主打的产品重构图能力：产品主体保持一致，场景自由更换。
把参考图中的保温杯放进秋日露营地场景，木桌与晨雾背景，主体材质与标识不变。
局部精修与多轮修改
蒙版与笔迹编辑让多轮迭代只动该动的区域。
仅修改背景为纯白摄影棚，保持产品、阴影与反射完全不变。
超宽幅横幅与海报
1:8、8:1 到 21:9 的宽高比直接覆盖网页横幅与影视画幅。
21:9 网页 hero banner：晨光中的极简工作台，左文右图留白。
图文交织的内容卡片
官方支持图文交织输出，适合带文字的卡片与信息图。
信息卡片：标题「秋季新品」，中央产品图，底部三行卖点文字，版式干净。
使用前要知道的限制
- 官方明确不支持 temperature、topP、topK、seed 与 logprobs；设置这些参数会返回 API 错误。官方模型卡同时承认：小字号文字在 1K 输出中仍可能模糊，长段落渲染有限，蒙版编辑可能残留修改痕迹。
- Roko 当前公开 14 种宽高比（默认 1:1，无 auto）；官方还支持 9:21，以请求校验为准。
- 官方人像生成（portrait generation）不在支持列表；涉及人像的输出请自行复核适用条款。
- 官方按 token 计价（每输入图 1120 tokens），Roko 按输出张数结算；异步任务以查询结果为准，输出含 C2PA 溯源标记。
Nano Banana 系列怎么选？
2.1 是最新主力（$0.02/$0.03/$0.04）；Nano Banana Pro 更便宜（$0.018/$0.024/$0.036）且全档位；2-Lite 仅 1K（$0.018）适合纯小图量产。按新旧、分辨率与单价权衡。
全部模型 →Nano Banana 2.1 常见问题
Nano Banana 2.1 API 的模型 ID 是什么？
Roko API 当前公开模型 ID 是 nano-banana-2.1。Google 官方上游 ID 为 gemini-nano-banana-2.1，通过 Roko 调用时请使用 Roko 公开 ID。
Nano Banana 2.1 API 多少钱？
当前目录价格为 1K 每张 $0.02、2K 每张 $0.03、4K 每张 $0.04。价格可能调整，请以任务提交时的控制台估价和最终结算记录为准。
Nano Banana 2.1 和 Nano Banana Pro 怎么选？
2.1 是 2026-10-06 发布的最新版，主打产品重构图与蒙版笔迹编辑；Pro 单价更低（1K $0.018）且全档位输出。追新能力选 2.1，控成本选 Pro。
支持哪些宽高比？
Roko 当前公开 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。官方还支持 9:21，以请求校验为准。
支持图像编辑吗？
支持。传入参考图即进入图生图/编辑模式；官方能力包括多轮修改、蒙版与笔迹编辑和产品重构图，具体可用性以请求校验为准。
一次能传多少张参考图？
官方文档标注每个提示最多 14 张输入图片（单文件 7 MB 内嵌或 30 MB 经存储）；Roko 表单未暴露数量上限，以请求校验为准。
通过哪个接口调用？
通过 POST /v1/images/tasks 提交异步任务并拿到 task_id，再用 GET /v1/tasks/{task_id} 轮询结果或失败原因。
为什么设置了 temperature 会报错？
官方明确 Nano Banana 2.1 不支持 temperature、topP、topK、seed 与 logprobs 参数，设置任意一个都会返回 API 错误。请从请求中移除这些参数。