# Nano-banana(Edits兼容) 

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

Nano-banana 和 gemini-2.5-flash-image-preview 的区别
gemini-2.5-flash-image-preview 官方的api模型，没做任何处理，仅支持聊天接口，可能不会返回图片，返回的图片是 base64
nano-banana 我们基于 gemini-2.5-flash-image-preview 专门画图优化的api模型，支持 dalle 格式、返回url，失败不扣费，优化了支持设置图片比例
nano-banana-hd 是高清版4K画质

## 请求参数

### Header 参数

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

### Body 参数 multipart/form-data

```text
model
string
必需
示例:
nano-banana
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>
可选
枚举值:
1:1
2:3
3:2
3:4
4:3
4:5
5:4
9:16
16:9
21:9
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/v1/images/edits' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'model="nano-banana"' \
--form 'prompt="一只猫"' \
--form 'image=@"E:\\Downloads\\1745936044575403500.png"' \
--form 'image=@"E:\\Downloads\\微信图片_20250826114255_1785.jpg"' \
--form 'response_format="url"' \
--form 'aspect_ratio=""'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

```json
{}
```