图像编辑 / 变体

OpenAI Images 原生协议:multipart 上传原图进行编辑或生成变体,同步返回

POST/v1/images/edits

图像编辑与变体走 OpenAI 原生端点,请求为 multipart/form-data(图片文件随请求上传,这是平台上唯一直接上传文件的方式),同步返回结果,无需轮询。

Authorizations

Authorizationstring必填

Bearer Token 认证。

Authorization: Bearer YOUR_API_KEY

图像编辑

POST /v1/images/edits

表单字段(OpenAI 原生):

  • model(必填)
  • image(必填):原图文件,可传多张(按模型支持)
  • prompt(必填):编辑指令
  • mask(可选):PNG 蒙版,透明区域为重绘区,尺寸须与原图一致
  • n、size、quality、response_format:按模型支持透传

图像变体

POST /v1/images/variations

表单字段:model、image(必填,原图)、n、size、response_format。

注意事项

  • 同步长请求,客户端超时建议 ≥ 180 秒
  • 请求体(含图片文件)总大小上限 32MB
  • 各模型对 image 张数 / 格式 / 蒙版的支持不同,以其上游官方文档为准