POST
编辑图片 gpt-image-2
POST /v1/images/edits — 上传图片并进行编辑
编辑图片 gpt-image-2
上传一张或多张本地图片，根据提示词对图片进行编辑。适合换背景、调整光线、局部修改、产品图优化等场景。
该接口使用
multipart/form-data
接口信息
| HTTP 方法 | POST |
| 接口路径 | /v1/images/edits |
| 完整地址 | https://api000.com/v1/images/edits |
| 认证方式 | Bearer Token |
| Body 类型 | multipart/form-data |
请求头
| Header 参数 | 必填 | 示例 |
|---|---|---|
Authorization |
是 | Bearer sk-xxxxxxxxxxxxxxxx |
Accept |
否 | application/json |
Body 参数
| 参数 | 类型 | 必填 | 示例 |
|---|---|---|---|
image |
File | 是 | 选择本地图片文件 |
model |
Text | 是 | gpt-image-2-all gpt-image-2 |
prompt |
Text | 是 | 保持主体不变，把背景改成高级蓝色摄影棚 |
size |
Text | 否 | 图片尺寸如：1024x1024 |
n |
Text | 否 | 1（支持1-10） |
quality |
Text | 否 | high（支持low、medium、high和auto） |
成功响应示例
接口成功后，通常会返回图片结果。根据账号配置不同，返回 url 或 b64_json。
返回 URL
{
"created": 1710000000,
"data": [
{
"url": "https://example.com/result.png"
}
]
}
返回 Base64
{
"created": 1710000000,
"data": [
{
"b64_json": "..."
}
]
}
注意事项
/v1/images/edits必须使用multipart/form-data。image参数必须选择本地图片文件，不能直接填写图片 URL。- Body 类型选择
form-data - 如果需要严格保留主体，提示词中明确写明：保持主体外观、颜色、结构、比例和细节不变。