API 指南 / Trellis 口型同步（LatentSync）

API 指南 · Trellis 口型同步（LatentSync）

给无声视频对齐配音口型（视频 + 音频），按秒计费。

调用方式

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

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

以 multipart/form-data 上传 video（含人脸、待对口型）与 audio（配音 wav）；可选 inference_steps（默认 20）、guidance_scale（1.5）、enable_deepcache（true）、seed（1247）。

单镜约 1~3 分钟。

返回 url（/v1/files/lipsync/<name>.mp4）与 usage.seconds；按秒计费。

调用示例：

cURL

curl https://api.trellis.hk/v1/lipsync \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -F model=trellis-latentsync -F video=@clip.mp4 -F audio=@voice.wav

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

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