Nano banana API — Gemini 2.5 Flash Image
Nano banana 是 Google Gemini 2.5 Flash Image 的社区昵称。通过 reApi 的 OpenAI 风格端点完成图像生成与编辑 — Nano banana 几分钟即可上线生产环境，而不是几天。
按次计费 — 调用 Nano banana 最便宜的方式。
同一 API 端点，由 model 参数选择具体版本。
自由文本 · 必填 · ≤ 1000 字符
Provide a prompt or at least one reference image / video / frame.
10 种比例，从 1:1 到 21:9
Nano banana 仅渲染 1K
每次请求 1–4 张
最多 14 张 · 仅接受公开 HTTPS URL
你能用它做什么
由此模型驱动的真实工作流。
用 Nano banana 批量焕新商品图
无需重拍即可编辑现有电商图。在 image_urls 里传原图 URL，用自然语言描述要改的地方，Nano banana 就会返回更新后的渲染 — 商品几何形状保持不动，周围场景按描述重做。一套提示词模板跑一百个 SKU，整个 catalog 视觉风格保持一致：相同的光线语言、相同的背景风格，每个变体都贴合品牌。
编辑一张图
几秒钟产出广告创意草稿
n=4 一条提示词出 4 个主视觉版本，立会结束前就能挑出最优。默认的 Nano banana id 偏向速度与廉价草稿；当投资人 deck 或付费投放需要更高保真渲染时，切到 `gemini-2.5-flash-image-preview-official`。同一个端点、同一份 JSON body — 草稿和终稿之间只改一个 model id。
把多张参考图融合成一张构图
传入最多 14 张参考图并描述如何组合。Nano banana 在单次调用里同时处理主体 + 场景 + 风格参考 — 一张商品图加一张 moodboard 加一张品牌色卡，模型就能融合出符合品牌调性的新画面。无需蒙版文件、无需另外合成。仅接受公开 HTTPS URL — 请先上传到自己的 R2 / S3 / OSS。
价格
积分计费 — 1 积分 = 0.001 美元，仅为成功生成付费。
| 模式 | 类别 | 单位 | 价格 |
|---|---|---|---|
| 默认 | |||
| 1K | 1 image | $0.015 15 credits | |
| Google 官方 | |||
| 1K | 1 image | $0.036 36 credits | |
为什么选 reAPI
一把 Key、一个端点、两个 model id
model 传 `gemini-2.5-flash-image-preview` 走默认 Nano banana，传 `gemini-2.5-flash-image-preview-official` 走 Google 官方端点。两个 id 都打在同一个 `/api/v1/images/generations` 路由上 — 切换只需改 request body 里的一个字符串。无需第二套 SDK、第二把 Key、也不必再接一套独立账单。从你代码的角度看，Nano banana 与其他 reApi 模型行为一致。
积分进、图片出 — 没有惊喜
按整数积分计费，1 积分 = 0.001 美元。本页估价器在提交前就按你当前配置算好费用，所以控制台里 Nano banana 的扣费金额和 playground 显示的完全一致。没有暗藏计费、没有最低消费、没有月度平台费 — 只为应用真正用 Nano banana 生成的内容付费，按图计费。
默认异步，可直接接入
提交一个 Nano banana 任务，立即拿到 task_id，按需轮询直到结果落盘。Serverless 函数、队列 worker、edge runtime — 不管你的栈跑在哪里，异步范式都能贴合。失败和被审核拦截的请求不计费，所以一条不稳的提示词永远不会扣你积分。同一套生命周期覆盖每一个 reApi 模型 — Nano banana 直接接进你现有的任务管线。
三步接入 Nano banana
- step 02
提交生成任务
向 /api/v1/images/generations POST，model 传 gemini-2.5-flash-image-preview 加一段 prompt。按需追加 size、n 或 image_urls — 网关会在扣费前校验每一个字段。Nano banana 立即返回 task_id，请求绝不会阻塞你的 handler。
打开 - step 03
轮询结果
GET /api/v1/tasks/:id 直到 status 变为 completed。Nano banana 的响应里给的是我们 CDN 上的图片 URL，24 小时内稳定可访问 — 需要更长时间请自行复制到你的存储。
打开
常见问题
关于此模型的常见疑问。
POST /api/v1/images/generations
Authorization: Bearer $REAPI_API_KEY
Content-Type: application/json
{
"prompt": "..."
}