Provider Notes

A. Generate music

You can generate music through scenarios 1, 2, or 3 and use a resulting clip_id such as 54834687-5e79-4f08-8e14-cf188f15b598.

Provider Notes

post /suno/persona/create/

clip_id must already exist in the system and cannot come from uploader. Cannot be used across accounts, so it may fail if the original account is unavailable. This section contains endpoint-specific behavior, parameters, or usage notes for this API. Request Body

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

The key field in the response body is the id fd213afd-ac1c-4822-9802-c1c0ea45e77b. Use it as persona_id in the next step.

{
"id": "fd213afd-ac1c-4822-9802-c1c0ea45e77b",
"name": "food",
"description": "123",
"root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
"clip": {
"id": "54834687-5e79-4f08-8e14-cf188f15b598",
"video_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp4",
"audio_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp3",
"image_url": "https://cdn2.suno.ai/image_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
"image_large_url": "https://cdn2.suno.ai/image_large_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
"major_model_version": "v4",
"model_name": "chirp-v4",
"metadata": {
"tags": "electronic pop, tropical house fusion",
"prompt": "",
"type": "gen",
"duration": 190,
"refund_credits": false,
"stream": true
},
"is_liked": false,
"user_id": "21de6d0f-398c-467c-9957-8fa9065f3ca6",
"display_name": "SensoryRecorders4685",
"handle": "sensoryrecorders4685",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
"is_trashed": false,
"created_at": "2024-12-23T10:34:30.144Z",
"status": "complete",
"title": "noks noko wane",
"play_count": 0,
"upvote_count": 0,
"is_public": false
},
"user_display_name": "SensoryRecorders4685",
"user_handle": "sensoryrecorders4685",
"user_image_url": "https://cdn1.suno.ai/defaultPink.webp",
"persona_clips": [
{
"clip": {
"id": "54834687-5e79-4f08-8e14-cf188f15b598",
"video_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp4",
"audio_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp3",
"image_url": "https://cdn2.suno.ai/image_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
"image_large_url": "https://cdn2.suno.ai/image_large_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
"major_model_version": "v4",
"model_name": "chirp-v4",
"metadata": {
"tags": "electronic pop, tropical house fusion",
"prompt": "",
"type": "gen",
"duration": 190,
"refund_credits": false,
"stream": true
},
"is_liked": false,
"user_id": "21de6d0f-398c-467c-9957-8fa9065f3ca6",
"display_name": "SensoryRecorders4685",
"handle": "sensoryrecorders4685",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
"is_trashed": false,
"created_at": "2024-12-23T10:34:30.144Z",
"status": "complete",
"title": "noks noko wane",
"play_count": 0,
"upvote_count": 0,
"is_public": false
},
"id": 11288925
}
]
}

Provider Notes

post /suno/generate

Note: mv must be chirp-v3-5-tau or chirp-v4-tau. task must be artist_consistency persona_id is obtained in step B artist_clip_id is the clip_id from step A Can be used across accounts.

{
"prompt": "[Verse]\nYou stay with me from dawn to dusk\nAlways by my side, always warm\nWe do not fear the wind or rain\nHolding hands and never parting\n\n[Verse 2]\nWith you here I am never alone\nLike countless stars in the night\nNo road feels too long\nBecause you are my light\n\n[Chorus]\nMy love, I love you\nYou are the only one in my world\nNo matter how far the horizon may be\nMy heart follows you like a shadow\n\n[Verse 3]\nYou are my safe harbor\nEvery night's dream is filled with you\nEven when the road ahead is hard\nEverything is more beautiful with you\n\n[Chorus]\nMy love, I love you\nYou are the only one in my world\nNo matter how far the horizon may be\nMy heart follows you like a shadow\n\n[Bridge]\nEvery moment in life\nIs felt with you beside me\nEvery tomorrow becomes better\nBecause with you I am unstoppable",
"generation_type": "TEXT",
"tags": "electronic, pop",
"negative_tags": "",
"mv": "chirp-v4-tau",
"title": "My Love",
"task": "artist_consistency",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}

Response Body

