图像编辑 nano-banana

提示

default分组默认返回url格式。Gemini分组默认返回base64格式（更稳定），两个分组生图价格都一样的。
注意：该接口使用FormData参数请求，并非Json格式参数。
使用url格式返回，url有效性仅有数小时，需尽快下载url图片地址。

nano-banana (gemini-2.5-flash-image) 支持接口类型

接口类型	端点	说明
OpenAI聊天接口	/v1/chat/completions	支持流、非流连续对话、不支持尺寸
OpenAI图片生成接口	/v1/image/generations	文生图、支持尺寸
OpenAI图片编辑接口	/v1/image/edits	图生图（支持传入1~6张图）、支持尺寸

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

image

file

必需

源图像（最多传入6张图）3张以内效果最佳。
要编辑的图像 File 对象或对象数组，必须是png、jpeg、jpg、webp 等格式。

prompt

string

必需

所需图像的文本描述，最大支持输入32,768 Tokens。

model

enum<string>

必需

nano-banana-pro就是 gemini-3-pro-image-preview模型，使用nano-banana系列命名的模型，支持url输出。

枚举值:

nano-banana-pronano-banana-pro-2knano-banana-pro-4knano-bananagemini-3.1-flash-image-previewgemini-3.1-flash-image-preview-0.5kgemini-3.1-flash-image-preview-2kgemini-3.1-flash-image-preview-4kgemini-3-pro-image-previewgemini-2.5-flash-image

response_format

enum<string>

可选

返回的数据类型，默认base64

枚举值:

b64_jsonurl

示例:

url

size

enum<string>

可选

nano-banana和2.5系列可输入尺寸或比例，如果传入auto或不传该参数则跟原图大小一致。

Aspect ratio	Resolution
1:1	1024x1024
2:3	832x1248
3:2	1248x832
3:4	864x1184
4:3	1184x864
4:5	896x1152
5:4	1152x896
9:16	768x1344
16:9	1344x768
21:9	1536x672

注意：nano-banana-pro、gemini-3+系列模型请使用以下值 1K、2K、4K
gemini-3.1-flash-image-preview额外支持0.5K

枚举值:

1:12:33:23:44:34:5

展开全部5:49:1616:921:91k2k4k

aspect_ratio

enum<string>

可选

注意：仅nano-banana-pro、gemini-3+系列模型支持该参数。输入具体的图片比例
示例： 2:3

枚举值:

1:12:33:23:44:34:55:49:1616:921:9

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object]

必需

url

string

可选

示例

{
    "created": 1745984918,
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSUhEUgAABAAAAAYACAI..."
        }
    ],
    "usage": {
        "input_tokens": 1298,
        "input_tokens_details": {
            "image_tokens": 1290,
            "text_tokens": 8
        },
        "output_tokens": 1308,
        "total_tokens": 1316
    }
}

图像编辑 nano-banana

nano-banana (gemini-2.5-flash-image) 支持接口类型#

请求参数

请求示例代码

返回响应

nano-banana (gemini-2.5-flash-image) 支持接口类型