Suno Music - Suno Music Generation (AI Model · By )

API Documentation

API Reference

Audio

Suno Music Generation

Supported Model Code

Loading models...

Suno Music (suno_music)

suno_music0 models support this endpoint

Suno generates complete, studio-quality songs from text prompts — vocals, instruments, and production in a single pass. Describe a genre, mood, or lyrical theme and get back a fully arranged track with expressive, lifelike vocals across dozens of languages and styles. Built on Suno's end-to-end audio generation architecture, it handles everything from song structure and melody to mixing and mastering, producing release-ready music from a simple text description.

Call Suno to generate music

https://api.modelstream.ai

POST/v1/suno/music

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

mv*string

Select the Suno model version for music generation. V5 is the latest flagship.

RequiredExample Value: chirp-v5

Enum/Options:

Chirp V5 (Recommended Flagship): chirp-v5Chirp V5.5 (Latest Preview): chirp-v5-5Chirp V4.5+ (High Fidelity): chirp-v4-5+Chirp V4.5 (Classic): chirp-v4-5Chirp V4: chirp-v4Chirp V3.5: chirp-v3-5Chirp V3.0: chirp-v3-0

custom*boolean

Enable to manually input lyrics and style; disable to generate using AI descriptions.

RequiredExample Value: false

instrumental*boolean

Enable to generate instrumental tracks only. Lyrics settings will be ignored.

RequiredExample Value: false

gpt_description_prompt?string

Effective in non-custom mode. Write ideas, themes, or visual details for the song, and AI will write the lyrics and arrange it.

Example Value: 用“Another year has spun around, a special day is here So glad to have you in my life, dispelling every fear The candles on the cake ignite, a wish you'll soon embrace Let's celebrate this moment, with a smile upon your face. 又一年时光流转，你的生日已来到很高兴有你在身边，赶走了所有烦恼蛋糕上的蜡烛闪耀，许个愿望就会实现让我们一同庆祝此刻，脸上带着快乐笑颜。”作为歌词来一首歌。Placeholder: E.g., A happy and lively pop birthday song, bringing warmth to a friend...

prompt?string

Effective in custom mode. Supports structured paragraph partitioning using tags like [Verse], [Chorus], and [Outro].

Example Value: Placeholder: [Verse 1] Sunshine shines on the cake... [Chorus] Happy birthday to you...

title?string

Example Value: Placeholder: Effective in custom mode only, enter the song title

tags?string

Effective in custom mode only. E.g. 'pop, female vocal, warm acoustic'. Max length 200 characters.

Example Value: Placeholder: Style phrases separated by commas...

negative_tags?string

Example Value: Placeholder: Avoid styles in music generation, e.g. metal, noisy...

vocal_gender?string

Example Value: Female

Enum/Options:

Female Voice: FemaleMale Voice: Male

persona_id?string

Enter the Singer Task ID generated by voice cloning. The music will be sung using this voice.

Example Value: Placeholder: Please enter your VOICE ID...

style_weight?number

Controls the influence of style tags on audio generation. Defaults to 1.0 (strongest).

Example Value: 1Value Range: 0 ≤ value ≤ 1step: 0.05

weirdness_constraint?number

Higher values make the generated song more unique and unexpected. Defaults to 0.0 (safe).

Example Value: 0Value Range: 0 ≤ value ≤ 1step: 0.05

audio_weight?number

Controls the precision of preserving the cloned voice or vocal characteristics. Defaults to 1.0.

Example Value: 1Value Range: 0 ≤ value ≤ 1step: 0.05

auto_lyrics?boolean

Enable to let AI automatically polish your input lyrics for poetic beauty and rhythm.

Example Value: false

Response Parameters

application/json

200apiDocs.responses.successGenerateAudio

code?string

data?string

apiDocs.schemas.common.taskId

message?string

