Suno Music generation API

Choose a version in the existing Suno Music task and describe the music you want to create. Use a concise prompt for a simple request, or prepare a custom song brief with style, title and the lyric text you want to develop. Select instrumental or vocal creation, apply the preferences available for that workflow and listen to all returned candidates before choosing a track. The current form lists V4, V4.5, V4.5 All, V4.5 Plus and V5.

Vidgo provides access to Suno Music through PoYo’s music-tool integration. Model and tool names and trademarks belong to their respective owners.

Explore Suno Music Models

Select the version and creative mode before entering the brief. For a simple request, prepare a clear description of the mood, genre and instruments. For Custom Mode, prepare the style, title and applicable song text, then review the returned candidates against that direction.

Suno Music Versions, Lyrics and Music Generation Modes

Use model: generate-music and select the version through mv. For simple mode, custom_mode is false and the documented prompt limit is 500 characters. In Custom Mode, prepare style and title, and provide the song text for vocal creation. The documentation gives V4 prompt/style limits of 3,000/200 characters and V4.5, V4.5 All, V4.5 Plus and V5 limits of 5,000/1,000; title is limited to 80 characters. Set instrumental around whether the request should produce pure music or vocals.

Model / taskInput and workflow
Suno MusicAI music generator with customizable styles, vocals, and full creative control over musical characteristics and quality.

Suno Music Original Instrumental and Vocal Song Examples

Two original V5 custom requests create an acoustic instrumental and a vocal folk song. Each request returned two candidates. Listen to all four recordings with their actual prompts, styles and source identifiers, and compare the candidates within the brief that generated them.

Musical direction

A quiet coastal harbor at dusk, paper lanterns swaying above the water; warm acoustic instruments and a gentle unhurried rhythm.

{
  "model": "generate-music",
  "input": {
    "prompt": "A quiet coastal harbor at dusk, paper lanterns swaying above the water; warm acoustic instruments and a gentle unhurried rhythm.",
    "style": "Gentle acoustic folk instrumental, nylon guitar, soft upright bass, brushed percussion, reflective evening atmosphere",
    "title": "Harbor Paper Lanterns",
    "mv": "V5",
    "custom_mode": true,
    "instrumental": true
  }
}
Recorded request parameters
Completed result 1
Completed result 2

Musical direction

[Verse] Rain has left the window bright Morning folds away the night On the table, bread and tea There is room for you and me [Chorus] Open up the day again Let the sunlight wander in Every road can start from here One small step and skies are clear

{
  "model": "generate-music",
  "input": {
    "prompt": "[Verse]\nRain has left the window bright\nMorning folds away the night\nOn the table, bread and tea\nThere is room for you and me\n[Chorus]\nOpen up the day again\nLet the sunlight wander in\nEvery road can start from here\nOne small step and skies are clear",
    "style": "Warm indie folk, acoustic guitar, light hand percussion, clear lead vocal, hopeful tone",
    "title": "Windows After Rain",
    "mv": "V5",
    "custom_mode": true,
    "instrumental": false
  }
}
Recorded request parameters
Completed result 1
Completed result 2

Creative Use Cases for Suno Music

Prepare a music brief or your own selected lyrics, together with the genre, mood and instruments the request should use. Apply an existing persona_id in supported Custom Mode when it is part of the direction. For an operation beginning with an uploaded audio source, open the matching upload-cover or upload-extension task and prepare its required input.

A song from an original lyric draft

Prepare your lyric text, style and title in Custom Mode, then choose vocal creation. Review the returned candidates for the intended words, musical character and delivery.

Instrumental background concepts

Describe the mood, pace and featured instruments, then choose instrumental generation. Listen to the candidates against the intended scene or background role.

A creative direction across versions

Prepare a complete brief and explicitly select the version for each request. Retain its settings and returned music when reviewing which workflow fits the project.

Music for a project presentation

Describe the project’s mood and the role of the music, then generate candidates. Review the complete tracks with the planned presentation before choosing the result to use.