{
"id": "2d453a5f-c539-4fe0-9a66-24058c5dfb6a",
"clips": [
{
"id": "0e6937df-64d8-41f9-82c6-b6dadc4426a8",
"video_url": "",
"audio_url": "",
"major_model_version": "v4",
"model_name": "chirp-v4",
"metadata": {
"tags": "electronic, pop",
"prompt": "[Verse]\nYou stay with me from dawn to dusk\nAlways by my side, always warm\nWe do not fear the wind or rain\nHolding hands and never parting\n\n[Verse 2]\nWith you here I am never alone\nLike countless stars in the night\nNo road feels too long\nBecause you are my light\n\n[Chorus]\nMy love, I love you\nYou are the only one in my world\nNo matter how far the horizon may be\nMy heart follows you like a shadow\n\n[Verse 3]\nYou are my safe harbor\nEvery night's dream is filled with you\nEven when the road ahead is hard\nEverything is more beautiful with you\n\n[Chorus]\nMy love, I love you\nYou are the only one in my world\nNo matter how far the horizon may be\nMy heart follows you like a shadow\n\n[Bridge]\nEvery moment in life\nIs felt with you beside me\nEvery tomorrow becomes better\nBecause with you I am unstoppable",
"type": "gen",
"stream": true,
"has_vocal": false,
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task": "artist_consistency"
},
"is_liked": false,
"user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
"display_name": "TwinklingVenue1595",
"handle": "twinklingvenue1595",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
"is_trashed": false,
"created_at": "2024-12-23T10:37:43.596Z",
"status": "submitted",
"title": "My Love",
"play_count": 0,
"upvote_count": 0,
"is_public": false
},
{
"id": "fff58de4-7ccc-4b95-937b-3b66ec07cc65",
"video_url": "",
"audio_url": "",
"major_model_version": "v4",
"model_name": "chirp-v4",
"metadata": {
"tags": "electronic, pop",
"prompt": "[Verse]\nYou stay with me from dawn to dusk\nAlways by my side, always warm\nWe do not fear the wind or rain\nHolding hands and never parting\n\n[Verse 2]\nWith you here I am never alone\nLike countless stars in the night\nNo road feels too long\nBecause you are my light\n\n[Chorus]\nMy love, I love you\nYou are the only one in my world\nNo matter how far the horizon may be\nMy heart follows you like a shadow\n\n[Verse 3]\nYou are my safe harbor\nEvery night's dream is filled with you\nEven when the road ahead is hard\nEverything is more beautiful with you\n\n[Chorus]\nMy love, I love you\nYou are the only one in my world\nNo matter how far the horizon may be\nMy heart follows you like a shadow\n\n[Bridge]\nEvery moment in life\nIs felt with you beside me\nEvery tomorrow becomes better\nBecause with you I am unstoppable",
"type": "gen",
"stream": true,
"has_vocal": false,
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task": "artist_consistency"
},
"is_liked": false,
"user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
"display_name": "TwinklingVenue1595",
"handle": "twinklingvenue1595",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
"is_trashed": false,
"created_at": "2024-12-23T10:37:43.596Z",
"status": "submitted",
"title": "My Love",
"play_count": 0,
"upvote_count": 0,
"is_public": false
}
],
"metadata": {
"tags": "electronic, pop",
"prompt": "[Verse]\nYou stay with me from dawn to dusk\nAlways by my side, always warm\nWe do not fear the wind or rain\nHolding hands and never parting\n\n[Verse 2]\nWith you here I am never alone\nLike countless stars in the night\nNo road feels too long\nBecause you are my light\n\n[Chorus]\nMy love, I love you\nYou are the only one in my world\nNo matter how far the horizon may be\nMy heart follows you like a shadow\n\n[Verse 3]\nYou are my safe harbor\nEvery night's dream is filled with you\nEven when the road ahead is hard\nEverything is more beautiful with you\n\n[Chorus]\nMy love, I love you\nYou are the only one in my world\nNo matter how far the horizon may be\nMy heart follows you like a shadow\n\n[Bridge]\nEvery moment in life\nIs felt with you beside me\nEvery tomorrow becomes better\nBecause with you I am unstoppable",
"type": "gen",
"stream": true,
"has_vocal": false,
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task": "artist_consistency"
},
"major_model_version": "v4",
"status": "complete",
"created_at": "2024-12-23T10:37:43.581Z",
"batch_size": 1
}```