Generate music

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Authorization

string

optional

Example:

Bearer

Body Params application/json

prompt

string

required

歌词 (自定义模式专用)

string

optional

版本号,填写chirp-v4或chirp-v3-5,当前默认为chirp-v3-5

title

string

optional

标题(自定义模式专用)

tags

string

optional

风格标签(自定义模式专用)

negative_tags

string

optional

排除的风格标签

make_instrumental

boolean

required

是否生成纯音乐，true 为生成纯音乐

task_id

string

optional

任务id，用于对之前的任务再操作

continue_at

number

optional

float，歌曲延长时间，单位秒

continue_clip_id

string

optional

歌曲id，需要续写哪首歌

task

string

optional

上传后续写必填

Example:

extend

gpt_description_prompt

string

optional

灵感模式提示词(灵感模式专用)

notify_hook

string

optional

回调地址： https://xxxxxxx

Example

1.灵感模式

{
    "gpt_description_prompt": "cat"
}

2.自定义模式
{
    "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"
}

3.续写
{
    "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": "bass-driven atmospheric heavy metal",
    "negative_tags": "dance",
    "mv": "chirp-v4", // 上传后续写 chirp-v4-upload
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac",
    "continue_clip_id": "736a6f88-bd29-4b1e-b110-37132a5325ac_1", // 填写结尾带序号的id，不是clip_id
    "continue_at": 80,
    "task": "extend" 
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/suno/submit/music' \
--header 'Authorization: Bearer' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '1.灵感模式

{
    "gpt_description_prompt": "cat"
}

2.自定义模式
{
    "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"
}

3.续写
{
    "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": "bass-driven atmospheric heavy metal",
    "negative_tags": "dance",
    "mv": "chirp-v4", // 上传后续写 chirp-v4-upload
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac",
    "continue_clip_id": "736a6f88-bd29-4b1e-b110-37132a5325ac_1", // 填写结尾带序号的id，不是clip_id
    "continue_at": 80,
    "task": "extend" 
}'

application/json

Body

code

string

required

message

string

required

data

string

required

task_id

Example

{
  "code": "success",
  "message": "",
  "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

Request

Request samples

Responses