图像蒙版编辑（gpt-image-1.5）

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

使用输入图片、可选蒙版以及文本提示词生成编辑后的图片。蒙版用于指定需要修改的区域：通常透明区域表示可被模型重绘的部分，非透明区域会尽量保持不变。

该接口兼容 Vortap 图像编辑能力，适用于局部重绘、背景替换、物体移除、风格调整等场景。

请求头

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

请求参数

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

参数	类型	必填	说明
model	string	是	使用的图像模型，例如：gpt-image-1.5
image	file	是	需要编辑的原始图片文件
mask	file	否	蒙版图片。透明区域通常表示需要编辑的区域
prompt	string	是	描述希望如何编辑图片的文本提示
n	integer	否	生成图片数量
size	string	否	输出图片尺寸，例如：1024x1024、1024x1536、1536x1024 或 auto
quality	string	否	图片质量，例如：auto、low、medium、high
response_format	string	否	返回格式，例如：b64_json 或 url

请求示例

curl https://www.vortapapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-***" \
  -H "Accept: application/json" \
  -F "model=gpt-image-1.5" \
  -F "image=@input.png" \
  -F "mask=@mask.png" \
  -F "prompt=将图片中被蒙版标记的区域替换为一束白色玫瑰，保持整体光照和背景风格一致" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "response_format=b64_json"

响应示例

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

如果请求中使用 response_format=url，响应中的 data 项可能返回图片链接：

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

使用说明

• image 是原图，mask 用于限定编辑范围。
• 蒙版图片应与原图尺寸一致，以获得更稳定的编辑效果。
• 如果不提供 mask，模型可能会根据提示词对整张图片进行编辑。
• 提示词应明确描述目标效果，例如需要替换的对象、颜色、材质、风格和光照要求。
• 当使用 b64_json 返回格式时，需要将 Base64 内容解码后保存为图片文件。