Suno Guide

{
"gpt_description_prompt": "Nostalgia"
}

{
"prompt": "[Verse]\nContinuous days have been busy\nEndless piles of files\nHiding dreams deep in drawers\nThe coffee cup has become cold\n\n[Verse 2]\nClock in to work at eight o'clock in the morning\nTired eyes are dull\nChatting among colleagues is meaningless\nJust looking forward to the time to run quickly\n\n[Chorus]\nThe shout of the boss at work\nOnly when it is done is it safe\nOnly when you work overtime can you make some money\nWhen will the dream come true\n\n[Verse 3]\nHave a bento during lunch time\nLook out the window and the sun is shining\nLife is so far away from your dreams\nThere are only desks and chairs in front of you\n\n[Bridge]\nThe boss's footsteps are like thunder\nMy heartbeat speeds up\nThere are a lot of files on the table\nThe complaining voice gradually disappears\n\n[Chorus]\nWork, work, boss's cry\nIt is safe when you have done it\nOnly by working overtime can you earn some money\nWhen will your dream come true?",
"mv": "chirp-v3-5",
"title": "work",
"tags": " edm"
}

{
"prompt": "",
"tags": "heavy metal",
"mv": "chirp-v3-5",
"title": "Beijing",
"continue_clip_id": null,
"continue_at": null,
"infill_start_s": null,
"infill_end_s": null
}

{
"gpt_description_prompt": "An anthem dance pop song about dancing all night long",
"mv": "chirp-v3-5",
"prompt": "",
"make_instrumental": true
}

{
"prompt": "lyrics",
"tags": "",
"negative_tags": "",
"mv": "chirp-v4",
"title": "title",
"continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"continue_at": 10,
"task": "upload_extend",
"task_id": "xxxxxx"
}

curl --request POST \
--url https://BASE_URL/suno/submit/concat \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"clip_id": "xxxxx",
"is_infill": false
}'

{
"prompt": "[Verse]\nContinuous days have been busy\nEndless piles of files\nHiding dreams deep in drawers\nThe coffee cup has become cold\n\n[Verse 2]\nClock in to work at eight o'clock in the morning\nTired eyes are dull\nChatting among colleagues is meaningless\nJust looking forward to the time to run quickly\n\n[Chorus]\nThe shout of the boss at work\nOnly when it is done is it safe\nOnly when you work overtime can you make some money\nWhen will the dream come true\n\n[Verse 3]\nHave a bento during lunch time\nLook out the window and the sun is shining\nLife is so far away from your dreams\nThere are only desks and chairs in front of you\n\n[Bridge]\nThe boss's footsteps are like thunder\nMy heartbeat speeds up\nThere are a lot of files on the table\nThe complaining voice gradually disappears\n\n[Chorus]\nWork, work, boss's cry\nIt is safe when you have done it\nOnly by working overtime can you earn some money\nWhen will your dream come true?",
"tags": "heavy metal",
"mv": "chirp-v3-5",
"title": "work",
"continue_clip_id": "abcd-1234-1234-1234-abd",
"continue_at": 30,
"task": "extend",
"task_id": "xxxxxx"
}

curl --request POST \
--url https://BASE_URL/suno/submit/concat \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"Clip_id": "Change-1234-1234-1234-one",
"is_infill": true
}'

{
"prompt": "[Verse]\nContinuous days have been busy\nEndless piles of files\nHiding dreams deep in drawers\nThe coffee cup has become cold\n\n[Verse 2]\nClock in to work at eight o'clock in the morning\nTired eyes are dull\nChatting among colleagues is meaningless\nJust looking forward to the time to run quickly\n\n[Chorus]\nThe shout of the boss at work\nOnly when it is done is it safe\nOnly when you work overtime can you make some money\nWhen will the dream come true\n\n[Verse 3]\nHave a bento during lunch time\nLook out the window and the sun is shining\nLife is so far away from your dreams\nThere are only desks and chairs in front of you\n\n[Bridge]\nThe boss's footsteps are like thunder\nMy heartbeat speeds up\nThere are a lot of files on the table\nThe complaining voice gradually disappears\n\n[Chorus]\nWork, work, boss's cry\nIt is safe when you have done it\nOnly by working overtime can you earn some money\nWhen will your dream come true?",
"tags": "rock, punk",
"mv": "chirp-v4-tau",
"title": "Work (Cover)",
"cover_clip_id": "abcd-1234-1234-1234-abd",
"task_id": "xxxxxx",
"task": "cover"
}

