生成歌曲(灵感模式)
▼
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
请求参数
Header 参数
Content-Type
string
必需
示例: application/json
Accept
string
必需
示例: application/json
Authorization
string
可选
示例: Bearer {{YOUR_API_KEY}}
Body 参数 application/json
prompt
string
必需
歌词内容，仅用于自定义模式
mv
string
必需
模型选择，可选 chirp-v3-0、chirp-v3-5，默认为 chirp-v3-0
title
string
可选
歌曲标题，仅用于自定义模式
tags
string
可选
风格标签，仅用于自定义模式，多个标签用半角逗号分隔
make_instrumental
boolean
可选
是否生成纯音乐版本，true 表示生成纯音乐
task_id
string
可选
任务ID，用于对已有任务进行操作（如续写）
continue_at
number
可选
续写起始时间点，浮点数，单位为秒
continue_clip_id
string
可选
需要续写的歌曲ID
gpt_description_prompt
string
必需
创作描述提示词，仅用于灵感模式
notify_hook
string
可选
任务完成后的回调通知地址
示例
{
"gpt_description_prompt": "一首动听的情歌",
"make_instrumental": false,
"mv": "chirp-v4",
"prompt": "Cat Dance"
}请求示例代码
curl --location --request POST 'https://api.quickrouter.ai/suno/submit/music' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"gpt_description_prompt": "一首动听的情歌",
"make_instrumental": false,
"mv": "chirp-v4",
"prompt": "Cat Dance"
}'var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"gpt_description_prompt": "一首动听的情歌",
"make_instrumental": false,
"mv": "chirp-v4",
"prompt": "Cat Dance"
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.quickrouter.ai/suno/submit/music", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));import http.client
import json
conn = http.client.HTTPSConnection("api.quickrouter.ai")
payload = json.dumps({
"gpt_description_prompt": "一首动听的情歌",
"make_instrumental": False,
"mv": "chirp-v4",
"prompt": "Cat Dance"
})
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
conn.request("POST", "/suno/submit/music", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))返回响应
响应参数 🟢 200 OK · application/json
code
string
必需
data
string
必需
message
string
必需
示例
{
"code": "success",
"data": "950bf3af-78a6-420e-8c01-3bde0bbb3ef9",
"message": ""
}