编辑图片

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

根据输入图片、可选蒙版和文本提示词生成编辑后的图片。该接口适用于对现有图片进行局部重绘、替换背景、修改物体或调整画面内容等场景。

请求内容必须使用 multipart/form-data 格式提交。

请求头

名称	必填	说明
Authorization	是	使用 Bearer Token 认证，例如：Bearer sk-***
Content-Type	是	multipart/form-data

请求参数

参数	类型	必填	说明
image	file	是	要编辑的原始图片。通常应为有效图片文件，例如 PNG。
prompt	string	是	描述希望生成或修改的图片内容。
mask	file	否	蒙版图片。透明区域表示需要编辑的部分；未提供时，模型会根据整张图片和提示词进行编辑。
model	string	否	用于图片编辑的模型名称。
n	integer	否	需要生成的图片数量。
size	string	否	输出图片尺寸，例如 256x256、512x512、1024x1024。
response_format	string	否	返回图片的格式。可选值通常包括 url 或 b64_json。
user	string	否	终端用户标识，可用于追踪或风控。

请求示例

curl https://www.vortapapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-***" \
  -F "image=@image.png" \
  -F "mask=@mask.png" \
  -F "prompt=将图片中的背景替换为日落海滩" \
  -F "n=1" \
  -F "size=1024x1024"

响应示例

当 response_format 为 url 或未指定时，接口可能返回图片 URL：

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

当 response_format 为 b64_json 时，接口可能返回 Base64 编码的图片数据：

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

响应字段

字段	类型	说明
created	integer	结果创建时间，Unix 时间戳格式。
data	array	生成图片结果列表。
data[].url	string	生成图片的访问地址，当 response_format 为 url 时返回。
data[].b64_json	string	Base64 编码的图片内容，当 response_format 为 b64_json 时返回。