{
"task": "infill",
"generation_type": "TEXT",
"title": "The scale of missing-replace",
"tags": "Sorrow/Sad,Female Vocals,Mandarin",
"mv": "chirp-auk",
"prompt": ""The Scale of Longing" \n \nLyricist: A Guo Yiluo\nThe temperature of your running is engraved in the annual rings. \nEvery fallen leaf is calling for you\nBut it will break into mist when the wind blows. \nTidy up your guitar in the corner \nAll the rainy seasons are accumulated in the piano case,\nThe back of the rosewood is wet.\nIf you twist your thoughts into new strings,\nI'm afraid that they will break into\nthe echoes of the year at the first touch. \nTime is a video tape that goes backwards. \nThe deeper the night, the clearer your laughter comes. \nIf tears can water the time tunnel, \nI will cry my eyes into the sea. \nI will learn to breathe through my wounds. \nExhausted."
"metadata": {
"infill_lyrics": ". \nTidy up your guitar in the corner \nAll the rainy season has accumulated in the piano case, \nThe back of the rosewood is damp. \nIf you twist your thoughts into new strings, \nI'm afraid it will break into pieces at the first touch\nThe echo of the year"
  },
"continue_clip_id": "8a858961-8831-4423-8ffb-2dec096aea0a",
"continued_aligned_prompt": ""The Scale of Longing" \n \nLyricist: A Guo Yiluo\nThe temperature of your running is engraved in the annual rings. \nEvery fallen leaf is calling for you\nBut it will break into mist when the wind blows. \nOrganize your guitar in the corner \nAll the rainy season is accumulated in the piano case, \nThe back of the rosewood is wet. \nIf you twist your thoughts into new strings,\nI'm afraid it will break into pieces at the touch of a touch. \nThe echo of the past. \nThe deeper the night, the clearer your laughter comes. \nIf tears can water the time tunnel,\nI will cry into the sea when all the spring is related to you.\nI will continue to love you with all my heart. \nTidy up your guitar in the corner. \nIf you twist your thoughts into new strings, \nI'm afraid that they will break into pieces at the first touch. \nWhen all the spring is related to you, \nI will continue to love you with all my heart\n\n",
"infill_context_start_s": 3.48,
"infill_context_end_s": 109.96,
"infill_start_s": 33.48,
"infill_end_s": 79.96,
"infill_dur_s": 46.48
}

curl --request POST \
--url https://BASE_URL/suno/submit/concat \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"Clip_id": "Change-1234-1234-1234-one",
"is_infill": true
}'

{
"root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
"name": "Persona title",
"description": "Persona description",
"clips": ["54834687-5e79-4f08-8e14-cf188f15b598"],
"is_public": true
}

{
"prompt": "[Verse]\nYou are always warm by my side from early morning to dusk\nYou are not afraid of wind or rain\nHold tightly and never separate\n\n[Verse 2]\nWith you I am not alone\nJust like the stars at night\nNo matter how long the road is, it never feels far\nBecause you are my light\n\n[Chorus]\nHusband, I love you\nYou are the only one in the world\nNo matter where we are in the world\nOur hearts are always together like a shadow\n\n[Verse 3]\nYou are my safe haven\nEvery night I dream of you\nNo matter how hard the road ahead\nEverything is so beautiful with you\n\n[Chorus]\nHusband, husband, I love you\nYou are the only one in the world\nNo matter where I am in the world\nMy heart is always with you\n\n[Bridge]\nEvery moment of my life\nI have you by my side to experience\nAll tomorrows are better\nBecause of you I am invincible.",
"tags": "electronic, pop",
"mv": "chirp-v4-tau",
"title": "husband",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"task_id": "xxxxxx",
"task": "artist_consistency"
}

{
"task": "gen_stem",
"task_id": "e3f492cb-27d9-41b6-aa1d-bdf7f3781a61",
"title": "Safety String",
"mv": "chirp-auk",
"make_instrumental": true,
"continue_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"continued_aligned_prompt": null,
"continue_at": null,
"stem_type_id": 91,
"stem_type_group_name": "Two",
"stem_task": "two"
}

curl --request GET \
--url https://BASE_URL/suno/feed/{clip_id} \
--header 'Authorization: Bearer API_KEY' \

