API 文档 / Trellis 质检（图片）
API 文档 · Trellis 质检（图片）
模型 ID：trellis-qc-image
接口
POST /v1/evaluations/imagemultipart/form-data提交图片质检POST /v1/jobs/{id}/cancel取消任务（canceling → canceled；不计费）调用方式
同步：直接 POST 返回结果（建议超时 600s）；超时后请勿自动重试。
异步（推荐）：POST 加请求头
X-Trellis-Async: 1 → 返回 202 {id, poll}；轮询 GET /v1/jobs/{id}（间隔 5–10s）。请求参数：
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | 是 | trellis-qc-image | 固定 trellis-qc-image |
file | file | 是 | — | 待质检图片 |
prompt | string | 否 | — | 提示词；提供则返回 clip_score（贴合度） |
reference_image | file | 否 | — | 参考人脸图；提供则返回 face_sim（身份相似度） |
响应示例：
{ "width": 2048, "height": 1150, "clip_score": 0.314,
"faces": 92, "face_sim": 1.0, "usage": { "image_count": 1 } }所有模型共用同一 API Key 与同一端点：
https://api.trellis.hk/v1