编辑图像（gpt-image-1）

POST https://www.vortapapi.com/v1/images/edits

根据文本提示词对已有图片进行编辑，并返回一张或多张生成后的图片。该接口适用于局部修改、基于遮罩的重绘、图片扩展以及多图参考编辑等场景。

请求体需使用 multipart/form-data。

请求头

名称	必填	说明
Authorization	是	使用 Bearer Token 进行认证，例如：Bearer sk-***
Content-Type	是	multipart/form-data
Accept	否	建议设置为 application/json

请求参数

参数	类型	必填	说明
model	string	是	要使用的图像模型，例如 gpt-image-1
image	file / file[]	是	需要编辑的原始图片。可上传单张或多张图片，具体能力取决于模型支持情况
prompt	string	是	描述希望如何编辑图片的文本指令
mask	file	否	遮罩图片。透明区域表示需要被模型编辑的部分，非透明区域通常会被保留
n	integer	否	生成图片数量，默认通常为 1
size	string	否	输出图片尺寸，例如 1024x1024、1024x1536、1536x1024 或 auto
quality	string	否	图片质量，可选值通常包括 auto、low、medium、high
background	string	否	背景设置，例如 auto、transparent、opaque
output_format	string	否	输出格式，例如 png、jpeg、webp
output_compression	integer	否	输出压缩质量，通常用于 jpeg 或 webp，取值范围为 0 到 100
user	string	否	终端用户标识，可用于风控、审计或用量追踪

请求示例

curl https://www.vortapapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-***" \
  -H "Accept: application/json" \
  -F "model=gpt-image-1" \
  -F "image=@input.png" \
  -F "prompt=把图片中的背景替换为晴朗的海边，并保持主体人物不变" \
  -F "size=1024x1024"

使用遮罩编辑示例

curl https://www.vortapapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-***" \
  -H "Accept: application/json" \
  -F "model=gpt-image-1" \
  -F "image=@input.png" \
  -F "mask=@mask.png" \
  -F "prompt=只修改透明区域，将其变成一束鲜花" \
  -F "size=1024x1024"

响应字段

字段	类型	说明
created	integer	结果创建时间，Unix 时间戳
data	array	生成结果列表
data[].b64_json	string	Base64 编码的图片内容
data[].url	string	图片 URL。如果接口或模型配置返回链接，则可能出现该字段
data[].revised_prompt	string	模型优化或改写后的提示词，若可用则返回

响应示例

{
  "created": 1713833628,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

多图参考编辑示例

curl https://www.vortapapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-***" \
  -H "Accept: application/json" \
  -F "model=gpt-image-1" \
  -F "image[]=@person.png" \
  -F "image[]=@style-reference.png" \
  -F "prompt=参考第二张图片的绘画风格，重新绘制第一张图片中的人物" \
  -F "size=1024x1024"

注意事项

• 该接口需要上传图片文件，因此必须使用 multipart/form-data。
• 使用 mask 时，遮罩图通常需要与原图尺寸一致。
• 如果返回 b64_json，客户端需要自行将 Base64 内容解码为图片文件。
• gpt-image-1 的可用尺寸、质量和格式选项可能会随模型能力更新而变化。