Trellis AITrellis AI
API 文档 / Trellis 歌声合成（DiffSinger）

API 文档 · Trellis 歌声合成（DiffSinger）

模型 ID：trellis-svs

接口

POST /v1/singapplication/json提交歌声合成任务
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）。

请求参数：

参数类型必填默认说明
modelstring是trellis-svs固定 trellis-svs
notesarray是—音符列表：{midi, dur, lyric, lang, slur}
gendernumber否—音色性别偏移（可选）
velocitynumber否—力度（可选）
depthnumber否—演唱风格深度（可选）
stepsinteger否—推理步数（可选）

响应示例：

{ "url": "/v1/files/svs/<name>.wav", "usage": { "seconds": 2.19, "n_frames": 189 } }
所有模型共用同一 API Key 与同一端点：https://api.trellis.hk/v1