API 文档 / Trellis 歌曲生成（YuE2·符号化）

API 文档 · Trellis 歌曲生成（YuE2·符号化）

模型 ID：trellis-yue2

接口

POST /v1/songmultipart/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-yue2	固定 trellis-yue2
`style`	string	是	—	风格描述（曲风 / 情绪 / 编曲 / 人声等）
`lyrics`	string	否	—	歌词，支持 [Verse]/[Chorus]/[Bridge]/[Outro] 段落标记
`cot`	string	否	full	full \| melody \| off（melody 配合 abc 锁定旋律）
`seed`	integer	否	-1	-1 为随机
`abc`	string	否	—	复用 / 编辑的 ABC 曲谱（来自上次返回的 score），实现同段落同曲谱

响应示例：

# 提交（异步）
{ "id": "<job>", "status": "queued" }

# 查询
{ "id": "<job>", "status": "completed",
  "url": "/v1/files/yue2/<name>.flac",
  "score_url": "/v1/files/yue2/<name>.abc",
  "score": "X:1\nT:Song\n...",
  "score_lyrics_url": "/v1/files/yue2/<name>_lyr.abc",
  "score_lyrics": "X:1\n...\nV: Vocal\n\"D\"z4F4A4|...\nw: * 机 房 的 灯 还 亮 着 一 盏|...",
  "truncated": false,
  "usage": { "seconds": 48.44, "cot": "full", "seed": 1234 } }

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