编辑图像

在原图基础上改内容、换背景或向外扩图。需要「保留原图、只改一部分」时用这个接口。

POST https://open.feiyutoken.com/v1/images/edits

请求参数

请求体是 multipart/form-data（上传图片文件），不是 JSON。

参数	类型	必填	说明
`image`	file	是	要编辑的原图。需为有效的 PNG、且为正方形，文件大小有上限，超限会直接报错
`prompt`	string	是	想改成什么样，也就是提示词，长度有上限
`mask`	file	否	遮罩图，透明区域标出要编辑的位置；尺寸需与原图一致，不传时按原图的透明区域处理
`model`	string	否	模型名，沿用厂商官方命名；可用值见模型列表
`n`	integer	否	生成几张图
`size`	string	否	输出尺寸，写法如 `1024x1024`；可用档位取决于模型
`response_format`	string	否	返回图片地址（`url`）还是 base64 内容（`b64_json`）
`user`	string	否	调用方的最终用户标识，便于按业务侧用户区分用量

请求示例

curl https://open.feiyutoken.com/v1/images/edits \
  -H "Authorization: Bearer <你的飞鱼Token API Key>" \
  -F model="<模型名>" \
  -F image="@./original.png" \
  -F mask="@./mask.png" \
  -F prompt="把背景换成纯白，保留人物" \
  -F size="1024x1024" \
  -F response_format="url"

用 -F 上传时不要手写 Content-Type —— curl 会自己带上 multipart 的 boundary，手写反而会让服务端解析失败。

不同厂商的图像模型走同一个地址，按 model 区分。这个路径下各家的请求体形态不完全一样：有的厂商直接收 JSON，图片用自己的一套字段表达。实际字段以模型厂商的接口说明为准。

响应

返回结构与生成图像一致（以实际返回为准）。

{
  "created": 1770000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

结构与生成图像一致：data 每一项是一张图， response_format 传 b64_json 时给的是 base64 内容而不是图片地址。

计费与用量

图像按张数或分辨率计费（与模型厂商官网一致），费用从账户余额扣减。调用记录与消费明细在控制台可以按模型、按 Key、按时间查看。