API 文档 / Trellis 图像编辑（Qwen-Image-Edit）

API 文档 · Trellis 图像编辑（Qwen-Image-Edit）

模型 ID：trellis-qwen-image-edit

接口

POST /v1/images/editsmultipart/form-data图像编辑（可多张参考图）

POST /v1/jobs/{id}/cancel取消任务（canceling → canceled；不计费）

调用方式

同步：直接 POST 返回结果（建议超时 1200s）；超时后请勿自动重试。

异步（推荐）：POST 加请求头 X-Trellis-Async: 1 → 返回 202 {id, poll}；轮询 GET /v1/jobs/{id}（间隔 5–10s）。

请求参数：

参数	类型	必填	默认	说明
`image`	file（可重复）	是	—	输入图 1..n（参考/锁脸/场景）；multipart 文件上传，如 -F image=@ref.png
`prompt`	string	是	—	提示词
`negative_prompt`	string	否	""	反向提示词
`size`	string	否	模型默认	形如 1024x1024
`num_inference_steps`	integer	否	40	步数
`true_cfg_scale`	number	否	4.0	引导强度
`guidance_scale`	number	否	—	可选
`seed`	integer	否	0	随机种子
`response_format`	string	否	url	url \| b64_json
`qc`	boolean	否	false	是否同步质检（qc=true 时返回 JSON 含 qc 指标并忽略 response_format；不额外收费，耗时 ≥25 分钟）

响应示例：

{
  "created": 1789913791,
  "data": [ { "url": "/v1/files/image/<name>.png" } ],
  "usage": { "image_count": 1 }
}

所有模型共用同一 API Key 与同一端点：https://api.trellis.hk/v1