Trellis AITrellis AI
API 文档 / Trellis 说话视频（LongCat-Avatar 1.5）

API 文档 · Trellis 说话视频（LongCat-Avatar 1.5）

模型 ID：trellis-longcat-avatar

接口

POST /v1/avatarmultipart/form-data头像 + 音频生成说话视频
POST /v1/jobs/{id}/cancel取消任务（canceling → canceled；不计费）
调用方式
同步：直接 POST 返回结果（建议超时 2700s）；超时后请勿自动重试。
异步（推荐）：POST 加请求头 X-Trellis-Async: 1 → 返回 202 {id, poll}；轮询 GET /v1/jobs/{id}（间隔 5–10s）。

请求参数：

参数类型必填默认说明
modelstring是trellis-longcat-avatar固定 trellis-longcat-avatar
imagefile是—人像 / 首帧图
audiofile是—配音音频（wav）
promptstring否—可选提示词
resolutionstring否480p480p | 720p
num_segmentsinteger否—分段数（可选）
use_distillboolean否—是否用蒸馏加速（可选）

响应示例：

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