API 指南 / Trellis 伴奏渲染（MIDI / FluidSynth）

API 指南 · Trellis 伴奏渲染（MIDI / FluidSynth）

ABC / MIDI 曲谱 → 伴奏音频（确定性渲染，同谱同声）。按次计费。

调用方式

同步：直接 POST 返回结果（建议超时 1800s）；超时后请勿自动重试。

异步（推荐）：POST 加请求头 X-Trellis-Async: 1 → 返回 202 {id, poll}；轮询 GET /v1/jobs/{id}（间隔 5–10s）。

以 multipart/form-data 提交：abc（ABC 曲谱文本）或 midi（文件）；可选 gain、transpose、soundfont。

音色库预设：soundfont 可传预设名 FluidR3_GM（默认）/ GeneralUser / MuseScore_General，或绝对路径；不传用默认。例如 -F soundfont=GeneralUser。

返回 url（/v1/files/midi/<name>.wav）与 midi_url（.mid）以及 usage.seconds。

确定性渲染：同一曲谱结果一致，可用于“同段落同曲谱”。

调用示例：

cURL

curl https://api.trellis.hk/v1/render \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -F model=trellis-midi -F $'abc=X:1\nT:demo\nM:4/4\nK:C\nCDEFGABc'

查看 API 文档模型信息与价格

所有模型共用同一 API Key 与同一端点：https://api.trellis.hk/v1