suno.com

•

API Key

About Suno

Suno is an AI music generation platform that produces complete songs — including vocals, lyrics, and instrumentation — from short text descriptions. Users can generate songs in virtually any genre, extend existing tracks, separate stems, and edit songs with the Song Editor. Suno's latest model as of 2026 is v5.5. The platform targets creators, marketers, and musicians seeking rapid music production. Suno does not offer an official public API; third-party wrapper services exist at separate domains like sunoapi.org.

AI Agent Use Cases

- Text-to-song generation with vocals and full instrumentation (v5.5 model)

- Song Editor for extending, remixing, and refining generated tracks

- Stem separation to isolate vocals or instruments

- Commercial use rights on paid plans

- Genre, mood, and lyric customization via prompt

- Priority generation queue on paid plans

Available Actions

These are the specific actions that AI agents can perform with this tool

Generate AI Music Track

8 inputs

Creates music using Suno's AI models based on lyrics, style, and other options.

Inputs

prompt

A description of the music or lyrics; required for non-customMode, or for customMode if instrumental is false. Limited to 400 characters for non-customMode, up to 3000 or 5000 depending on model in customMode.

style

The music style or genre. Required when customMode is true. Max 200 characters for V3_5/V4, 1000 for V4_5. Leave empty in non-customMode.

title

Title of the generated music track. Required in customMode, max 80 characters. Leave empty in non-customMode.

customMode

Set to true for advanced options (requires title and style; prompt required if instrumental is false); set to false for simple prompt-only generation.

instrumental

Whether to generate instrumental-only audio. In customMode true: if true, omit prompt; if false, prompt is used as lyrics. Always required.

model

The Suno AI model version to use: 'V3_5', 'V4', or 'V4_5'.

negativeTags

Music styles or traits to exclude from the output. Optional.

callBackUrl

The URL to receive a callback notification when music generation is finished.

Generate AI Music Track

8 inputs

Creates a new AI-generated music track with optional style, title, lyrics, and callback when ready.

Inputs

prompt

Text describing the desired music or lyrics; always required in Non-custom Mode, and required in Custom Mode if instrumental is false. Length limits apply by mode and model.

style

Name of the music style or genre; required in Custom Mode, ignored in Non-custom Mode. Length limits vary by model.

title

Desired title of the track; required in Custom Mode, ignored in Non-custom Mode. Max 80 characters.

customMode

If true, enables Custom Mode with advanced options; if false, uses default mode. Determines if style and title must be provided.

instrumental

If true, generates instrumental only (no lyrics). In Custom Mode, required fields depend on this flag.

model

AI model version to use for generation; affects length limits and generation quality.

negativeTags

Music traits or styles to explicitly exclude (comma-separated). Optional.

callBackUrl

URL to notify via POST when generation task completes. Must be a valid reachable URI.

Get Timestamped Lyrics For Music Track

3 inputs

Retrieve timestamped lyrics and waveform data for a specific generated music track for synchronized display.

Inputs

taskId

Unique identifier of the music generation task. This is required to find the group of tracks that may contain lyrics.

audioId

ID of the specific audio track to get lyrics for. Used with highest priority if both audioId and musicIndex are provided.

musicIndex

Index of the music track (0 or 1) within the task. Used only if audioId is not provided or not found. Either audioId or musicIndex must be provided.

About Suno

AI Agent Use Cases

- Text-to-song generation with vocals and full instrumentation (v5.5 model)

- Song Editor for extending, remixing, and refining generated tracks

- Stem separation to isolate vocals or instruments

- Commercial use rights on paid plans

- Genre, mood, and lyric customization via prompt

- Priority generation queue on paid plans

Available Actions

These are the specific actions that AI agents can perform with this tool

Generate AI Music Track

8 inputs

Creates music using Suno's AI models based on lyrics, style, and other options.

Inputs

prompt

style

The music style or genre. Required when customMode is true. Max 200 characters for V3_5/V4, 1000 for V4_5. Leave empty in non-customMode.

title

Title of the generated music track. Required in customMode, max 80 characters. Leave empty in non-customMode.

customMode

Set to true for advanced options (requires title and style; prompt required if instrumental is false); set to false for simple prompt-only generation.

instrumental

Whether to generate instrumental-only audio. In customMode true: if true, omit prompt; if false, prompt is used as lyrics. Always required.

model

The Suno AI model version to use: 'V3_5', 'V4', or 'V4_5'.

negativeTags

Music styles or traits to exclude from the output. Optional.

callBackUrl

The URL to receive a callback notification when music generation is finished.

Generate AI Music Track

8 inputs

Creates a new AI-generated music track with optional style, title, lyrics, and callback when ready.

Inputs

prompt

Text describing the desired music or lyrics; always required in Non-custom Mode, and required in Custom Mode if instrumental is false. Length limits apply by mode and model.

style

Name of the music style or genre; required in Custom Mode, ignored in Non-custom Mode. Length limits vary by model.

title

Desired title of the track; required in Custom Mode, ignored in Non-custom Mode. Max 80 characters.

customMode

If true, enables Custom Mode with advanced options; if false, uses default mode. Determines if style and title must be provided.

instrumental

If true, generates instrumental only (no lyrics). In Custom Mode, required fields depend on this flag.

model

AI model version to use for generation; affects length limits and generation quality.

negativeTags

Music traits or styles to explicitly exclude (comma-separated). Optional.

callBackUrl

URL to notify via POST when generation task completes. Must be a valid reachable URI.

Get Timestamped Lyrics For Music Track

3 inputs

Retrieve timestamped lyrics and waveform data for a specific generated music track for synchronized display.

Inputs

taskId

Unique identifier of the music generation task. This is required to find the group of tracks that may contain lyrics.

audioId

ID of the specific audio track to get lyrics for. Used with highest priority if both audioId and musicIndex are provided.

musicIndex

Index of the music track (0 or 1) within the task. Used only if audioId is not provided or not found. Either audioId or musicIndex must be provided.