Music（Custom Mode）

POST

/suno/submit/music

Generate 2 songs by customizing settings such as lyrics and style of the songs.

Precautions
New users are recommended to use Automatic Mode, which allows you to quickly test APIs and experience the results.

The generated files will be retained for 14 days and then deleted

Ensure that all necessary parameters are provided according to the settings of make_instrumental to avoid errors

Please note the character length limits for prompt, tags, and title to ensure successful processing

The callback process has three stages: text (text generation completed), first (first item completed), complete (all completed)

You can use the Fetch interface to proactively check the task status instead of waiting for a callback

Price: 0.1 PTC / call

Request

Header Params

Body Params application/json

Example

{
    "prompt": "[Verse]\nMoonlight reflects mountains and rivers\nGentle breeze brushes willow branches\nA thousand words in my heart\nI only want to tell you\n\n[Verse 2]\nFlowers bloom and wither\nSpring goes and autumn returns\nTime flows mercilessly\nOnly love remains in my heart\n\n[Chorus]\nFor a lifetime\nDancing with you through wind and rain\nNever leaving you\nSharing spring, summer, winter and autumn\n\n[Verse]\nStars shine on the earth\nIn the stillness of the night\nLonging surges like a tide\nDay and night without change\n\n[Bridge]\nHow many times\nWe are together in dreams\nWhen I wake up\nTears wet my pillow\n\n[Chorus]\nFor a lifetime\nDancing with you through wind and rain\nNever leaving you\nSharing spring, summer, winter and autumn",
    "tags": "rap",
    "mv": "chirp-v3-5",
    "title": "Never leave, never forsake"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/suno/submit/music' \
--header 'Authorization: Bearer ' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "[Verse]\nMoonlight reflects mountains and rivers\nGentle breeze brushes willow branches\nA thousand words in my heart\nI only want to tell you\n\n[Verse 2]\nFlowers bloom and wither\nSpring goes and autumn returns\nTime flows mercilessly\nOnly love remains in my heart\n\n[Chorus]\nFor a lifetime\nDancing with you through wind and rain\nNever leaving you\nSharing spring, summer, winter and autumn\n\n[Verse]\nStars shine on the earth\nIn the stillness of the night\nLonging surges like a tide\nDay and night without change\n\n[Bridge]\nHow many times\nWe are together in dreams\nWhen I wake up\nTears wet my pillow\n\n[Chorus]\nFor a lifetime\nDancing with you through wind and rain\nNever leaving you\nSharing spring, summer, winter and autumn",
    "tags": "rap",
    "mv": "chirp-v3-5",
    "title": "Never leave, never forsake"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": "success",
    "message": "",
    "data": "69c61512-278e-4ff4-b6ea-f3b278329b04"
}

Modified at 2025-12-15 06:06:03

Music（Automatic Mode）

Music（Song Continuation）