跳转到主要内容
POST
引用源音轨:本端点不走 task_id + audio_index,需直接给一个可公开访问的 audio_url(上游据此提取音色)。缺失会返回 400 audio_url cannot be empty
本端点无版本维度:不要传 version——传了会被丢弃、也不影响计费。

Authorizations

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

Body

model
string
默认值:"suno"
音频模型。当前传 suno(不传默认 suno)。
audio_url
string
必填
源音轨的公网可访问 URL,上游据此提取音色。仅接受 MP3 / WAV。 缺失返回 400 audio_url cannot be empty
获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 statuscompletedfailed(通常 30–120s;生成中 statuspendingprogress 排队 10 → 就绪 50 → 完成 100)。结果里含创建的音色信息。失败时 data.error.message 给出原因,且预扣额度自动退回。

Response

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