提交图片编辑任务

上传原图并描述需要修改的内容，平台返回任务 id，然后查询编辑结果。客户侧统一异步，不需要 async。

文件上传规则： 使用 multipart/form-data。单图使用 image；多图重复传 image[]；可选 mask 仅在上游明确支持时使用。不要手工填写 Content-Type boundary，curl 和 Apifox 会自动生成。URL 输入请使用 application/json 的 images[].image_url，不能把 URL 字符串放入 multipart 文件字段。

显式填写 n、size，确保对应价格项已配置。上游模型名称由平台接入点映射，无需客户修改。

单图编辑 curl

多图时将 image 文件项替换为多个 -F 'image[]=@文件名.png'。需要蒙版且渠道支持时，再加入 -F 'mask=@mask.png'。在 Apifox 中请将文件字段设为 File 并选择本地图片，示例文字不会自动上传文件。

URL 图片编辑

Content-Type 使用 application/json，images 为对象数组；mask 如有需要同样传 image_url 对象。平台自动下载并按文件上传上游，返回任务 id，查询仍使用 GET /v1/images/edits/{taskId}。文件和URL两种输入方式不能混用。URL 必须为公网 HTTPS 443 直链，不支持重定向、内网、file_id 或 Base64；原图支持 PNG/JPEG/WebP，蒙版仅 PNG。最多 16 张原图和 1 张蒙版，单文件不超过 20 MiB、合计不超过 32 MiB，整体下载超时 60 秒。

{
  "model": "gpt-image-2.5-flare",
  "prompt": "保留主体，只把背景改为浅蓝色。",
  "images": [
    {
      "image_url": "https://example.com/source.png"
    }
  ],
  "n": 1,
  "size": "1024x1024"
}

参数错误返回 HTTP 400，error.param 定位字段，error.code 区分 missing_required_parameter（缺少必填参数）、invalid_type（类型错误）、invalid_parameter（参数值不合法）、invalid_json（JSON 语法错误）。不传图片会明确提示 Image is required，而不会误报 Invalid JSON request body。

缺少原图返回 HTTP 400：JSON 的 error.param 为 images，文件上传为 image；error.code 为 missing_required_parameter。只有 JSON 语法错误才返回 invalid_json；multipart 错标为 application/json 时提示检查 Content-Type 和 boundary。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

单图编辑 curl

URL 图片编辑

请求参数

请求示例代码

返回响应

提交图片编辑任务

单图编辑 curl#

URL 图片编辑#

请求参数

请求示例代码

返回响应

单图编辑 curl

URL 图片编辑