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)。请求参数:
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | 是 | trellis-latentsync | 固定 trellis-latentsync |
video | file | 是 | — | 待对口型的视频(含人脸) |
audio | file | 是 | — | 配音音频(wav) |
inference_steps | integer | 否 | 20 | 推理步数 |
guidance_scale | number | 否 | 1.5 | 引导强度 |
enable_deepcache | boolean | 否 | true | 加速 |
seed | integer | 否 | 1247 | 随机种子 |
响应示例:
{ "url": "/v1/files/lipsync/<name>.mp4",
"usage": { "seconds": 3.06 } }所有模型共用同一 API Key 与同一端点:
https://api.trellis.hk/v1