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

使用指定提示词对输入图像进行编辑。你可以提供一张或多张原图，并可通过 mask 指定允许模型修改的区域。

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

请求头

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

请求参数

该接口使用 multipart/form-data 提交参数。

参数	类型	必填	说明
model	string	否	图像编辑模型，例如 gpt-image-1。
image	file / file[]	是	需要编辑的原始图像。gpt-image-1 支持传入一张或多张图片。
prompt	string	是	描述期望编辑效果的文本提示。
mask	file	否	蒙版图片。透明区域表示可编辑区域，非透明区域通常会尽量保持不变。
n	integer	否	生成图片数量，默认通常为 1。
size	string	否	输出图片尺寸。常用值包括 1024x1024、1536x1024、1024x1536、auto。
quality	string	否	输出质量，例如 auto、low、medium、high。
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 "mask=@mask.png" \
  -F "prompt=将人物身后的背景替换为黄昏时分的城市天台，保持人物主体不变" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "n=1"

响应示例

gpt-image-1 通常以 Base64 形式返回图片数据。

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

字段说明

字段	类型	说明
created	integer	响应创建时间，Unix 时间戳。
data	array	生成结果列表。
data[].b64_json	string	Base64 编码后的图片内容。

蒙版使用说明

• mask 应与输入图像尺寸匹配，以获得更稳定的编辑效果。
• 蒙版中的透明区域代表模型可以重新生成或修改的区域。
• 非透明区域通常会被保留，但仍可能受到提示词和整体图像一致性的影响。
• 如果不传 mask，模型会根据提示词对整张图进行编辑。