API 文档 / Trellis 伴奏渲染（MIDI / FluidSynth）
API 文档 · Trellis 伴奏渲染（MIDI / FluidSynth）
模型 ID：trellis-midi
接口
POST /v1/rendermultipart/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-midi | 固定 trellis-midi |
abc | string | 否 | — | ABC 曲谱文本（与 midi 二选一） |
midi | file | 否 | — | MIDI 文件（与 abc 二选一） |
gain | number | 否 | — | 增益（可选） |
transpose | integer | 否 | — | 移调半音数（可选） |
soundfont | string | 否 | FluidR3_GM | 音色库：预设名 FluidR3_GM / GeneralUser / MuseScore_General，或绝对路径（可选） |
响应示例：
{ "url": "/v1/files/midi/<name>.wav", "midi_url": "/v1/files/midi/<name>.mid", "usage": { "seconds": 18.03 } }所有模型共用同一 API Key 与同一端点：
https://api.trellis.hk/v1