After creating a task, you need to use the task ID to poll the query interface to check the task's progress and results. Below are three different creation modes:
{"prompt":"Creation prompt","title":"Song title","tags":"Style1,Style2,Style3","make_instrumental":true/false,"mv":"chirp-v3-5-upload","task":"extend","task_id":"Original task ID","continue_at":120.00,"continue_clip_id":"Original song ID"}
Features:
Supports continuing creation based on an existing song.
Allows specifying the starting time point for continuation.
Supports uploading custom audio for continuation.
Maintains stylistic consistency.
Request
Header Params
Content-Type
string
required
Example:
application/json
Accept
string
required
Example:
application/json
Authorization
string
optional
Example:
Bearer {{YOUR_API_KEY}}
Body Params application/json
prompt
string
required
Lyrics content, only used in Custom Mode
mv
string
required
Model selection, options are chirp-v3-0 and chirp-v3-5, default is chirp-v3-0
title
string
required
Song title, only used in Custom Mode
tags
string
required
Style tags, only used in Custom Mode. Multiple tags should be separated by commas (half-width)
make_instrumental
boolean
required
Whether to generate an instrumental version. true indicates instrumental generation
task_id
string
required
Task ID, used to operate on existing tasks (e.g., continuation)
continue_at
number
required
Starting time point for continuation, as a float in seconds
continue_clip_id
string
required
ID of the song to be continued
gpt_description_prompt
string
required
Creation description prompt, only used in Inspiration Mode
notify_hook
string
required
Callback notification URL for task completion
Example
{"prompt":"[Verse]\nLights are flashing\nIt's so bright (ooh-yeah!)\nFeel the rhythm\nGroove all night (ooh-yeah!)\nMove your body\nFeel alive\nDance it out\nLet’s all arrive\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)\n\n[Verse 2]\nBass is pumping\nHands are high (hands are high!)\nMusic lifts us to the sky (to the sky!)\nKeep it going\nDon’t look back\nIn the night\nWe’re on track\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)\n\n[Bridge]\nFeel the magic\nIn your soul (soul!)\nLose control\nLet it roll (roll!)\nWhere the night will take us\nWho knows?\nBut we’ll dance till the moon blows\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)","tags":"emotional punk","mv":"chirp-v4","title":"City Lights"}
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl--location--request POST '/suno/submit/music' \
--header'Accept: application/json' \
--header'Authorization: Bearer {{YOUR_API_KEY}}' \
--header'Content-Type: application/json' \
--data-raw'{
"prompt": "[Verse]\nLights are flashing\nIt'\''s so bright (ooh-yeah!)\nFeel the rhythm\nGroove all night (ooh-yeah!)\nMove your body\nFeel alive\nDance it out\nLet’s all arrive\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)\n\n[Verse2]\nBass is pumping\nHands are high (hands are high!)\nMusic lifts us to the sky (to the sky!)\nKeep it going\nDon’t look back\nIn the night\nWe’re on track\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)\n\n[Bridge]\nFeel the magic\nIn your soul (soul!)\nLose control\nLet it roll (roll!)\nWhere the night will take us\nWho knows?\nBut we’ll dance till the moon blows\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)",
"tags": "emotional punk",
"mv": "chirp-v4",
"title": "City Lights"
}'
