跳转到主要内容
POST

Authorizations

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

Body

model
string
默认值:"suno"
音频模型。当前传 suno(不传默认 suno)。
version
string
默认值:"v5.5"
生成版本:仅 v5 / v5.5,不传默认 v5.5
prompt
string
必填
音效文本描述(映射为上游 sound);缺失时提交期直接返回 400(不打上游、不扣费)。
type
string
默认值:"one-shot"
音效类型:one-shot(默认,单次)/ loop(可循环)。
bpm
integer
速度,1300;超出范围提交期直接返回 400
key
string
调性枚举:大调 C / C# / D / D# / E / F / F# / G / G# / A / A# / B;小调在后面加 mCm / C#m / … / Bm)。仅支持升号(#)写法,降号(Db / Eb 等)与 B# 会返回 400(key param error)。
获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 statuscompletedfailed(生成中为 pendingprogress 排队 10 → 就绪 50 → 完成 100)。完成后在 data.result.music[]audio_url。失败时 data.error.message 为原因,自动退回预扣额度。

Response

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