curl -X POST "https://api.modelstream.ai/v1/suno/music" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "mv": "chirp-v5",
  "custom": false,
  "instrumental": false,
  "gpt_description_prompt": "用“Another year has spun around, a special day is here\nSo glad to have you in my life, dispelling every fear\nThe candles on the cake ignite, a wish you'll soon embrace\nLet's celebrate this moment, with a smile upon your face.\n又一年时光流转，你的生日已来到\n很高兴有你在身边，赶走了所有烦恼\n蛋糕上的蜡烛闪耀，许个愿望就会实现\n让我们一同庆祝此刻，脸上带着快乐笑颜。”作为歌词来一首歌。",
  "style_weight": 1,
  "weirdness_constraint": 0,
  "audio_weight": 1,
  "auto_lyrics": false,
  "vocal_gender": "Female",
  "isStorage": true
}'

{
  "code": "success",
  "data": "task_OCPNdVVSZZRQ49s3mktfCBB0CSjNPLzk",
  "message": ""
}

API Documentation

API Reference

Audio

Suno Music Generation

Supported Model Code

Loading models...

Suno Music (suno_music)

suno_music0 models support this endpoint

Call Suno to generate music

https://api.modelstream.ai

POST/v1/suno/music

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

mv*string

Select the Suno model version for music generation. V5 is the latest flagship.

RequiredExample Value: chirp-v5

Enum/Options:

custom*boolean

Enable to manually input lyrics and style; disable to generate using AI descriptions.

RequiredExample Value: false

instrumental*boolean

Enable to generate instrumental tracks only. Lyrics settings will be ignored.

RequiredExample Value: false

gpt_description_prompt?string

Effective in non-custom mode. Write ideas, themes, or visual details for the song, and AI will write the lyrics and arrange it.

prompt?string

Effective in custom mode. Supports structured paragraph partitioning using tags like [Verse], [Chorus], and [Outro].

Example Value: Placeholder: [Verse 1] Sunshine shines on the cake... [Chorus] Happy birthday to you...

title?string

Example Value: Placeholder: Effective in custom mode only, enter the song title

tags?string

Effective in custom mode only. E.g. 'pop, female vocal, warm acoustic'. Max length 200 characters.

Example Value: Placeholder: Style phrases separated by commas...

negative_tags?string

Example Value: Placeholder: Avoid styles in music generation, e.g. metal, noisy...

vocal_gender?string

Example Value: Female

Enum/Options:

Female Voice: FemaleMale Voice: Male

persona_id?string

Enter the Singer Task ID generated by voice cloning. The music will be sung using this voice.

Example Value: Placeholder: Please enter your VOICE ID...

style_weight?number

Controls the influence of style tags on audio generation. Defaults to 1.0 (strongest).

Example Value: 1Value Range: 0 ≤ value ≤ 1step: 0.05

weirdness_constraint?number

Higher values make the generated song more unique and unexpected. Defaults to 0.0 (safe).

Example Value: 0Value Range: 0 ≤ value ≤ 1step: 0.05

audio_weight?number

Controls the precision of preserving the cloned voice or vocal characteristics. Defaults to 1.0.

Example Value: 1Value Range: 0 ≤ value ≤ 1step: 0.05

auto_lyrics?boolean

Enable to let AI automatically polish your input lyrics for poetic beauty and rhythm.

Example Value: false

Response Parameters

application/json

200apiDocs.responses.successGenerateAudio

code?string

data?string

apiDocs.schemas.common.taskId

message?string

curl -X POST "https://api.modelstream.ai/v1/suno/music" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "mv": "chirp-v5",
  "custom": false,
  "instrumental": false,
  "gpt_description_prompt": "用“Another year has spun around, a special day is here\nSo glad to have you in my life, dispelling every fear\nThe candles on the cake ignite, a wish you'll soon embrace\nLet's celebrate this moment, with a smile upon your face.\n又一年时光流转，你的生日已来到\n很高兴有你在身边，赶走了所有烦恼\n蛋糕上的蜡烛闪耀，许个愿望就会实现\n让我们一同庆祝此刻，脸上带着快乐笑颜。”作为歌词来一首歌。",
  "style_weight": 1,
  "weirdness_constraint": 0,
  "audio_weight": 1,
  "auto_lyrics": false,
  "vocal_gender": "Female",
  "isStorage": true
}'

{
  "code": "success",
  "data": "task_OCPNdVVSZZRQ49s3mktfCBB0CSjNPLzk",
  "message": ""
}