跳转到内容
主站 新闻 控制台

Nano Banana 生成与编辑 API

模型官方 API 名称说明
Nano Banana 2.1gemini-nano-banana-2.1本文三档 thinking 参数仅用于此模型
Nano Banana 2 Litegemini-3.1-flash-lite-image独立模型;旧 gemini-3.1-flash-image 按 Lite 兼容,不代表 2.1
Nano Banana Progemini-3-pro-image平台兼容名为 gemini-3.0-pro-image;不套用 2.1 的三档 thinking

实际在售名称以模型广场为准。请求 2.1 时请明确填写 gemini-nano-banana-2.1。

API 主模型:gemini-nano-banana-2.1。

参数类型范围/默认说明
modelstring见卡片模型名不使用带横竖屏、2K、4K 后缀的变体
promptstring必填图片描述或编辑指令
resolutionstring1080p / 2k / 4k香蕉插件默认 1080p;此处 1080p 是历史基础 1K 标签,不是实际像素高度承诺
aspect_ratiostring1:1 / 16:9 / 9:16 / 4:3 / 3:4基础图画幅
thinking_levelstringlow / medium / high;默认 mediumFlow 兼容入口的思考强度;原生路径为 generationConfig.thinkingConfig.thinkingLevel
response_formatstringurl / 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。

API 主模型:gemini-3.0-pro-image。

参数类型范围/默认说明
generationConfig.imageConfig.imageSizestring1K / 2K / 4K最终图片尺寸;Flow 高分辨率使用下载扩展
generationConfig.imageConfig.aspectRatiostring1:1 / 16:9 / 9:16 / 4:3 / 3:4画幅
contents[].partsarraytext / 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 及带尺寸后缀的兼容名归入参数/别名说明。