Generate music clip

Request

Header Params

Authorization

string

required

Example:

Bearer {{api-key}}

Body Params application/json

prompt

string

required

Lyrics (for Custom Mode)

tags

string

required

Style tags (customization mode only)

mv

enum<string>

required

Version number

Allowed values:

chirp-v3.0chirp-v3.5chirp-v4chirp-auk

title

string

required

Title (for custom mode)

make_instrumental

string

required

If or not generate pure music, true for generate pure music.

notify_hook

string

required

Callback address: https://xxxxxxx

gpt_description_prompt

string

required

Inspiration Mode Cue (for Inspiration Mode)

task

string

required

Required for uploading

continue_at

string

required

float, the duration of the song, in seconds.

continue_clip_id

string

required

id of the song, which song needs to be extended

task_id

string

required

task id, used to reopen the previous task.

negative_tags

string

required

Excluded style tags

Example

1. Inspiration Mode

{
    “gpt_description_prompt": ”cat”
}

2.Customization Mode
{
    “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. Continued
{
    “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”, // can be empty ””
    “tags": ‘bass-driven atmospheric heavy metal’.
    “negative_tags": ‘dance’, ‘mv’: ‘chir’.
    “mv": ‘chirp-v4’, // upload followed by chirp-v4-upload
    “title": ‘City Lights’, ‘task_id’: ‘task_id’: ‘City Lights’, // uploaded as follows
    
    “continue_clip_id": ‘736a6f88-bd29-4b1e-b110-37132a5325ac_1’, // Fill in the id at the end with the serial number, not the clip_id.
    “continue_at": 80, // fill in the ending id with the serial number, not clip_id
    “task": ”extend” 
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.cometapi.com/suno/submit/music' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '1. Inspiration Mode

{
    “gpt_description_prompt": ”cat”
}

2.Customization Mode
{
    “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. Continued
{
    “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”, // can be empty ””
    “tags": ‘bass-driven atmospheric heavy metal’.
    “negative_tags": ‘dance’, ‘mv’: ‘chir’.
    “mv": ‘chirp-v4’, // upload followed by chirp-v4-upload
    “title": ‘City Lights’, ‘task_id’: ‘task_id’: ‘City Lights’, // uploaded as follows
    
    “continue_clip_id": ‘736a6f88-bd29-4b1e-b110-37132a5325ac_1’, // Fill in the id at the end with the serial number, not the clip_id.
    “continue_at": 80, // fill in the ending id with the serial number, not clip_id
    “task": ”extend” 
}'

Responses

🟢200Successful Response

application/json

Body

code

string

required

API response status code

message

string

required

Prompt message

data

string

required

Return data

Example

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