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
Body Params application/json
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 Code 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"
}'
