Flux 编辑（兼容 DALL-E-3 图像编辑格式）

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

根据输入图片、可选遮罩图以及文本提示词生成编辑后的图像。该接口采用与主流图像编辑 API 兼容的请求结构，适用于对已有图片进行局部修改、风格调整或内容替换。

请求头

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

请求体

请求体应使用 multipart/form-data 格式提交。

参数	类型	必填	说明
image	file	是	要编辑的原始图片文件。
prompt	string	是	描述希望生成或修改的内容。
mask	file	否	遮罩图片。透明区域通常表示需要被编辑的部分。
model	string	否	使用的图像编辑模型，例如 flux。
n	integer	否	返回图片数量。
size	string	否	输出图片尺寸，例如 1024x1024。
response_format	string	否	返回格式，可选值通常包括 url 或 b64_json。
user	string	否	终端用户标识，可用于请求追踪或风控。

请求示例

curl https://www.vortapapi.com/v1/images/edits \
  -X POST \
  -H "Authorization: Bearer sk-***" \
  -H "Accept: application/json" \
  -F "model=flux" \
  -F "image=@./input.png" \
  -F "mask=@./mask.png" \
  -F "prompt=将图片中的天空替换为黄昏时分的橙色晚霞" \
  -F "size=1024x1024" \
  -F "n=1" \
  -F "response_format=url"

响应示例

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

如果将 response_format 设置为 b64_json，响应中的图片会以 Base64 字符串形式返回：

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

错误响应示例

{
  "error": {
    "message": "Invalid image file",
    "type": "invalid_request_error",
    "param": "image",
    "code": "invalid_image"
  }
}