Nano-banana-3.1-Flash(Edits兼容)

方法: POST路径: /v1/images/edits

支持多图或不带参考图

请求参数

Header 参数

Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 multipart/form-data

model
string
必需
示例:
gemini-3.1-flash-image-preview
prompt
string
必需
示例:
一只猫
image
file
必需
支持多图或不带参考图
示例:
["file://E:\\Downloads\\1745936044575403500.png","file://E:\\Downloads\\微信图片_20250826114255_1785.jpg"]
response_format
string
可选
url 或 b64_json
示例:
url
aspect_ratio
enum<string>
可选
枚举值:
4:3
3:4
16:9
9:16
2:3
3:2
1:1
4:5
5:4
21:9
1:4
4:1
8:1
1:8
image_size
enum<string>
可选
枚举值:
1K
2K
4K
512px
示例:
4K

请求示例代码

Shell

curl --location --request POST '/v1/images/edits' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'model="gemini-3.1-flash-image-preview"' \
--form 'prompt="一只猫"' \
--form 'image=@"E:\\Downloads\\1745936044575403500.png"' \
--form 'image=@"E:\\Downloads\\微信图片_20250826114255_1785.jpg"' \
--form 'response_format="url"' \
--form 'aspect_ratio=""' \
--form 'image_size="4K"'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

object

示例

{}