API 指南 / Trellis 质检（视频）

API 指南 · Trellis 质检（视频）

对视频抽帧做提示词贴合度与人脸一致性质检，按视频秒计费。

调用方式

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

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

以 multipart/form-data 上传 file（待质检视频）。可选 prompt（抽帧算 clip_score 均值）、reference_image（身份相似度 face_sim）、frames（抽帧数，默认 8，范围 1~64）。

另返回 face_consistency（各抽帧人脸嵌入两两余弦均值，无参考图时判断是否同一人）；按视频时长计费（usage.seconds）。

调用示例：

cURL

curl https://api.trellis.hk/v1/evaluations/video \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -F model=trellis-qc-video -F file=@clip.mp4 \
  -F "prompt=人物微笑" -F reference_image=@face.png -F frames=8

查看 API 文档模型信息与价格

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