API 文档 / Trellis 口型同步(LatentSync)

API 文档 · Trellis 口型同步(LatentSync)

模型 ID:trellis-latentsync

接口

POST /v1/lipsyncmultipart/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)。

请求参数:

参数类型必填默认说明
modelstring是trellis-latentsync固定 trellis-latentsync
videofile是—待对口型的视频(含人脸)
audiofile是—配音音频(wav)
inference_stepsinteger否20推理步数
guidance_scalenumber否1.5引导强度
enable_deepcacheboolean否true加速
seedinteger否1247随机种子

响应示例:

{ "url": "/v1/files/lipsync/<name>.mp4",
  "usage": { "seconds": 3.06 } }
所有模型共用同一 API Key 与同一端点:https://api.trellis.hk/v1