Nano Banana 生成与编辑 API
Nano Banana 名称对照
Section titled “Nano Banana 名称对照”| 模型 | 官方 API 名称 | 说明 |
|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | 本文三档 thinking 参数仅用于此模型 |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | 独立模型;旧 gemini-3.1-flash-image 按 Lite 兼容,不代表 2.1 |
| Nano Banana Pro | gemini-3-pro-image | 平台兼容名为 gemini-3.0-pro-image;不套用 2.1 的三档 thinking |
实际在售名称以模型广场为准。请求 2.1 时请明确填写 gemini-nano-banana-2.1。
Gemini Image · Nano Banana 2.1
Section titled “Gemini Image · Nano Banana 2.1”API 主模型:gemini-nano-banana-2.1。
| 参数 | 类型 | 范围/默认 | 说明 |
|---|---|---|---|
| model | string | 见卡片模型名 | 不使用带横竖屏、2K、4K 后缀的变体 |
| prompt | string | 必填 | 图片描述或编辑指令 |
| resolution | string | 1080p / 2k / 4k | 香蕉插件默认 1080p;此处 1080p 是历史基础 1K 标签,不是实际像素高度承诺 |
| aspect_ratio | string | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 | 基础图画幅 |
| thinking_level | string | low / medium / high;默认 medium | Flow 兼容入口的思考强度;原生路径为 generationConfig.thinkingConfig.thinkingLevel |
| response_format | string | url / b64_json | 不填使用接口默认格式 |
图片兼容接口:POST /v1/images/generations
{ "model": "gemini-nano-banana-2.1", "prompt": "木桌上的陶瓷咖啡杯,柔和自然光。", "n": 1, "resolution": "4k", "aspect_ratio": "1:1", "thinking_level": "medium", "response_format": "url"}Gemini 兼容接口:POST /v1beta/models/gemini-nano-banana-2.1:generateContent
{ "contents": [ { "role": "user", "parts": [ { "text": "木桌上的陶瓷咖啡杯,柔和自然光。" } ] } ], "generationConfig": { "responseModalities": [ "TEXT", "IMAGE" ], "imageConfig": { "aspectRatio": "1:1", "imageSize": "4K" }, "thinkingConfig": { "thinkingLevel": "medium" } }}- 先生成基础图片,再通过下载扩展得到 2K / 4K,不写成原生高分辨率直出。
- 思考强度与下载尺寸是两个参数;quality 不作为 thinking 的替代名。
- 本卡片是我们的 Flow 兼容接口。Google 官方 Gemini Developer API 的同名字段支持值因模型而异,不可直接套用这里三档。
- 图像编辑使用 /v1/images/edits 的 multipart image / image[] 字段;单文件入口限制 20 MiB。
Gemini Image · Nano Banana Pro
Section titled “Gemini Image · Nano Banana Pro”API 主模型:gemini-3.0-pro-image。
| 参数 | 类型 | 范围/默认 | 说明 |
|---|---|---|---|
| generationConfig.imageConfig.imageSize | string | 1K / 2K / 4K | 最终图片尺寸;Flow 高分辨率使用下载扩展 |
| generationConfig.imageConfig.aspectRatio | string | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 | 画幅 |
| contents[].parts | array | text / inlineData | 图文输入 |
Gemini 图片请求:POST /v1beta/models/gemini-3.0-pro-image:generateContent
{ "contents": [ { "role": "user", "parts": [ { "text": "拍摄一个玻璃瓶,保留瓶身标签文字。" } ] } ], "generationConfig": { "responseModalities": [ "TEXT", "IMAGE" ], "imageConfig": { "aspectRatio": "4:3", "imageSize": "2K" } }}- Pro 等其他不支持三档 thinking,说明稿不套用。
- 旧 nano banana pro 及带尺寸后缀的兼容名归入参数/别名说明。