{
"aligned_words": [
    {
"word": "[Verse]\nWinter ",
"success": true,
"start_s": 8.38,
"end_s": 8.78,
"p_align": 0.982
    },
    {
"word": "winds ",
"success": true,
"start_s": 8.78,
"end_s": 9.54,
"p_align": 0.961
    },
    {
"word": "they ",
"success": true,
"start_s": 9.54,
"end_s": 9.93,
"p_align": 0.99
    },
    {
"word": "cut ",
"success": true,
"start_s": 9.93,
"end_s": 10.41,
"p_align": 0.998
    },
    {
"word": "so ",
"success": true,
"start_s": 10.41,
"end_s": 10.93,
"p_align": 0.996
    },
    {
"word": "deep\n",
"success": true,
"start_s": 10.93,
"end_s": 11.93,
"p_align": 0.997
    },
    ....
  ],
"waveform_data": [
    0.001, 0.00109, 0.04219, 0.03597, ....
  ],
"hoot_cer": 0.03556771545827633,
"is_streamed": false
}

{
"wav_file_url": "https://cdn1.suno.ai/a624123d-22cc-4d4d-bf28-78d312f61597.wav"
}

{
"mp4": "https://cdn1.suno.ai/a624123d-22cc-4d4d-bf28-78d312f61597.mp4"
}

{
"task": "gen_stem",
"task_id": "e3f492cb-27d9-41b6-aa1d-bdf7f3781a61",
"generation_type": "TEXT",
"title": "Safety String",
"mv": "chirp-auk",
"make_instrumental": true,
"continue_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"continued_aligned_prompt": null,
"continue_at": null,
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"stem_task": "twelve"
}

"id": "b19ee87f-574d-42c7-9761-df6aafc0fd9c",
"clips": [
    {
"id": "0e5be1db-4834-4890-acfb-2fea7fd24eb9",
"entity_type": "song_schema",
"video_url": "",
"audio_url": "",
"major_model_version": "",
"model_name": "chirp-stem",
"metadata": {
"prompt": "",
"history": [
          {
"id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"type": "gen",
"source": "web",
"infill": false,
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"stem_task": "twelve",
"stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc"
          }
        ],
"stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"stem_task": "twelve",
"stem_type_id": 91,
"stem_type_group_name": "Vocals",
"edited_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"type": "gen",
"stream": true,
"infill": false,
"task": "gen_stem",
"can_remix": true,
"is_remix": false,
"priority": 10
      },
"is_liked": false,
"user_id": "a8a4d117-d5aa-4a9f-ab5b-88cc2c2eb79d",
"display_name": "ugknurymt91r",
"handle": "ugknurymt91r",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/sAura20.jpg",
"is_trashed": false,
"flag_count": 0,
"created_at": "2025-06-06T11:22:30.753Z",
"status": "submitted",
"title": "Safety Chords (Vocals)",
"play_count": 0,
"upvote_count": 0,
"is_public": false,
"allow_comments": true
    },
    {
"more": "There are 24 things like this"
    }
  ],
"metadata": {
"prompt": "",
"history": [
      {
"id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"type": "gen",
"source": "web",
"infill": false,
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"stem_task": "twelve",
"stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc"
      }
    ],
"stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"stem_task": "twelve",
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"edited_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"type": "gen",
"stream": true,
"infill": false,
"task": "gen_stem",
"can_remix": true,
"is_remix": false,
"priority": 10
  },
"major_model_version": "",
"status": "complete",
"created_at": "2025-06-06T11:22:30.737Z",
"batch_size": 1
}

curl --request GET \
--url https://BASE_URL/suno/feed/{clip_id} \
--header 'Authorization: Bearer API_KEY' \