Refining a song or instrumental idea

Listen to the first result and revise the brief, style or supported preferences around the observed details. Review the next candidates against the same creative goal.

A source for follow-up music tools

Select the completed candidate you intend to develop, retain its identifiers and prepare the next operation’s required fields. Use the original audio as the source reference for extension, separation or visual presentation.

Suno Music Specifications and API Pricing

The table reads the current rate for one music-generation request. Read the completed files to see the actual returned candidates and their durations. Follow-up extension, audio processing, cover-artwork or video requests use their own task rates. Review the current request price before generating and budget further creative iterations as additional requests.

ToolProviderOperationInputResult typeCurrent rate
Suno MusicPoYoMusic generationMusic brief or custom lyric/style inputs with selected mvGenerated music candidates$0.1 / request

How to Use Suno Music on Vidgo

Prepare the source input, then review the completed result and its next use.

Test online

Test the prepared request online

Open Suno Music, choose the version and select simple or Custom Mode. Prepare the corresponding prompt, style and title, choose instrumental or vocal creation and review the current request price. Generate, listen to the complete returned candidates and retain the track you want to develop further.

Why Use Suno Music on Vidgo

Use the existing task, current request rate and API documentation to connect source preparation, result review and the next music workflow.

Source preparation and result review

Prepare the input required by the operation

Prepare a music brief or your own selected lyrics, together with the genre, mood and instruments the request should use. Apply an existing persona_id in supported Custom Mode when it is part of the direction. For an operation beginning with an uploaded audio source, open the matching upload-cover or upload-extension task and prepare its required input.

Inspect the completed output

Listen to every returned candidate and compare its musical direction, vocal treatment or instrumental arrangement with the brief. In Custom Mode with vocals, review the intended lyrics and delivery together. In Custom Mode with vocals, vocal_gender m or f expresses the vocal preference. style_weight controls style adherence, weirdness_constraint controls creative deviation and audio_weight sets the documented audio-feature balance; each uses the 0–1 range with up to two decimals. Refine the next request using the observed result and retain each selected track’s task_id and audio_id for follow-up tools.

Review the current request rate

The table reads the current rate for one music-generation request. Read the completed files to see the actual returned candidates and their durations. Follow-up extension, audio processing, cover-artwork or video requests use their own task rates. Review the current request price before generating and budget further creative iterations as additional requests.

API integration and follow-up work

Use the accepted request fields

Submit model: generate-music with prompt, mv, custom_mode and instrumental in input, plus the fields required by the selected mode. Retain the task_id and query music details to read every returned candidate, its audio_id, audio URL and available cover or duration information.

Track the processing task

Authenticate with your Vidgo API credentials and submit the exact model identifier with the required input fields. Retain the returned processing task_id so your application can track the operation and retrieve its result. Use the task documentation when configuring any completion notification.

Retain the result and source association

Query /api/generate/detail/music?task_id=YOUR_PROCESSING_TASK_ID with the returned processing ID, or handle the configured notification. When the task finishes, inspect the operation-specific result in files and retain its source association. Listen to every returned candidate and compare its musical direction, vocal treatment or instrumental arrangement with the brief. In Custom Mode with vocals, review the intended lyrics and delivery together. In Custom Mode with vocals, vocal_gender m or f expresses the vocal preference. style_weight controls style adherence, weirdness_constraint controls creative deviation and audio_weight sets the documented audio-feature balance; each uses the 0–1 range with up to two decimals. Refine the next request using the observed result and retain each selected track’s task_id and audio_id for follow-up tools.

Suno Music API FAQ

Choose a version in the existing Suno Music task and describe the music you want to create. Use a concise prompt for a simple request, or prepare a custom song brief with style, title and the lyric text you want to develop. Select instrumental or vocal creation, apply the preferences available for that workflow and listen to all returned candidates before choosing a track. The current form lists V4, V4.5, V4.5 All, V4.5 Plus and V5.

Browse all models