图片编辑

图生图（图片编辑）接口兼容 OpenAI Images Edits 风格，使用 multipart/form-data 上传图片并按提示词编辑。

POST /api/v3/images/edits

认证： Authorization: Bearer <API_KEY> 或 x-api-key: <API_KEY>

关键参数

参数	类型	必填	说明
`model`	string	是	模型调用名，如 `gpt-image-2`
`image`	file	是	输入图片，最多 16 张（重复传入 `image=@...`）
`prompt`	string	是	编辑指令
`size`	string	否	尺寸，如 `1024x1024`
`mask`	file	否	蒙版图
`n`	integer	否	输出图片数量
`stream`	boolean	否	是否开启 SSE 流式返回中间图

https://www.silvamux.com/api/v3 即接入域名下的 /api/v3，对应路由 /api/v3/images/edits。

示例

curl https://www.silvamux.com/api/v3/images/edits \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image=@photo.png" \
  -F "prompt=给图片加上一些装饰文字" \
  -F "size=1024x1024"

background、partial_images 等字段透传给模型侧。

上传限制

请求体大小不超过 64 MB。超出返回 413（REQUEST_TOO_LARGE）。

可用模型

样例模型：gpt-image-2。

完整模型清单见模型广场。

计费

图生图按生成张数计费，具体单价调 GET /billing/models 接口。