Create a music generation task
Music generation submission API, compatible with the legacy /suno/submit/music path. Returns a task ID, which can later be queried via /suno/fetch/{task_id}.
Music generation task submission API. The path remains /suno/submit/music; in practice, upstream_model, music_model, engine, model_id, or modelId can be used to select the generation engine. The creation API returns task_id, and the output can then be queried with /suno/fetch/{task_id}.
Prompt Description Mode
Suitable for describing only the style, mood, language, singer type, and scenario, with the model automatically generating the song content.
{
"model": "suno_music",
"upstream_model": "suno-v5",
"prompt": "Imitating "Billie Jean," create a DJ song with the theme of "the artificial intelligence revolution."",
"make_instrumental": false
}
Light Music or Instrumental Only
You can use light_music=true or make_instrumental=true. light_music indicates a preference for light music/background music, and make_instrumental indicates that no sung vocals will be generated.
{
"model": "suno_music",
"upstream_model": "minimax-music-v2.6",
"prompt": "Warm cafe background music with soft piano and strings, relaxing and cinematic.",
"light_music": true,
"make_instrumental": true
}
Advanced Lyrics Mode
Suitable when the business side has already prepared the lyrics and needs to specify the title and style tags. custom_mode=true can be passed, and the lyrics field can use lyrics, lyric, custom_lyrics, or customLyrics.
{
"model": "suno_music",
"upstream_model": "mureka-v9",
"custom_mode": true,
"title": "Summer Sea Breeze",
"tags": "electro pop, female vocal, bright summer",
"lyrics": "[Verse]\nSea breeze moves across the white sand\n[Chorus]\nTurn the summer into a beam of light"
}
Query
After creation succeeds, save the returned data task ID, such as task_xxx, and call GET /suno/fetch/{task_id} to query the status, audio URL, cover, title, lyrics, and the upstream raw fragment information.
Authorizations
Use Bearer Token authentication.
Format: Authorization: Bearer sk-xxxxxx
Body
Always pass suno_music.
suno_music "suno_music"
In prompt description mode, this is used for music style, mood, and scene; in the advanced lyrics mode, it can be used as a lyrics-compatible field.
Generation engine selection value.
"suno-v5"
Compatibility alias for upstream_model.
Compatibility alias for upstream_model.
Compatibility field for upstream model ID.
camelCase-compatible field for model_id.
Describes the compatibility field for prompt mode.
Whether to generate instrumental accompaniment only.
Whether to generate in a light music/background music style.
Whether to generate in instrumental music mode.
Whether to use custom mode.
camelCase-compatible field for custom_mode.
Song title.
Style tags, such as electro pop, female vocal.
Style-compatible field.
Genre compatibility field.
Genre compatibility field.
Lyrics content.
lyrics Compatible alias.
lyrics Compatible alias.
lyrics Compatible alias.