# Edits 通用 (图像编辑)

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

支持 gpt-image-1、flux-kontext-pro、flux-kontext-max

## 请求参数

### Header 参数

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

### Body 参数 multipart/form-data

```text
image
file
支持多图
必需
示例:
E:\\Desktop\\gpt\\icon_samll2.png
prompt
string
必需
示例:
带上眼镜
model
string
必需
支持 gpt-image-1、flux-kontext-pro、flux-kontext-max
示例:
gpt-image-1
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/v1/images/edits' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'image=@"E:\\\\Desktop\\\\gpt\\\\icon_samll2.png"' \
--form 'prompt="带上眼镜"' \
--form 'model="gpt-image-1"'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
object
```

#### 示例

```json
{
    "created": 1713833628,
    "data": [
        {
            "b64_json": "..."
        }
    ],
    "usage": {
        "total_tokens": 100,
        "input_tokens": 50,
        "output_tokens": 50,
        "input_tokens_details": {
            "text_tokens": 10,
            "image_tokens": 40
        }
    }
}
```