跳转到主要内容
POST
引用源音轨:基于已有歌曲的操作无需记任何上游 id,只需传 task_id(产出源音轨那次任务的我方 task_id)+ audio_index(结果 music[] 里第几首,1-based,默认 1)。
本端点无版本维度:不要传 version——传了会被丢弃、也不影响计费。

Authorizations

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

Body

model
string
默认值:"suno"
音频模型。当前传 suno(不传默认 suno)。
task_id
string
必填
产出源音轨那次任务的我方 task_id。缺失或无法解析源时提交期直接返回 400
audio_index
integer
默认值:"1"
引用源任务结果 data.music[] 中的第几首(1-based;默认 1;一次生成通常 2 首:索引 1 与 2)。
duration_s
integer
必填
淡出时长(秒;映射上游 fade_time_s)。缺失直接返回 400,不打上游。
title
string
默认值:"Untitled"
标题(默认 Untitled)。
获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 statuscompletedfailed(通常 30–120s;生成中 statuspendingprogress 排队 10 → 就绪 50 → 完成 100)。完成后从 data.result.music[] 取处理后的 audio_url。失败时 data.error.message 给出原因,且预扣额度自动退回。

Response

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