跳转到主要内容
POST

Authorizations

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

Body

model
string
默认值:"suno"
音频模型。当前传 suno(不传默认 suno)。
audio_urls
array
必填
1–4 个可公开访问的音频 URL 数组。
version
string
默认值:"v5.5"
生成版本:v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5,影响音质与计费;不传默认 v5.5
prompt
string
歌词 / 内容。
title
string
标题。
tags
string
风格标签。
negative_tags
string
排除的风格标签。
style_weight
number
风格权重,0.001.00
weirdness_constraint
number
创意度权重,0.001.00(别名 weirdness)。
audio_weight
number
音频权重,0.001.00
vocal_gender
string
人声性别:Male / Female
auto_lyrics
boolean
true=对输入歌词进行二次创作。
获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 statuscompletedfailed(音乐生成通常 30–120s;生成中为 pendingprogress 排队 10 → 就绪 50 → 完成 100)。完成后在 data.result.music[]audio_url。失败时 data.error.message 为原因,自动退回预扣额度。

Response

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