chirp-aukPOST https://api.elkapi.com/suno/submit/musicGET https://api.elkapi.com/suno/fetch/{task_id}{
"gpt_description_prompt": "Nostalgia"
}{
"prompt": "[Verse]\nBusy days in a row\nFiles pile up endlessly\nHidden deep in the drawer\nCoffee cups are cold\n\n[Verse 2]\nPunching in for work at 8 a.m.\nTired eyes lack luster\nChatting with colleagues is meaningless\nJust hoping time will run quickly\n\n[Chorus]\nWork, work, the boss calls\nFinish, finish, finish, then you'll feel at peace\nWorking overtime to earn some money\nWhen will dreams come true\n[Verse 3]\nLunchtime lunch\nLooking out the window at the bright sunshine\nLife feels so far from my dreams\nAll I see is my desk and chair\n\n[Bridge]\nThe boss's footsteps rumble like thunder\My heartbeat accelerates with the rhythm\A pile of documents piles up on the desk\The complaints gradually fade away\n\n[Chorus]\nWork, work, the boss calls out\NOnly when I finish, do I feel at peace\NOnly when I work overtime can I earn some money\NWhen will my dream come true?
"mv": "chirp-auk",
"title": "Work",
"tags": "edm"
}{
"prompt": "",
"tags": "heavy metal",
"mv": "chirp-auk",
"title": "Beijing",
"continue_clip_id": null,
"continue_at": null,
"infill_start_s": null,
"infill_end_s": null
}{
"gpt_description_prompt": "A national anthem and dance pop song about dancing all night long",
"mv": "chirp-auk",
"prompt": "",
"make_instrumental": true
}clip_id value through the upload API.{
"prompt": "Lyrics",
"tags": "",
"negative_tags": "",
"mv": "chirp-v4",
"title": "Title",
"continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"continue_at": 10,
"task": "upload_extend"
}Note: The mv file here is chirp-auk-uploadorchirp-v4-upload
{
"prompt": "[Verse]\nBusy days in a row\nFiles pile up endlessly\nHidden dreams deep in a drawer\nCoffee cups are cold\n\n[Verse 2]\nClocking in at 8 a.m.\nTired eyes lack luster\nChatting with colleagues is meaningless\nJust hoping time will run quickly\n\n[Chorus]\nWork, work, the boss's call\nOnly peace after finishing work\nWorking overtime to earn some money\nWhen will the dream come true\n\n[Verse 3]\nLunchtime lunch\nLooking out the window at the bright sunshine\nLife feels so far from my dreams\nAll I see is my desk and chair\n\n[Bridge]\nThe boss's footsteps rumble like thunder\My heartbeat accelerates with the rhythm\A pile of documents piles up on the desk\The complaints gradually fade away\n\n[Chorus]\nWork, work, the boss calls out\nFinish, finish, finish, then I'll feel at peace\nWork overtime, overtime, then I'll earn some money\nWhen will my dream come true?
"tags": "heavy metal",
"mv": "chirp-auk-upload",
"title": "Work",
"continue_clip_id": "abcd-1234-1234-1234-abd",
"continue_at": 30.792
}Note: is_infillisfalse
Deduction: The cost of one song
POST https://api.elkapi.com/suno/submit/music/concatNote: This is for continuing officially generated music; custom music is not available.
clip_id value of one of the songs.clip_id, pick one{
"prompt": "[Verse]\nThe days are endless\nThe files are piled up endlessly\nHidden dreams are deep in the drawer\nThe coffee cup is cold\n\n[Verse 2]\nPunching in for work at 8 a.m.\nTired eyes are lifeless\nThe small talk among colleagues is meaningless\nJust hoping time will run quickly\n\n[Chorus]\nWork, work, the boss calls\nFinish, finish, finish, then I feel at peace\nWorking overtime to earn some money\nWhen will the dream come true\n\n[Verse 3]\nLunchtime lunch\nLooking out the window at the bright sunshine\nLife feels so far from my dreams\nAll I see is my desk and chair\n\n[Bridge]\nThe boss's footsteps rumble like thunder\My heartbeat accelerates with the rhythm\A pile of documents piles up on the desk\The complaints gradually fade away\n\n[Chorus]\nWork, work, the boss calls out\nFinish, finish, finish, then I'll feel at peace\nWork overtime, overtime, then I'll earn some money\nWhen will my dream come true?
"tags": "heavy metal",
"mv": "chirp-auk",
"title": "Work",
"continue_clip_id": "abcd-1234-1234-1234-abd",
"continue_at": 30,
"task": "extend"
}Note: is_infillisfalse
Deduction: 0.1
POST https://api.elkapi.com/suno/submit/music/concatclip_id value of one of the songs.clip_id through the upload interface, allowing you to cover custom audio.Note: mv must be chirp-v3-5-tau,chirp-v4-tau, orchirp-auktask must be coverThis can be used across accounts, eliminating the need to worry about account closures. cover_clip_idcannot be used across accounts if it is an uploadedclip_id.
{
"prompt": "[Verse]\nThe days have been busy\nThe files are piled up endlessly\nHidden dreams deep in the drawer\nThe coffee cup has gone cold\n\n[Verse 2]\nPunching in for work at 8am\nTired eyes without spirit\nChatting among colleagues is meaningless\nJust hoping time will pass\n\n[Chorus]\nWork, work, the boss's call\nOnly when I finish, I feel at peace\nWorking overtime, overtime, can I earn some money\nWhen will my dream, dream come true\n\n[Verse 3]\nEating a bento at lunchtime\nLooking out the window at the bright sunshine\nLife is so far from my dream\nAll I see is a desk and a chair\n\n[Bridge]\nThe boss's footsteps are like thunder\My heartbeat speeds up with the rhythm\nA pile of documents on the desk\The voices of complaints gradually fade away\n\n[Chorus]\nWork, work, the boss's call\nOnly when I finish, overtime, can I earn some money\nWhen will my dream, dream come true",
"generation_type": "TEXT",
"tags": "rock, punk",
"negative_tags": "",
"mv": "chirp-v4-tau",
"title": "Work (Cover)",
"continue_clip_id": null,
"continue_at": null,
"continued_aligned_prompt": null,
"infill_start_s": null,
"infill_end_s": null,
"task": "cover",
"cover_clip_id": "abcd-1234-1234-1234-abd"
}clip_id value of one of the songs.Note: task is infillmv is chirp-v3-5-tauorchirp-v4-tauorchirp-aukThe replacement lyrics should overlap with the original lyrics, and the corresponding time should match. infill_start_sis the start time,infill_end_sis the end time, andinfill_dur_sisinfill_end_s - infill_start_s.This can be used across accounts, so there's no need to worry about your account being offline. You will receive two new clip_ids; select one for the next step.
{
"task": "infill",
"generation_type": "TEXT",
"title": "Missing Scale - Replace",
"tags": "Sorrow/Sad, Female Vocals, Mandarin",
"mv": "chirp-auk",
"prompt": "《Missing Scale》 \n \n Lyrics: Aguo Yiluo\n The warmth of your running is engraved in the rings of the years. Every fallen leaf calls out for you, but the wind shatters them into mist. Tidying up your guitar in a corner, the case holds all the rainy seasons, dampening its rosewood back. If I were to wind longing into a new string, I'm afraid it would shatter into an echo of the past with a single touch. Time is a videotape running backwards, the deeper the night, the clearer your laughter reaches. If tears could flood the tunnel of time, I'd cry my eyes into an ocean. When all springtime is about you, I've learned to breathe through my wounds. I'll continue loving you, until I've exhausted myself.
"metadata": {
"infill_lyrics": ". Tidying up your guitar in a corner, the case holds all the rainy seasons, dampening its rosewood back. If I were to wind longing into a new string, I'm afraid it would shatter into an echo of the past with a single touch."
},
"continue_clip_id": "8a858961-8831-4423-8ffb-2dec096aea0a",
"continued_aligned_prompt": ""The Scale of Missing" \n \nLyrics: Aguo Yiluo\nThe warmth of your running is engraved in the annual rings. \nEvery fallen leaf calls out for you\nBut the wind shatters them into mist. \nTidying up your guitar in the corner \nThe guitar case holds all the rainy seasons, \nWetting the rosewood back. \nIf I were to wrap longing into new strings, \nI'm afraid a touch would shatter them into \nthe echoes of the past. \nTime is a videotape running backwards, \nThe deeper the night, the clearer your laughter becomes. \nIf tears could water the tunnel of time, \nI would cry my eyes into the sea. \nWhen all springs are about you, \nI learn to breathe through my wounds. \nContinue to love you, \nWith all my might \nA heartbeat that no longer beats. \nTidying up your guitar in the corner \nThe guitar case holds all the rainy seasons, The back of the rosewood is damp. If I were to wind my longing into a new string, I'm afraid it would shatter into the echoes of yesteryear at the slightest touch. When every spring is about you, I've learned to breathe through my wounds. I'll continue loving you, using all my strength, even in a heartbeat that no longer beats.
"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
}Note: is_infillistrueDeduction: 0.1
task id.task id, retrieve the corresponding clip_id value for the song as needed.Note:
Enter the correspondingclip_idparameter and enter it into this API. The returned ID will be used as the persona_id for the next step.clip_idmust exist in the system, not in the uploader.This cannot be used across accounts, so it may not work if the account is offline. A 0.1 deduction will be made to prevent abuse.
POST https://api.elkapi.com/suno/persona/create{
"root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
"name": "Persona Title",
"description": "Persona Description",
"clips": ["54834687-5e79-4f08-8e14-cf188f15b598"],
"is_public": true
}API: Create PersonaNotes:**mv is chirp-v3-5-tau,chirp-v4-tau, orchirp-auktask is artist_consistencypersona_idis the return ID from theCreate PersonaAPI stepartist_clip_id is the clip_id from the Generate MusicstepCross-account compatible
POST https://api.elkapi.com/suno/submit/music{
"prompt": "[Verse]\nFrom dawn to dusk\nYou are always by my side, keeping me warm\nUnfazed by wind and rain\nWith a tight grip, we never part\n\n[Verse 2]\nWith you I'm not alone\nJust like the stars in the night\nNo matter how long the road is, it doesn't seem far\nBecause you are my light\n\n[Chorus]\nHusband, husband, I love you\nYou are the only one in the world\nNo matter where we are\nMy heart is always with you\n\n[Verse 3]\nYou are my safe haven\nEvery night I dream of you\nNo matter how hard the road ahead\nWith you, everything is beautiful\n\n[Chorus]\nHusband, husband, I love you\nYou are the only one in the world\nNo matter where we are\nMy heart is always with me\n\n[Bridge]\nEvery moment of my life\nWith you by my side, I experience it\nEvery tomorrow will be better\nBecause I have you, I am invincible",
"generation_type": "TEXT",
"tags": "electronic, pop",
"negative_tags": "",
"mv": "chirp-v4-tau",
"title": "Husband",
"task": "artist_consistency",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}clip_id value for one of the songs.Note: mv is chirp-auktask is gen_stemstem_taskistwelvestem_type_group_nameisTwelvecontinue_clip_idis the same as theclip_idin step ACross-account compatible Billing: 5x the base price, 5 times the price for 10 songs
POST https://api.elkapi.com/suno/submit/music{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "Safety String",
"mv": "chirp-auk",
"prompt": "",
"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"
}clip_ids. Use the task ID to query.GET https://api.elkapi.com/suno/fetch/{task_id}clip_id value of one of the songs.Note: mv is chirp-auktask is gen_stemstem_taskistwostem_type_group_nameisTwocontinue_clip_idis the same as theclip_idin step ACross-account compatible Billing: Five generation fees
POST https://api.elkapi.com/suno/submit/music{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "Safety Chord",
"mv": "chirp-auk",
"prompt": "",
"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"
}GET https://api.elkapi.com/suno/fetch/{task_id}task_id and clip_id.clip_id obtained in the previous step to perform audio and music separation. The returned task_id is used to query the separation results.Note: The mvparameter ischirp-auk.The taskparameter isgen_stem.Fill continue_clip_idwith theclip_idreturned after uploading the music file in step A.stem_taskandstem_type_group_namedetermine the stemming type. The example shows a full-track stemming.This function works across multiple accounts. Billing: The cost is the same as for All-Stems(Scenario 10) orStems(Scenario 11).
{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "Upload Audio for Voice and Music Separation",
"mv": "chirp-auk",
"prompt": "",
"make_instrumental": true,
"continue_clip_id": "eeb77e7a-e2a5-4fb0-96b5-d6a27d5ab09c", // Replace with the clip_id obtained after uploading
"continued_aligned_prompt": null,
"continue_at": null,
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"stem_task": "twelve"
}task_id returned in step B to query the voice and music separation results.GET https://api.elkapi.com/suno/fetch/{task_id}clip_id value of one of the songs.Note: This works across accounts.
GET https://api.elkapi.com/suno/act/timing/{clip_id}clip_id value of one of the songs: a624123d-22cc-4d4d-bf28-78d312f61597Note: If the wav_file_urlreturn value is null, try retrieving it multiple times.To prevent abuse, a 0.1 deduction will be made. This function cannot be used across accounts and cannot be called after the account is offline.
GET https://api.elkapi.com/suno/act/wav/{clip_id}clip_id value of one of the songs. clip_id valueNote: Requires completestatus for execution to take effectAfter execution, the URL will be accessible 30 seconds later 0.1 will be deducted to prevent abuse Cannot be used across accounts or after an account is offline
GET https://api.elkapi.com/suno/act/mp4/{clip_id}weirdness_constraintstyle_weightaudio_weight (appears only when using a cover)POST https://api.elkapi.com/suno/submit/music{
"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"]
}
}audio_weight parameter will be present when creating a cover.POST https://api.elkapi.com/suno/submit/music{
"prompt": "[Verse]\nThe New Year bells ring\nFireworks illuminate the night\nLaughter spreads everywhere\nGood luck is with you\n\n[Chorus]\nHappy New Year, joy is overflowing\nRed lanterns hang high, the streets are brilliant\nReunion is full of happiness\nWishes come true, happiness fills the house\n\n[Verse 2]\nThe spring breeze blows gently\nBringing auspicious flowers\nNew clothes, new shoes, new expectations\nDreams begin from now on\n\n[Chorus]\nHappy New Year, joyful and cheerful\nRed lanterns hang high and the streets are brilliant\nReunion, happiness and blossoming\nWishes come true and the family is filled with happiness\n\n[Bridge]\nThe sound of firecrackers rings\nWedding a new opportunity\nEvery household is happy\nThe rich flavor of the New Year is transmitted\n\n[Chorus]\nHappy New Year, joyful and cheerful\nRed lanterns hang high and the streets are brilliant\nReunion, happiness and blossoming\nWishes come true and the family 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
}
}