Skip to main content
POST
引用源音轨:基于已有歌曲的操作无需记任何额外 id,只需传 task_id(产出源音轨那次任务的 task_id)+ audio_index(结果 data.result.music[] 里第几首,1-based,默认 1)。
本端点无版本维度:不要传 version——传了会被丢弃、也不影响计费。
前提:concat 只能拼接 extend(续写)产生的分段结果。若源不是 extend 产物(如普通一次性生成的整首歌),提交期直接返回 400。
歌曲合成本身免费。生成前置续写片段所调用的 extend 接口会按其价格单独计费。

Authorizations

string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

string
默认值:"suno"
音频模型。当前传 suno(不传默认 suno)。
string
必填
源任务的 task_id——必须是 extend(续写)产生的分段(见上方 Warning)。缺失、非 extend 产物或无法解析源时,提交期直接返回 400。
integer
默认值:"1"
引用源任务结果 data.result.music[] 中的第几首(1-based;默认 1;一次生成通常 2 首:索引 1 与 2)。
string
输出音频格式:mp3 / m4a / wav。
源任务必须是 extend 或 extendMusic 的续写结果。本接口用于合成一条续写链,不是任意两首歌曲的拼接工具。
获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 status 为 completed 或 failed(通常 30–120s;生成中 status 可能为 pending 或 processing,progress 为 0–100 的整数且不保证按固定节点变化)。完成后从 data.result.music[] 取完整歌曲 audio_url。失败时 data.error.message 给出原因,且预扣额度自动退回。

Response

integer
响应状态码
array
返回数据数组