跳转到主要内容
POST
本端点无版本维度:不要传 version,传了会被丢弃,也不影响计费。
已知限制:不要上传**纯器乐(无人声)**音频,上游可能解析失败。

Authorizations

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

Body

model
string
默认值:"suno"
音频模型。当前传 suno(不传默认 suno)。
audioFilePath
string
必填
公网可访问的音频直链;缺失时提交期直接返回 400(不打上游、不扣费)。
获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 statuscompletedfailed(生成中为 pendingprogress 排队 10 → 就绪 50 → 完成 100)。完成后用本任务 task_id + audio_index=1 作为其它操作的源。失败时 data.error.message 为原因,自动退回预扣额度。

Response

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