/v1/images/edits

POST https://ai-api.mandao.com/v1/images/edits

图片编辑接口，OpenAI Images Edits API 兼容格式。

请求参数

Header 参数

参数名	类型	必需	说明
Authorization	string	是	Bearer Token 认证
Content-Type	string	是	`multipart/form-data`

Body 参数 (multipart/form-data)

参数名	类型	必需	默认值	说明
model	string	是	-	模型 ID，如 `gpt-image-2`
prompt	string	是	-	编辑指令提示词
image	file	是	-	待编辑的原始图片文件
mask	file	否	-	蒙版图片（标示编辑区域）
n	integer	否	1	生成结果数量
size	string	否	auto	输出尺寸
quality	string	否	-	生成质量：`standard`、`medium`、`high`
background	string	否	-	背景设置，如 `opaque`
output_format	string	否	-	输出图片格式：`png`、`jpeg`、`webp`
output_compression	string	否	-	JPEG 图片压缩率
moderation	string	否	-	内容审核级别

请求示例

curl --location 'https://ai-api.mandao.com/v1/images/edits' \
--header 'Authorization: Bearer <your-api-key>' \
--form 'model="gpt-image-2"' \
--form 'prompt="A photorealistic edit..."' \
--form 'image=@"image1.png"' \
--form 'n="1"' \
--form 'size="auto"'

返回响应

200 成功

{
    "created": 1700000000,
    "data": [
        {
            "url": "https://example.com/edited-image.png"
        }
    ]
}

错误响应

{
    "error": {
        "message": "错误描述",
        "type": "invalid_request_error",
        "code": null
    }
}

注意事项

请求必须使用 multipart/form-data 编码。
image 参数为必需项，mask 为可选项。
图片文件支持常见格式（PNG、JPEG、WEBP 等）。