API 文档 / Trellis 混音（人声 + 伴奏）
API 文档 · Trellis 混音（人声 + 伴奏）
模型 ID：trellis-mix
接口
POST /v1/mixmultipart/form-data提交混音任务GET /v1/jobs/{id}查询任务状态与结果POST /v1/jobs/{id}/cancel取消任务（canceling → canceled；不计费）调用方式
同步：直接 POST 返回结果（建议超时 1800s）；超时后请勿自动重试。
异步（推荐）：POST 加请求头
X-Trellis-Async: 1 → 返回 202 {id, poll}；轮询 GET /v1/jobs/{id}（间隔 5–10s）。请求参数：
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | 是 | trellis-mix | 固定 trellis-mix |
vocal | file | 是 | — | 人声 |
accompaniment | file | 否 | — | 伴奏（可选） |
format | string | 否 | wav | 输出格式 wav/mp3/flac（可选） |
响应示例：
{ "url": "/v1/files/mix/<name>.wav", "usage": { "seconds": 18.03 } }所有模型共用同一 API Key 与同一端点：
https://api.trellis.hk/v1