POST /suno/submit/music

Method: POSTEndpoint: /suno/submit/music

Request Body

Note: mv must be chirp-auk. task must be gen_stem stem_task must be two stem_type_group_name must be Two continue_clip_id is the clip_id from step A Can be used across accounts. Billing: one generation charge per task.

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

task
string
Required
generation_type
string
Required
title
string
Required
mv
string
Required
prompt
string
Required
make_instrumental
boolean
Required
continue_clip_id
string
Required
continued_aligned_prompt
null
Required
continue_at
null
Required
stem_type_id
integer
Required
stem_type_group_name
string
Required
stem_task
string
Required
Example
{
"task"
:
"string"
,
"generation_type"
:
"string"
,
"title"
:
"string"
,
"mv"
:
"string"
,
"prompt"
:
"string"
,
"make_instrumental"
:
true
,
"continue_clip_id"
:
"string"
,
"continued_aligned_prompt"
:
null
,
"continue_at"
:
null
,
"stem_type_id"
:
0
,
"stem_type_group_name"
:
"string"
,
"stem_task"
:
"string"
}

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 '{
    "task": "string",
    "generation_type": "string",
    "title": "string",
    "mv": "string",
    "prompt": "string",
    "make_instrumental": true,
    "continue_clip_id": "string",
    "continued_aligned_prompt": null,
    "continue_at": null,
    "stem_type_id": 0,
    "stem_type_group_name": "string",
    "stem_task": "string"
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{
    "clips": [
        {
            "id": "5f3587e2-75fb-4c36-84b3-3ec113897a4c",
            "video_url": "",
            "audio_url": "",
            "major_model_version": "",
            "model_name": "",
            "metadata": {
                "tags": "Chinese",
                "prompt": "Beneath that distant starry sky, who is still wandering in uncertainty?\nLike a fish that cannot swim, I can only blame myself for lacking strong fins.\nTurn hesitation into strength and setbacks into a guide.\nUntil the dream comes true, I will keep watch with resolve.\nYesterday has drifted away with time; tomorrow I will follow the wind and climb higher.\nCall out and let us set off, riding on the back of the dream dragon through the hardships of fate.\nBreak free from the restraints of hardship; even after losing everything, people still long for a warm embrace.\nThe reason people can feel the joy of others is the kindness of the heart.\nTurn hesitation into strength and setbacks into a guide.\nI am still that fish unable to swim, blaming myself for lacking strong fins.",
                "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
                "type": "stem",
                "duration": 217.24
            },
            "is_liked": false,
            "user_id": "58387c47-dc80-466f-a7b1-a2eed61c24fb",
            "display_name": "FluidXylophone2289",
            "handle": "fluidxylophone2289",
            "is_handle_updated": false,
            "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
            "is_trashed": false,
            "created_at": "2024-12-25T16:51:36.619Z",
            "status": "queued",
            "title": "Riding on the Back of the Dream Dragon - Vocals",
            "play_count": 0,
            "upvote_count": 0,
            "is_public": false
        },
        {
            "id": "9c85d619-4cac-4561-8fa3-604c116fa1c5",
            "video_url": "",
            "audio_url": "",
            "major_model_version": "",
            "model_name": "",
            "metadata": {
                "tags": "Chinese",
                "prompt": "",
                "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
                "type": "stem",
                "duration": 217.24
            },
            "is_liked": false,
            "user_id": "58387c47-dc80-466f-a7b1-a2eed61c24fb",
            "display_name": "FluidXylophone2289",
            "handle": "fluidxylophone2289",
            "is_handle_updated": false,
            "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
            "is_trashed": false,
            "created_at": "2024-12-25T16:51:36.625Z",
            "status": "queued",
            "title": "Riding on the Back of the Dream Dragon - Instrumental",
            "play_count": 0,
            "upvote_count": 0,
            "is_public": false
        }
    ]
}