编辑图片：gpt-image-2

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

根据输入图片、可选遮罩图以及文本提示词生成编辑后的图片。该接口适用于局部重绘、替换画面元素、修改风格或根据提示对原图进行变体编辑。

请求头

名称	必填	说明
Accept	是	建议设置为 application/json
Authorization	是	Bearer 鉴权，例如：Bearer sk-***
Content-Type	是	使用 multipart/form-data 上传图片和参数

请求体

该接口使用 multipart/form-data。

参数	类型	必填	说明
model	string	是	使用的图片编辑模型，例如 gpt-image-2
image	file 或 file[]	是	需要编辑的原始图片。可上传一张或多张图片，具体能力取决于模型
prompt	string	是	描述希望如何编辑图片的文本提示
mask	file	否	遮罩图片。透明区域通常表示需要被编辑的区域
n	integer	否	生成图片数量，默认通常为 1
size	string	否	输出图片尺寸，例如 1024x1024、1536x1024、1024x1536
quality	string	否	图片质量选项，例如 auto、high、medium、low
response_format	string	否	返回格式，可选 url 或 b64_json
user	string	否	终端用户标识，便于请求追踪与风控

请求示例

curl https://www.vortapapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-***" \
  -H "Accept: application/json" \
  -F "model=gpt-image-2" \
  -F "image=@input.png" \
  -F "mask=@mask.png" \
  -F "prompt=将图片中的红色沙发替换为深蓝色皮质沙发，并保持房间光照自然" \
  -F "size=1024x1024" \
  -F "n=1" \
  -F "response_format=b64_json"

响应示例

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

如果请求中将 response_format 设置为 url，响应可能返回图片 URL：

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://www.vortapapi.com/v1/files/example-image.png"
    }
  ]
}

响应字段

字段	类型	说明
created	integer	响应创建时间，Unix 时间戳
data	array	生成的图片结果列表
data[].url	string	当 response_format 为 url 时返回的图片地址
data[].b64_json	string	当 response_format 为 b64_json 时返回的 Base64 图片内容
data[].revised_prompt	string	如果模型改写了提示词，可能返回该字段

注意事项

• 上传图片通常应为 PNG、JPEG 或 WebP 等常见格式。
• 使用 mask 时，遮罩图片应与原图尺寸一致，以获得更稳定的编辑效果。
• 如果不提供 mask，模型会根据提示对整张图片进行编辑。
• 返回 b64_json 时，客户端需要自行将 Base64 内容解码为图片文件。