POST /suno/submit/music

Method: POSTEndpoint: /suno/submit/music

POST /suno/submit/music

A. Generate music

This section contains endpoint-specific behavior, parameters, or usage notes for this API.

POST /suno/submit/music

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.

POST /suno/submit/music

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.

Request Parameters

Header Parameters

accept
string
Optional
Example:
*/*
content-type
string
Required
Example:
application/json
Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json

prompt
string
Required
generation_type
string
Required
tags
string
Required
negative_tags
string
Required
mv
string
Required
title
string
Required
task
string
Required
persona_id
string
Required
artist_clip_id
string
Required
Example
{
"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"
:
  // provider-specific example normalized for English documentation
,
"task"
:
"artist_consistency"
,
"persona_id"
:
"0f6e8077-a7ba-4fc8-8f60-de02c66e56ce"
,
"artist_clip_id"
:
"a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}

Example Request

Shell

curl --location --request POST '/suno/submit/music' \
--header 'accept: */*' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'content-type: application/json' \
--data-raw '{
  "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

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{
    "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
}