图像编辑 API 文档
POST /v1/images/edits
请求地址
POST https://cloud.ve2s.ai/v1/images/edits认证方式
Authorization: Bearer YOUR_API_KEY请求格式
multipart/form-data请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image | file | 是 | 需要编辑的原始图像文件，支持 PNG 格式 |
| prompt | string | 是 | 图像编辑的文本描述，描述期望的编辑效果 |
| model | string | 是 | 使用的模型名称，如 gpt-image-2-sp |
| n | integer | 否 | 生成图像数量，默认为 1 |
| size | string | 否 | 输出图像尺寸。可选值：1024x1024（默认）、1536x1024（横向）、1024x1536（纵向） |
| quality | string | 否 | 图像质量。可选值：high、medium（默认）、low |
| mask | file | 否 | 蒙版图像文件（PNG 格式，需包含 Alpha 通道）。透明区域表示需要编辑的区域，不透明区域将保持不变 |
响应格式
成功响应（HTTP 200）
{
"created": 1778669675,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zU..."
}
]
}| 字段 | 类型 | 说明 |
|---|---|---|
| created | integer | 响应创建时间的 Unix 时间戳 |
| data | array | 生成的图像数组 |
| data[].b64_json | string | 图像的 Base64 编码字符串（当 response_format 为 b64_json 时） |
错误响应
{
"error": {
"message": "image is required",
"type": "server_error",
"param": "",
"code": "convert_request_failed"
}
}| 字段 | 类型 | 说明 |
|---|---|---|
| error.message | string | 错误描述信息 |
| error.type | string | 错误类型 |
| error.param | string | 出错的参数名称（如适用） |
| error.code | string | 错误代码 |
请求示例
示例一：基础图像编辑
{
"created": 1778669675,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zU...(完整Base64编码)"
}
]
}示例二：高质量图像编辑
quality=high 参数获得更高质量的输出。注意： quality=high模式下生成耗时较长（可能超过 60 秒），请确保客户端设置了足够的请求超时时间。
示例三：蒙版局部编辑
常见错误码
| HTTP 状态码 | 错误代码 | 说明 | 解决方案 |
|---|---|---|---|
| 401 | unauthorized | API Key 无效或已过期 | 检查 Authorization 请求头中的 API Key 是否正确 |
| 500 | convert_request_failed | 请求参数转换失败 | 检查是否缺少必填参数（如 image） |
最佳实践
1.
2.
3.
4.
5.
b64_json 为标准 Base64 编码，可使用各语言标准库直接解码为二进制图像数据接口兼容性
修改于 2026-07-21 07:53:31