Trellis AITrellis AI
API 指南 / Trellis 图像编辑（Qwen-Image-Edit）

API 指南 · Trellis 图像编辑（Qwen-Image-Edit）

图像编辑 / 多图参考 / 锁脸换装，按张计费。

调用方式
同步：直接 POST 返回结果（建议超时 1200s）；超时后请勿自动重试。
异步（推荐）：POST 加请求头 X-Trellis-Async: 1 → 返回 202 {id, poll}；轮询 GET /v1/jobs/{id}（间隔 5–10s）。

输入图以 multipart/form-data 文件上传（字段 image，可重复），不是公网 URL；再用 prompt 描述目标效果。

返回 data[].url 指向结果图片，usage.image_count 为出图张数（按张计费）。

常用参数：size（如 1024x1024）、num_inference_steps（默认 40）、seed。

调用示例：

cURL
curl https://api.trellis.hk/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -F image=@ref.png \
  -F "prompt=换成西装，背景公司大堂" \
  -F num_inference_steps=30
查看 API 文档模型信息与价格
所有模型共用同一 API Key 与同一端点：https://api.trellis.hk/v1