生成歌曲(灵感、自定义、续写)
POST
{{BASE_URL}}/suno/submit/music最后修改时间: 2 天前
任务创建成功后,请通过 task id 轮询查询接口,获取任务进度和结果
分为3种模式
灵感模式:
只需要提交以下参数
gpt_description_prompt
make_instrumental
mv
Suno 会自动生成 歌词、标题、风格标签自定义模式:
需要提交参数
prompt
title
tags
make_instrumental
mv
3.续写
需要在自定义模式基础上携带
task_id
continue_at
continue_clip_id
上传音频后续写,参数修改
"mv": "chirp-v3-5-upload",
"task": "extend"
请求参数
Header 参数
Authorization
string
可选
示例值:
Bearer {{YOUR_API_KEY}}
Content-Type
string
可选
示例值:
application/json
Accept
string
可选
示例值:
application/json
Body 参数application/json
prompt
string
可选
歌词 (自定义模式专用)
mv
string
可选
mv模型,chirp-v3-0、chirp-v3-5。不写默认 chirp-v3-0
title
string
可选
标题(自定义模式专用)
tags
string
可选
风格标签(自定义模式专用)
make_instrumental
boolean
可选
是否生成纯音乐,true 为生成纯音乐
task_id
string
可选
任务id,用于对之前的任务再操作
continue_at
number
可选
float,歌曲延长时间,单位秒
continue_clip_id
string
可选
歌曲id,需要续写哪首歌
gpt_description_prompt
string
可选
灵感模式提示词(灵感模式专用)
notify_hook
string
可选
回调地址: https://xxxxxxx
示例
{
"prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
"tags": "emotional punk",
"mv": "chirp-v4",
"title": "City Lights"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
string
必需
message
string
错误信息
data
string
task_id
示例
{
"code": "success",
"message": "",
"data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}
最后修改时间: 2 天前