POST /suno/submit/music

Method: POSTEndpoint: /suno/submit/music

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
mv
string
Required
title
string
Required
tags
string
Required
continue_at
integer
Required
continue_clip_id
string
Required
task
string
Required
make_instrumental
boolean
Required
Example
{
"prompt"
:
"string"
,
"mv"
:
"string"
,
"title"
:
"string"
,
"tags"
:
"string"
,
"continue_at"
:
0
,
"continue_clip_id"
:
"string"
,
"task"
:
"string"
,
"make_instrumental"
:
true
}

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": "string",
    "mv": "string",
    "title": "string",
    "tags": "string",
    "continue_at": 0,
    "continue_clip_id": "string",
    "task": "string",
    "make_instrumental": true
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{
    "clips": [
        {
            "allow_comments": true,
            "audio_url": "",
            "avatar_image_url": "https://cdn1.suno.ai/sAura18.jpg",
            "created_at": "2025-04-29T07:37:05.071Z",
            "display_name": "49939i275",
            "entity_type": "song_schema",
            "flag_count": 0,
            "handle": "49939i275",
            "id": "8a8e6c85-5929-4e7a-8006-04fbf65860cd",
            "is_handle_updated": false,
            "is_liked": false,
            "is_public": false,
            "is_trashed": false,
            "major_model_version": "v4",
            "metadata": {
                "can_remix": true,
                "free_quota_category": "web_v4_gen",
                "gpt_description_prompt": "cat dance",
                "is_remix": false,
                "priority": 0,
                "prompt": "cat dance",
                "stream": true,
                "type": "gen"
            },
            "model_name": "chirp-v4",
            "play_count": 0,
            "status": "submitted",
            "title": "",
            "upvote_count": 0,
            "user_id": "319f7ad1-8893-489b-9316-ee58f8558476",
            "video_url": ""
        },
        {
            "allow_comments": true,
            "audio_url": "",
            "avatar_image_url": "https://cdn1.suno.ai/sAura18.jpg",
            "created_at": "2025-04-29T07:37:05.071Z",
            "display_name": "49939i275",
            "entity_type": "song_schema",
            "flag_count": 0,
            "handle": "49939i275",
            "id": "2a0bb020-a051-4ead-bf8a-d8491afc5039",
            "is_handle_updated": false,
            "is_liked": false,
            "is_public": false,
            "is_trashed": false,
            "major_model_version": "v4",
            "metadata": {
                "can_remix": true,
                "free_quota_category": "web_v4_gen",
                "gpt_description_prompt": "cat dance",
                "is_remix": false,
                "priority": 0,
                "prompt": "cat dance",
                "stream": true,
                "type": "gen"
            },
            "model_name": "chirp-v4",
            "play_count": 0,
            "status": "submitted",
            "title": "",
            "upvote_count": 0,
            "user_id": "319f7ad1-8893-489b-9316-ee58f8558476",
            "video_url": ""
        }
    ],
    "id": "1d30e8a5-b8d9-490b-b3f0-dc325daf6bd5",
    "status": "complete"
}