Music Generation(generations)

Request

Body Params application/json

Example

{
    "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "tags": "heavy metal",
    "mv": "chirp-v3-5",
    "title": "Starry ",
    // "continue_clip_id": "2e584f32-7ae3-4b2d-93f6-391f65a01f15",
    // "continue_at": 48.762,
    "infill_start_s": null,
    "infill_end_s": null
}

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://gptproto.com/suno/generate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "tags": "heavy metal",
    "mv": "chirp-v3-5",
    "title": "Starry ",
    // "continue_clip_id": "2e584f32-7ae3-4b2d-93f6-391f65a01f15",
    // "continue_at": 48.762,
    "infill_start_s": null,
    "infill_end_s": null
}'

Responses

🟢200Success

application/json

Body

Example

{
    "clips": [
        {
            "allow_comments": true,
            "audio_url": "",
            "avatar_image_url": "https://cdn1.suno.ai/sAura9.jpg",
            "created_at": "2025-05-30T02:41:48.617Z",
            "display_name": "zndvchjxyy",
            "entity_type": "song_schema",
            "flag_count": 0,
            "handle": "zndvchjxyy",
            "id": "cbd12a18-c9d3-4bac-b71a-ce114de56226",
            "is_handle_updated": false,
            "is_liked": false,
            "is_public": false,
            "is_trashed": false,
            "major_model_version": "v3",
            "metadata": {
                "can_remix": true,
                "is_remix": false,
                "priority": 0,
                "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
                "stream": true,
                "tags": "heavy metal",
                "type": "gen"
            },
            "model_name": "chirp-v3",
            "play_count": 0,
            "status": "submitted",
            "title": "Starry ",
            "upvote_count": 0,
            "user_id": "156ce82a-5d9e-42f8-a941-bf515a625c2f",
            "video_url": ""
        },
        {
            "allow_comments": true,
            "audio_url": "",
            "avatar_image_url": "https://cdn1.suno.ai/sAura9.jpg",
            "created_at": "2025-05-30T02:41:48.617Z",
            "display_name": "zndvchjxyy",
            "entity_type": "song_schema",
            "flag_count": 0,
            "handle": "zndvchjxyy",
            "id": "b99c50c7-95f9-4cef-b7aa-6ffef447999e",
            "is_handle_updated": false,
            "is_liked": false,
            "is_public": false,
            "is_trashed": false,
            "major_model_version": "v3",
            "metadata": {
                "can_remix": true,
                "is_remix": false,
                "priority": 0,
                "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
                "stream": true,
                "tags": "heavy metal",
                "type": "gen"
            },
            "model_name": "chirp-v3",
            "play_count": 0,
            "status": "submitted",
            "title": "Starry ",
            "upvote_count": 0,
            "user_id": "156ce82a-5d9e-42f8-a941-bf515a625c2f",
            "video_url": ""
        }
    ],
    "id": "02b68ac4-ba20-4d91-ae48-ab427db0d018",
    "status": "complete"
}