Nano Banana 系列
nano-banana、nano-banana-pro、nano-banana-2、nano-banana-2-lite、nano-banana-2.1 图片生成与参考图编辑，同步返回 OpenAI Images 格式
POST/v1/images/generations
接口同步等待图片完成并返回 OpenAI Images 响应。参考图编辑只需增加 image_urls。公共协议见图片生成总览。
| 项 | 值 |
|---|---|
| 模型 | nano-banana、nano-banana-pro、nano-banana-2、nano-banana-2-lite、nano-banana-2.1、nano-banana-2.1-ext |
| 模式 | 同步，返回 OpenAI Images 格式 |
| 计费 | 按成功图片数和 resolution 档位，价格以定价页为准 |
| 媒体保留 | 结果 URL 为临时地址，请及时转存 |
快速开始
curl https://api.vibelab.me/v1/images/generations \
-H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2",
"prompt": "雨夜里的霓虹街道，电影感",
"size": "16:9",
"resolution": "2K",
"n": 1
}'{"created": 1719820800, "data": [{"url": "https://..."}]}模式选择
| 模式 | 怎么传参 |
|---|---|
| 文生图 | 只传 prompt |
| 参考图编辑 | 增加 image_urls（公网 HTTP(S) URL 或 Data URL） |
请求参数
模型
| 模型 | 分辨率 | 参考图 | 特点 |
|---|---|---|---|
nano-banana | 1K | 最多 14 张，单张 ≤ 10MB | 快速生成与编辑 |
nano-banana-pro | 1K / 2K / 4K | 最多 14 张，单张 ≤ 30MB | 高质量输出，1K 与 2K 同价 |
nano-banana-2 | 0.5K / 1K / 2K / 4K | 最多 14 张，单张 ≤ 10MB | 支持搜索增强和极端宽高比 |
nano-banana-2-lite | 仅 1K | 最多 14 张 | 低成本批量生成 |
nano-banana-2.1 | 1K / 2K / 4K | 支持，单张 ≤ 20MB | 单次最多 4 张，支持极端宽高比 |
nano-banana-2.1-ext | 1K / 2K / 4K | 支持，单张 ≤ 20MB、合计 ≤ 50MB | 单次 1 张，支持极端宽高比 |
参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | 是 | - | 上表模型名 |
prompt | string | 是 | - | 图片描述或编辑指令；nano-banana 最长 1000 字符 |
size | string | 否 | auto | 宽高比：auto、1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9；Nano Banana 2、2.1 系列另支持 1:4、4:1、1:8、8:1。auto 时文生图由模型在 1:1 或 16:9 中选择，图生图跟随参考图比例 |
resolution | string | 否 | 1K | 模型支持的分辨率档位，大小写均可 |
n | integer | 否 | 1 | Lite、nano-banana-2.1 最多 4；nano-banana-2.1-ext 只能为 1 |
image_urls | string[] | 否 | - | 参考图，支持公网 HTTP(S) URL 或 data:image/png;base64,... 形式的 Data URL；格式 PNG / JPEG / WEBP |
google_search | boolean | 否 | - | 仅 Nano Banana 2 系列，启用文本搜索增强 |
google_image_search | boolean | 否 | - | 仅 Nano Banana 2 系列，启用图片搜索增强 |
输出尺寸参考
Nano Banana 2.1 系列各宽高比的输出像素（实际以返回图片为准）：
| 宽高比 | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024×1024 | 2048×2048 | 4096×4096 |
| 2:3 | 848×1264 | 1696×2528 | 3392×5056 |
| 3:2 | 1264×848 | 2528×1696 | 5056×3392 |
| 3:4 | 896×1200 | 1792×2400 | 3584×4800 |
| 4:3 | 1200×896 | 2400×1792 | 4800×3584 |
| 4:5 | 928×1152 | 1856×2304 | 3712×4608 |
| 5:4 | 1152×928 | 2304×1856 | 4608×3712 |
| 9:16 | 768×1376 | 1536×2752 | 3072×5504 |
| 16:9 | 1376×768 | 2752×1536 | 5504×3072 |
| 21:9 | 1584×672 | 3168×1344 | 6336×2688 |
响应
OpenAI Images 格式，图片在 data[].url，见图片生成总览。
计费
按成功图片数和 resolution 档位计费，价格见定价页。请求前按 n 预扣，失败退款，规则见图片生成总览。
错误
以下为本页模型的本地参数校验，均返回 400 invalid_request（仅 nano-banana-2.1、nano-banana-2.1-ext 适用）：
| HTTP | code | 触发场景 | 处理 |
|---|---|---|---|
| 400 | invalid_request | <model> is only available on /v1/images/generations | 改用 /v1/images/generations |
| 400 | invalid_request | <model> supports n up to N（nano-banana-2.1 为 4，nano-banana-2.1-ext 为 1） | 降低 n |
| 400 | invalid_request | <model> does not support official_fallback | 删除 official_fallback 字段 |
| 400 | invalid_request | <model> resolution must be one of 1K, 2K, 4K（大小写不敏感） | 使用支持的档位，或省略 |
其余错误见图片生成总览。
注意事项
- Lite 固定按 1K 生成 → 传入其他分辨率不会提升输出清晰度。
nano-banana-2.1、nano-banana-2.1-ext不传resolution→ 按 1K 生成，按默认档计费。nano-banana-pro、nano-banana传1:4、4:1、1:8、8:1→ 任务失败并全额退还积分。- 参考图需公网可访问 → 下载失败或超出大小限制时任务失败并全额退还积分。