API 文档 / Trellis 质检（视频）

API 文档 · Trellis 质检（视频）

模型 ID：trellis-qc-video

接口

POST /v1/evaluations/videomultipart/form-data提交视频质检

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

调用方式

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

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

请求参数：

参数	类型	必填	默认	说明
`model`	string	是	trellis-qc-video	固定 trellis-qc-video
`file`	file	是	—	待质检视频
`prompt`	string	否	—	提示词；提供则抽帧算 `clip_score` 均值
`reference_image`	file	否	—	参考人脸图；提供则返回 `face_sim`
`frames`	integer	否	8	抽帧数，范围 1~64（越界自动夹取）

响应示例：

{ "width": 2048, "height": 1150, "frames": 6, "seconds": 2.0, "fps": 8.0,
  "clip_score": 0.3132, "clip_scores": [0.3126, 0.3137, 0.3135],
  "faces": 6, "face_sim": 0.9838, "face_consistency": 0.987,
  "usage": { "seconds": 2.0 } }

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