图像生成
Gemini Image 系列
Google Gemini 图像生成 — Nano Banana 系列(原版 / Pro / 2),文生图 / 图像编辑 / 多图参考 / 局部重绘 / 搜索增强
POST
Gemini Image 系列
Google Gemini 原生多模态图像系列,三代 Nano Banana 演进 + 双档接入:
提交后用
- Nano Banana 2(Gemini 3.1 Flash Image Preview) — 轻量快速档,延迟低、成本省,标准档独家支持 Google 文字 / 图片搜索增强,支持
0.5K~4K分辨率,适合预览、批量、迭代 - Nano Banana Pro(Gemini 3 Pro Image Preview) — 旗舰档,4K 原生输出,专业级保真度,多步规划,内置质量分析
- Nano Banana(Gemini 2.5 Flash Image Preview) — 老一代主力,低延迟、高性价比,多图融合,角色一致性
-official model id 切换通道(语义清晰),也可在标准档上设 official_fallback: true 在运行时切换(官方直连档自身不支持该字段)。
按张计费;分辨率越高的档位单价越高。所有版本支持中英文 prompt。
定价
单位:美元 / 张。flat 档位不分分辨率;分档档位按resolution 计价。
| 模型 | 0.5K / 1K | 2K | 4K |
|---|---|---|---|
gemini-3-pro-image-preview-official | $0.1206 | $0.1206 | $0.216 |
gemini-3-pro-image-preview | $0.045 | $0.045 | $0.05625 |
gemini-3.1-flash-image-preview-official | $0.0603 | $0.0909 | $0.1359 |
gemini-3.1-flash-image-preview | $0.03375 | $0.045 | $0.0675 |
gemini-2.5-flash-image-preview-official | $0.0351(仅 1K) | — | — |
gemini-2.5-flash-image-preview | $0.014063(仅 1K) | — | — |
3 Pro 的
1K 与 2K 同价($0.045 / $0.1206),仅 4K 加价。3.1 Flash 的 0.5K 与 1K 同价,2K、4K 逐档加价。2.5 Flash 仅支持 1K,为整条线最经济的档位。模式速查
所有 Gemini 图像模型只有两个 action:generate(文生图)与 edit(基于参考图改写 / 局部重绘)。多图融合、图生图都走 edit + image_urls。
| 模式 | 触发字段 | 支持版本 |
|---|---|---|
| 文生图 | action: "generate"(默认)+ prompt | 全部 |
| 图像编辑 / 图生图 | action: "edit" + image_urls | 全部 |
| 多图参考融合 | action: "edit" + image_urls(多张) | 全部 |
| 局部重绘(inpaint) | action: "edit" + image_urls + mask_url | 全部 |
| 搜索增强(grounding) | google_search: true(可选 google_image_search) | 仅 3.1 Flash 标准档 |
调用示例
GET /v1/tasks/{task_id} 轮询状态,详见 任务系统。
可用模型
| 模型 ID | 系列 | 说明 |
|---|---|---|
gemini-3-pro-image-preview-official | Nano Banana Pro · 官方直连 | 旗舰档,同模型直连,稳定性更高 |
gemini-3-pro-image-preview | Nano Banana Pro · 标准档 | 旗舰档,4K 原生,专业保真,多步规划 |
gemini-3.1-flash-image-preview-official | Nano Banana 2 · 官方直连 | 快速档直连,支持 0.5K~4K |
gemini-3.1-flash-image-preview | Nano Banana 2 · 标准档 | 快速档,Google 文字+图片搜索增强 |
gemini-2.5-flash-image-preview-official | Nano Banana · 官方直连 | 老一代直连,高性价比 |
gemini-2.5-flash-image-preview | Nano Banana · 标准档 | 老一代主力,低延迟、多图融合 |
通用参数
操作类型,可选值:
generate— 文生图(默认)edit— 基于参考图改写 / 图生图 / 多图融合 / 局部重绘(需配合image_urls)
图像描述文本,支持中英文。Gemini 系列对自然语言指令理解力强,擅长接受多步骤、多约束 prompt
生成数量(单次返回多张)
画面宽高比,全部 6 个模型支持以下 11 种取值:
auto— 自动选择(文生图默认1:1或16:9;图生图跟随输入)1:1— 正方形,头像 / 社媒2:3/3:2— 竖 / 横版相机比3:4/4:3— 竖 / 横版标准4:5/5:4— 竖 / 横版社媒9:16/16:9— 竖 / 横版宽屏21:9— 超宽横幅
输出分辨率,取决于模型:
- 3 Pro:
1K/2K/4K - 3.1 Flash:
0.5K/1K/2K/4K - 2.5 Flash:仅
1K
参考图片 URL 数组(仅
edit 使用)。图生图 / 局部重绘通常一张,多图融合可传多张回调事件过滤,如
["completed", "failed"]模型特定参数
- 3 Pro Official
- 3 Pro
- 3.1 Flash Official
- 3.1 Flash
- 2.5 Flash Official
- 2.5 Flash
model id:
gemini-3-pro-image-preview-official系列:Nano Banana Pro · 官方直连档支持 action:generate / editresolution:1K / 2K / 4Kaspect_ratio:11 种(含 auto)核心特性:与 3 Pro 标准档完全同模型,通道与稳定性更优,适合对 SLA 敏感的生产线。价格约为标准档的 2.7 倍(4K 约 3.8 倍)。局部重绘(inpaint)掩码图 URL,需配合
image_urls(仅一张),且掩码图需带 Alpha 通道资源限制
| 项目 | 限制 |
|---|---|
| 参考图片 | 多图融合可传多张;edit 局部重绘 / 图生图通常 1 张 |
| 掩码图 | mask_url 仅可一张,需带 Alpha 通道,与 image_urls 配合 |
| 单张图片大小 | ≤ 30MB,支持 JPG / PNG / WEBP |
| 输出分辨率 | 3 Pro 最高 4K / 3.1 Flash 最高 4K(最低 0.5K)/ 2.5 Flash 仅 1K |
| 输出文件 | JPG,链接 24 小时有效 |
| 搜索增强 | 仅 3.1 Flash 标准档;开启 google_search / google_image_search 可能略增延迟 |
相关文档
Gemini Image 系列