Trellis AITrellis AI
API 指南 / Trellis 歌声合成（DiffSinger）

API 指南 · Trellis 歌声合成（DiffSinger）

歌词 + 音符（MIDI）→ 歌声（SVS）。按次计费。

调用方式
同步：直接 POST 返回结果（建议超时 1800s）；超时后请勿自动重试。
异步（推荐）：POST 加请求头 X-Trellis-Async: 1 → 返回 202 {id, poll}；轮询 GET /v1/jobs/{id}（间隔 5–10s）。

以 JSON 提交：notes（数组，每项 {midi, dur, lyric, lang, slur}）；可选 gender、velocity、depth、steps。

返回 url（/v1/files/svs/<name>.wav）与 usage（seconds、n_frames、phonemes、ph_dur）。

调用示例：

cURL
curl https://api.trellis.hk/v1/sing \
  -H "Authorization: Bearer sk-xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"model":"trellis-svs","notes":[{"midi":60,"dur":40,"lyric":"你","lang":"zh"},{"midi":62,"dur":40,"lyric":"好","lang":"zh"}]}'
查看 API 文档模型信息与价格
所有模型共用同一 API Key 与同一端点：https://api.trellis.hk/v1