{
"prompt": "[Verse]\nI got a plate of dreams piled high\nA world of flavors I wanna try\nSpices dancing under the sky\nTaste buds soaring I won’t deny\n\n[Chorus]\nCrunch and sizzle sweet and sour\nEvery bite holds a little power\nBite by bite I’m feeling bold\nLife’s a buffet can’t be controlled\n\n[Verse 2]\nFrom tacos wrapped so tight with love\nTo noodles swimming skies above\nPizza slices like a dove\nFlying straight to my tastebud glove\n\n[Bridge]\nOh the crunch of chips so loud\nPopcorn popping in a cloud\nChocolate melting makes me proud\nIn this feast I’m unbowed\n\n[Chorus]\nCrunch and sizzle sweet and sour\nEvery bite holds a little power\nBite by bite I’m feeling bold\nLife’s a buffet can’t be controlled\n\n[Verse 3]\nSaucy rivers on a plate\nFlavors whispering don’t be late\nEvery meal’s a twist of fate\nI’ll devour till it’s too great",
"generation_type": "TEXT",
"tags": "house, tight drums",
"negative_tags": "Modern",
"mv": "chirp-auk",
"title": "Savor the Flavor",
"metadata": {
"create_mode": "custom",
"control_sliders": {
"style_weight": 0.4,
"weirdness_constraint": 0.7
    },
"can_control_sliders": ["weirdness_constraint", "style_weight"],
"vocal_gender": "f"
  }
}

{
"prompt": "[Verse]\nNew Year's bell rings\nFireworks light up the night\nLaughter spreads everywhere\nGood luck is with you\n\n[Chorus]\nHappy New Year is full of joy\nRed lights hang high and the streets are brilliant\nReunion and happiness bloom\nWishes come true\n\n[Verse 2]\nThe spring breeze blows gently\nWith auspicious flowers blooming\nNew clothes, new shoes and new expectations\nDreams unfold from now on\n\n[Chorus]\nHappy New Year and full of joy\nRed lights hang high and the streets are brilliant\nReunion, happiness and happiness bloom\nWishes come true\n\n[ Bridge]\nThe sound of firecrackers sounds\nWelcome new opportunities\nEvery household is happy\nThe rich flavor of the new year is conveyed\n\n[Chorus]\nHappy New Year is full of joy\nThe red lights are hung high and the streets are brilliant\nReunion, happiness and happiness are blooming\nWishes come true and the house is filled with happiness",
"generation_type": "TEXT",
"tags": "",
"negative_tags": "",
"mv": "chirp-auk",
"title": "Happy New Year (Remix)",
"task": "cover",
"cover_clip_id": "f31754fc-2c83-4fc1-8a07-70ae218dd0a6",
"metadata": {
"create_mode": "custom",
"control_sliders": {
"style_weight": 0.68,
"audio_weight": 0.48,
"weirdness_constraint": 0.37
    },
"can_control_sliders": [
"weirdness_constraint",
"style_weight",
"audio_weight"
    ],
"is_remix": true
  }
}

{
"mv": "chirp-bluejay",
"tags": "Pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
"title": "Hi Insterumental",
"underpainting_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"underpainting_start_s": 0,
"underpainting_end_s": 57.9,
"task": "underpainting",
"prompt": "",
"override_fields": ["prompt", "tags"]
}

{
"mv": "chirp-bluejay",
"tags": "A smooth, soulful R&B track with a moderate tempo and a relaxed, laid-back feel. The instrumentation features a clean electric guitar playing arpeggiated chords, a prominent bass guitar providing a walking bass line, and a drum kit with a soft, brushed snare sound. The male lead vocal is smooth and melodic, with a baritone range and a slightly melancholic tone. The song is in a minor key, contributing to its introspective mood. Production elements include a subtle reverb on the vocals and guitar, creating a spacious and intimate atmosphere. The song structure follows a typical verse-chorus format with a clear melodic progression.",
"title": "Hi vocal",
"overpainting_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"overpainting_start_s": 0,
"overpainting_end_s": 57.9,
"task": "overpainting",
"prompt": "You have to fill in the lyrics yourself",
"override_fields": ["prompt", "tags"]
}

curl --request GET \
--url https://BASE_URL/suno/act/midi/{clip_id} \
--header 'Authorization: Bearer API_KEY'

{
"state": "complete",
"instruments": [
        {
"name": "String Ensembles 1",
"notes": [
             {
"pitch": 60,
"start": 1.1041666666666667,
"end": 1.9583333333333333,
"velocity": 0.7165354330708661
                },
               ......
            ]

        },
        ......
    ]
}

curl --request POST \
--url https://BASE_URL/suno/act/tags \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{"original_tags": "student"}'

{
"upsampled_tags": "Laid-back indie pop driven by a clean guitar riff, tight bass, and crisp drums. Verses feature subtle synth textures and gentle background vocals. A catchy chorus lifts with layered harmonies and handclaps. Bridge introduces a bright Rhodes piano before a dynamic final chorus.",
"request_id": "507acd16-8b84-4e55-be2b-4329d82efb26"
}