Suno API Pricing

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). For Suno audio tasks the tracks are in data.response.data[] (audio_url, stream_audio_url, image_url, id, duration). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

URL of the uploaded audio file. Required. Source audio (`upload_url`) is enough to generate once `title`, `negative_tags`, and `tags` are provided.

The AI model version to use for generation. - Available options: - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details.

Values: "V6", "V6_MINI", "V6_WILD"

Default: "V6"

Title of the generated music. Required. Will be displayed in the player interface and file name.

Music styles or characteristics to exclude from the generated audio. Required. Used to avoid specific unwanted music elements.

maxLength: 200

Music styles or tags to include in the generated music. Required. Defines the desired music style and characteristics.

maxLength: 1000

Vocal gender preference. Optional. 'm' for male, 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions.

Values: "m", "f"

Adherence strength to specified style. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Controls experimental/creative deviation level. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Relative weight of audio elements. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Lyrics for the generated audio. Optional. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate once `title`, `negative_tags`, and `tags` are provided.

maxLength: 5000

Controls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encourages bold exploration of different styles - **`4`**: max (unreasonably varied) — maximum diversity; results may differ in style very significantly

Default: 1

minimum: 0

maximum: 4

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). For Suno audio tasks the tracks are in data.response.data[] (audio_url, stream_audio_url, image_url, id, duration). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Prompt for generating audio. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters.

maxLength: 5000

The AI model version to use for generation. - Available options: - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details.

Values: "V6", "V6_MINI", "V6_WILD"

Default: "V6"

Music title. Required. Will be displayed in the player interface and file name.

Excluded music styles. Required. Used to avoid including specific styles or elements in the generated music.

maxLength: 200

Music style. Required. Such as jazz, electronic, classical and other music types.

maxLength: 1000

Vocal gender preference. Optional. 'm' for male, 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions.

Values: "m", "f"

Adherence strength to specified style. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Controls experimental/creative deviation level. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Relative weight of audio elements. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

URL of the uploaded audio file. Required. Source audio (`upload_url`) is enough to generate once `title`, `negative_tags`, and `style` are provided.

Lyrics for the generated audio. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate once `title`, `negative_tags`, and `style` are provided.

maxLength: 5000

Controls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encourages bold exploration of different styles - **`4`**: max (unreasonably varied) — maximum diversity; results may differ in style very significantly

Default: 1

minimum: 0

maximum: 4

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Style description. Please describe in concise and clear language the music style you expect to generate. Example: 'Pop, Mysterious'

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Unique identifier of the music generation task. This should be a task_id returned from either the "Generate Music" or "Extend Music" endpoints. To convert a separated stem, use the task_id of the Vocal & Instrument Stem Separation task instead.

Unique identifier of the specific audio track to convert. This ID is returned in the callBackUrl data after music generation completes. For a separated stem, use the stem's id from the separation result (origin_data[].id).

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Original music task ID, should be the task_id returned by the music generation interface.

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Unique identifier of the music generation task. This should be a task_id returned from either the "Generate Music" or "Extend Music" endpoints.

Unique identifier of the specific audio track to visualize. This ID is returned in the callBackUrl data after music generation completes.

Artist or creator name to display as a signature on the video cover. Maximum 50 characters. This creates attribution for the music creator.

maxLength: 50

Website or brand to display as a watermark at the bottom of the video. Maximum 50 characters. Useful for promotional branding or attribution.

maxLength: 50

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). For Suno audio tasks the tracks are in data.response.data[] (audio_url, stream_audio_url, image_url, id, duration). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Unique identifier of the audio track to extend. Required for all extension requests.

Lyrics for the extended audio. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`audio_id`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.

maxLength: 5000

Music style specification for the extended audio. Optional. - Not required. Source audio (`audio_id`) is enough to generate. - Character limits by model: - **V6, V6_MINI, and V6_WILD**: Maximum 1000 characters - Should typically align with the original audio's style for best results.

maxLength: 1000

Title for the extended music track. Optional. - Maximum 100 characters. - Displayed in player interfaces and filenames.

maxLength: 100

The time point (in seconds) from which to start extending the music. - Value range: greater than 0 and less than the total duration of the generated audio. - Specifies the position in the original track where the extension should begin.

Required. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details.

Values: "V6", "V6_WILD", "V6_MINI"

Music styles or traits to exclude from the extended audio. Optional. Use to avoid specific undesired characteristics.

Vocal gender preference. Optional. 'm' denotes a male voice, and 'f' denotes a female voice. In practice, this parameter only influences the probability and does not guarantee strict adherence to the gender instruction. This parameter is not required if `instrumental` is set to `true`.

Values: "m", "f"

Strength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Controls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Balance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Persona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the [Generate Persona]([see VezAPI documentation]) endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the [Generate Voice]([see VezAPI documentation]) endpoint.

Values: "style_persona", "voice_persona"

Indicates whether it is an instrumental track. If true, passing the `lyrics`, `prompt`, and `vocal_gender` parameters is prohibited.

Default: false

Lyrics for the extended audio. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`audio_id`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.

maxLength: 5000

Controls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encourages bold exploration of different styles - **`4`**: max (unreasonably varied) — maximum diversity; results may differ in style very significantly

Default: 1

minimum: 0

maximum: 4

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Description of the desired lyrics content. Be specific about theme, mood, style, or story elements you want in the lyrics. More detailed prompts yield better results. The maximum word limit is 200 characters.

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). For Suno audio tasks the tracks are in data.response.data[] (audio_url, stream_audio_url, image_url, id, duration). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Array of audio file URLs to mashup. Provide 2 audio URLs. Only the first 2 are used. Each URL must be publicly accessible.

minItems: 2

A description of the desired audio content. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters.

maxLength: 5000

Music style specification for the generated audio. Required. - Character limits by model: - **V6, V6_MINI & V6_WILD**: Maximum 1000 characters - Common examples: Jazz, Classical, Electronic, Pop, Rock, Hip-hop, etc.

maxLength: 1000

Title for the generated music track. Required. - Character limits by model: - **V6, V6_MINI & V6_WILD**: Maximum 100 characters - Will be displayed in player interfaces and filenames.

Required. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details.

Values: "V6", "V6_WILD", "V6_MINI"

Vocal gender preference for the singing voice. Optional. Use 'm' for male and 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions.

Values: "m", "f"

Strength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Controls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Balance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Default: 20

minimum: 10

maximum: 360

Lyrics for the mashup. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters.

maxLength: 5000

Controls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encourages bold exploration of different styles - **`4`**: max (unreasonably varied) — maximum diversity; results may differ in style very significantly

Default: 1

minimum: 0

maximum: 4

Persona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the [Generate Persona]([see VezAPI documentation]) endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the [Generate Voice]([see VezAPI documentation]) endpoint.

Values: "style_persona", "voice_persona"

Default: "style_persona"

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Task ID from a completed vocal separation. This should be the task_id returned from the Vocal & Instrument Stem Separation endpoint.

The id of a stem from the separation callback (vocal_removal_info.origin_data[].id). If omitted, MIDI is generated from all stems.

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). For Suno audio tasks the tracks are in data.response.data[] (audio_url, stream_audio_url, image_url, id, duration). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

A description of the desired audio content. Optional. - Custom mode (`custom_mode=true`): When provided, the prompt is used strictly as lyrics and sung in the generated track. Character limits by model: - Non-custom mode (`custom_mode=false`): When provided, the prompt serves as the core idea. Lyrics are generated automatically based on it and do not strictly match the input. Maximum 3000 characters. `prompt` is not required. In non-custom mode, provide at least one of `image_urls`, `video_urls`, `audio_urls`, `midi_urls`, `style`, or `lyrics`. In custom mode, provide at least one of `style`, `lyrics`, or `negative_tags`. Generation is rejected if all related inputs are empty.

Music style specification for the generated audio. - Character limits by model: - **V6, V6_MINI, and V6_WILD**: Maximum 1000 characters - Common examples: Jazz, Classical, Electronic, Pop, Rock, Hip-hop, etc.

Title for the generated music track. - Required in Custom Mode (`custom_mode: true`). - Max length: 80 characters. - Will be displayed in player interfaces and filenames.

Determines whether advanced parameter customization is enabled. - If `true`: Allows detailed control - If `false`: Simplified mode

Whether to generate instrumental music (no vocals). See Parameter Details for the fields required in each mode.

Required. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details.

Values: "V6", "V6_MINI", "V6_WILD"

Music styles or traits to exclude from the generated audio. Optional. Use to avoid specific styles.

Vocal gender preference. Optional. Use `m` for male and `f` for female. This parameter is only effective when `custom_mode` is true. In practice, it only increases probability and cannot guarantee male/female voice instructions are followed.

Values: "m", "f"

Only available when Custom Mode (`custom_mode: true`) is enabled. Strength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Only available when Custom Mode (`custom_mode: true`) is enabled. Controls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Only available when Custom Mode (`custom_mode: true`) is enabled. Relative weight of audio features. Optional. Range 0–1, up to 2 decimal places. - `audio_weight` is not supported when there are no vocals

minimum: 0

maximum: 1

Persona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the [Generate Persona]([see VezAPI documentation]) endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the [Generate Voice]([see VezAPI documentation]) endpoint.

Values: "style_persona", "voice_persona"

minimum: 10

maximum: 360

Image references. Only effective when `custom_mode=false`. - Optional - Up to 5 images; each image must not exceed 10 MB - Supported formats: `jpeg`, `png`, `webp`, and `bmp`

maxItems: 5

Only available when Custom Mode (`custom_mode: true`) is enabled. Controls the diversity and stylistic variation of generated results. Optional. Range 0–4, integer, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encourages bold exploration of different styles - **`4`**: max (unreasonably varied) — maximum diversity; results may differ in style very significantly

Default: 1

minimum: 0

maximum: 4

Lyrics for the generated audio. Optional. - V6: Maximum 5000 characters. - When `custom_mode=true`, `lyrics` is used as lyrics first; if `lyrics` is not provided, `prompt` is used as lyrics. - When `custom_mode=false`, `lyrics` is used as a lyrics attachment and can be used together with the audio description in `prompt`.

Audio references. Only effective when `custom_mode=false`. - Optional - Audio duration must be between 6 seconds and 30 minutes; each audio file must not exceed 500 MB

Video references. Only effective when `custom_mode=false`. - Optional - Up to 1 video file; each file must not exceed 100 MB, duration must not exceed 241 seconds, with no minimum duration - Supported formats: mp4, mov, and webm

maxItems: 1

MIDI references. Only effective when `custom_mode=false`. - Optional - Currently up to 1 MIDI file; multiple MIDI files in one request are not supported - Supported formats: `mid`, `midi` - Each file must not exceed 256 KB and must start with the standard `MThd\x00\x00\x00\x06` header - Only supported by `V6_WILD`; if another model is passed, it will be switched to `V6_WILD`

maxItems: 1

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Unique identifier of the original music generation task. Generated by model ai-music-api/generate or ai-music-api/extend.

Unique identifier of the audio track to create Persona for. This ID is returned in the callBackUrl data after music generation completes.

Name for the Persona. A descriptive name that captures the essence of the musical style or character.

Detailed description of the Persona's musical characteristics, style, and personality. Be specific about genre, mood, instrumentation, and vocal qualities.

Start time (in seconds) for Persona analysis segment extraction. Used to specify the time point in the audio from which to extract the segment for Persona analysis. Must be less than vocal_end, and vocal_end - vocal_start must be between 10–30 seconds. Defaults to 0.0.

Default: 0

minimum: 0

End time (in seconds) for Persona analysis segment extraction. Together with vocal_start, used to specify the time range for analysis. vocal_end - vocal_start must be between 10–30 seconds. Defaults to 30.0.

Default: 30

minimum: 0

Optional. Used to supplement the description of the music style tag corresponding to the Persona, such as "Electronic Pop", "Jazz Trio", etc.

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Description of the sound (max 500 characters).

Required. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details.

Values: "V6", "V6_WILD", "V6_MINI"

Whether the generated sound loops seamlessly.

Default: false

Tempo in BPM (1–300). Omit for automatic tempo.

Default: null

minimum: 1

maximum: 300

Musical key. Default "Any" (automatic).

Values: "Any", "Cm", "C#m", "Dm", "D#m", "Em", "Fm", "F#m", "Gm", "G#m", "Am", "A#m", "Bm", "C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"

Default: "Any"

Whether to capture the lyrics subtitles Will the interface be called after completion to obtain the lyrics subtitles?

Default: false

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Unique identifier of the music generation task. This should be a task_id returned from either the "Generate Music" or "Extend Music" endpoints.

Unique identifier of the specific audio track for which to retrieve lyrics. This ID is returned in the callBackUrl data after music generation completes.

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/suno/recovery/record-info?task_id={task_id} (recovery tasks use this dedicated polling endpoint). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for generating the task

The original music generation task ID for which the audio link needs to be restored.

The model name used to generate the task. This field is required. This endpoint must use the `ai-music-api/replace-section` model.

Values: "ai-music-api/replace-section"

The URL to receive updates when the generation task is completed. Optional, but recommended for production environments. - When generation is complete, the system will POST the task status and results to this URL - The callback includes the generated URL and task information - Your callback endpoint should accept POST requests with a JSON payload containing the results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). For Suno audio tasks the tracks are in data.response.data[] (audio_url, stream_audio_url, image_url, id, duration). - To ensure callback security, refer to the [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the music section replacement task.

The lyrics after replacement. Required.

Style tags for the music, such as jazz or electronic. Required.

The title of the music. Required.

Music styles to exclude, used to prevent specific stylistic elements from appearing in the replacement section.

The point in time, in seconds, at which replacement starts, rounded to 2 decimal places. Required. Must be less than infill_end_s, and the difference between infill_end_s and infill_start_s must be at least 10 seconds.

minimum: 0

The point in time, in seconds, at which replacement ends, rounded to 2 decimal places. Required. Must be greater than infill_start_s, and the difference between infill_end_s and infill_start_s must be at least 10 seconds.

minimum: 0

The complete modified lyrics, combining the modified and unmodified lyrics. Required. This parameter contains the complete lyrics text that will be used for the entire song after section replacement.

Lyrics for the replaced segment. Optional. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters.

maxLength: 5000

Vocal gender preference. Optional. 'm' for male, 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions.

Values: "m", "f"

Adherence strength to specified style. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Controls experimental/creative deviation level. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Relative weight of audio elements. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Controls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encourages bold exploration of different styles - **`4`**: max (unreasonably varied) — maximum diversity; results may differ in style very significantly

Default: 1

minimum: 0

maximum: 4

Persona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the [Generate Persona]([see VezAPI documentation]) endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the [Generate Voice]([see VezAPI documentation]) endpoint.

Values: "style_persona", "voice_persona"

Default: "style_persona"

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task. Provide either task_id + audio_id, or audio_url alone.

Separation type, options: - **separate_vocal**: Separate vocals and accompaniment, generating a vocal track and an instrumental track. - **split_stem**: Separate various instrument sounds, generating multiple instrument tracks. - **split_stem_advanced**: Advanced multi-track separation, supporting the specification of a particular instrument track to generate finer instrument tracks.

Values: "separate_vocal", "split_stem", "split_stem_advanced"

Default: "separate_vocal"

Only used when `type` is `split_stem_advanced` to request a specific stem track/instrument name.

Values: "Lead Vocal", "Drum Kit", "Kick", "Snare", "Risers", "Bass", "Backing Vocals", "Piano", "Electric Guitar", "Percussion", "String Section", "Synth", "Acoustic Guitar", "Sound Effects", "Synth Pad", "Synth Bass", "Guitar", "Brass Section", "Organ", "Electronic Drum Kit", "Lead Electric Guitar", "Synth Keys", "Rhythm Electric Guitar", "Electric Piano", "Upright Bass", "Keyboards", "Distorted Electric Guitar", "Synth Strings", "Synth Lead", "Woodwinds", "Rhythm Acoustic Guitar", "Flute", "Harp", "Tambourine", "Trumpet", "Arpeggiator", "Accordion", "Fiddle", "Pedal Steel Guitar", "Synth Voice", "Violin", "Digital Piano", "Synth Brass", "Mandolin", "Choir", "Banjo", "Bells", "Clarinet", "Tenor Saxophone", "Trombone", "Shaker", "French Horn", "Glockenspiel", "Electric Bass", "Cello", "Timpani", "Harmonica", "Marimba", "Vibraphone", "Lap Steel Guitar", "Saxophone", "Orchestra", "Horns", "Cymbals", "Hand Clap", "Oboe", "Celesta", "Congas", "Drone", "Alto Saxophone", "Double Bass", "Ukulele", "Harpsichord", "Baritone Saxophone", "Xylophone", "Tuba", "Bass Guitar", "Whistle", "Lead Guitar", "Rhodes", "808", "Bongos", "Bassoon", "Cowbell", "Viola", "Sitar", "Steel Drums", "Piccolo", "Theremin", "Bagpipes", "Hi-Hat", "Music Box", "Melodica", "Tabla", "Koto", "Djembe", "Taiko", "Didgeridoo"

The model name to use for generation. Required field.

Input parameters for the generation task

The taskId returned by Generate Verification Phrase (step 1), also returned in resultJson.resultUrls[0] of the Create Custom Voice task.

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Task ID

Audio URL for the user's recording of the server-returned `validateInfo` validation phrase. For best voice generation results, recording the phrase in a singing voice rather than plain speech is recommended. [Required]

Voice name

Voice description

Voice style

Singer skill level. Supported: beginner, intermediate, advanced, professional

Values: "beginner", "intermediate", "advanced", "professional"

Default: "beginner"

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

Task ID

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

The original recording URL uploaded by the user [Required]

Start time (in seconds) for extracting the vocal segment [Required]

End time (in seconds) for extracting the vocal segment, must be greater than vocal_start_s [Required]

Verify the language of the short phrase. Supported languages ​​include: English (en), Chinese (zh), Spanish (es), French (fr), Portuguese (pt), German (de), Japanese (ja), Korean (ko), Hindi (hi), and Russian (ru).

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). For Suno audio tasks the tracks are in data.response.data[] (audio_url, stream_audio_url, image_url, id, duration). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

The URL of the source audio file to cover. Required unless `task_id` and `audio_id` are provided. Source audio (`upload_url`) is enough to generate. Ensure the uploaded audio does not exceed 8 minutes in length.

Lyrics for the covered audio. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.

maxLength: 5000

The music style or genre for the audio. Optional. - Not required. Source audio (`upload_url`) is enough to generate. - Character limits by model: - **V6, V6_MINI, and V6_WILD**: Maximum 1000 characters

maxLength: 1000

The title of the generated music track. Optional. - Maximum 80 characters. - Displayed in player interfaces and filenames.

maxLength: 80

Determines if the audio should be instrumental (no lyrics). - If `true`: generate instrumental music (no vocals). Do not pass `lyrics`, `prompt`, or `vocal_gender`. - If `false`: use `lyrics` as lyrics (fall back to `prompt` if `lyrics` is not provided).

Required. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details.

Values: "V6", "V6_WILD", "V6_MINI"

Music styles or traits to exclude from the generated audio. - Optional. Use to avoid specific styles. Example: "Heavy Metal, Upbeat Drums"

Vocal gender preference for the singing voice. Optional. Use 'm' for male and 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions. Do not pass this parameter when `instrumental` is `true`.

Values: "m", "f"

Strength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Controls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Balance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Persona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the [Generate Persona]([see VezAPI documentation]) endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the [Generate Voice]([see VezAPI documentation]) endpoint.

Persona model: style_persona or voice_persona. Available for V6, V6_MINI and V6_WILD.

Values: "voice_persona", "style_persona"

minimum: 10

maximum: 360

Lyrics for the covered audio. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.

maxLength: 5000

Controls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encourages bold exploration of different styles - **`4`**: max (unreasonably varied) — maximum diversity; results may differ in style very significantly

Default: 1

minimum: 0

maximum: 4

Task ID of a music generation task on VezAPI whose track you want to cover. Use together with `audio_id`; mutually exclusive with `upload_url`.

ID of the specific track to cover, from the generation result (the `id` of each track in the callback data or recordInfo). Use together with `task_id`; mutually exclusive with `upload_url`.

The model name to use for generation. Required field.

The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). For Suno audio tasks the tracks are in data.response.data[] (audio_url, stream_audio_url, image_url, id, duration). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification) for signature verification implementation

Input parameters for the generation task

The URL of the source audio file to extend. Required. Source audio (`upload_url`) is enough to generate. Ensure the uploaded audio does not exceed 8 minutes in length.

Determines whether the audio is instrumental (without lyrics). Optional; defaults to `false`. - If `true`: generate instrumental music (no vocals). Do not pass `lyrics`, `prompt`, or `vocal_gender`. - If `false`: use `lyrics` as lyrics (fall back to `prompt` if `lyrics` is not provided).

Default: false

Lyrics for the extended audio. Optional. - Used as lyrics only when `lyrics` is not provided. If `lyrics` is present, `prompt` is not used as lyrics. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.

maxLength: 5000

Music style, e.g., Jazz, Classical, Electronic. Optional. - Not required. Source audio (`upload_url`) is enough to generate. - Character limits by model: - **V6, V6_MINI & V6_WILD**: Maximum 1000 characters

maxLength: 1000

Music title. Optional. - Maximum 100 characters. - Displayed in player interfaces and filenames.

maxLength: 100

The time point (in seconds) from which to start extending the music. - Value range: greater than 0 and less than the total duration of the uploaded audio. - Specifies the position in the original track where the extension should begin.

Required. Use V6, V6_MINI or V6_WILD. - **`V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. - **`V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. - **`V6`**: Greater musical expression with more natural vocals and richer details.

Values: "V6", "V6_WILD", "V6_MINI"

Music styles to exclude from generation

Vocal gender preference for the singing voice. Optional. Use 'm' for male and 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions. Do not pass this parameter when `instrumental` is `true`.

Values: "m", "f"

Strength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Controls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Balance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.

minimum: 0

maximum: 1

Persona ID or Voice ID to apply to the generated music. Optional. Use this to apply a specific persona style to your music generation. To generate a Persona ID, use the [Generate Persona]([see VezAPI documentation]) endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the [Generate Voice]([see VezAPI documentation]) endpoint.

Values: "style_persona", "voice_persona"

Lyrics for the extended audio. Optional. - Takes priority over `prompt` as lyrics. If omitted, `prompt` is used as lyrics when provided. - V6, V6_MINI, and V6_WILD: Maximum 5000 characters. - Not required. Source audio (`upload_url`) is enough to generate. - Do not pass this parameter when `instrumental` is `true`.

maxLength: 5000

Controls the diversity and stylistic variation of generated results. Optional. Integer range 0–4, default 1. - **`0`**: off (exact style) — fully off, strictly the same style - **`1`**: normal (balanced variety) — default, balances stability and diversity - **`2`**: high (distinct styles) — produces results with clearly different styles - **`3`**: extra (bold exploration) — higher variation, encourages bold exploration of different styles - **`4`**: max (unreasonably varied) — maximum diversity; results may differ in style very significantly

Default: 1

minimum: 0

maximum: 4

Model identifier. Always `ai-music-api/speech`.

Values: "ai-music-api/speech"

The URL to receive generation task completion updates. Optional but recommended for production use. - The system POSTs task status and results to this URL when generation completes - The callback includes generated URLs and task information - Your callback endpoint should accept POST requests with a JSON payload - Alternatively, poll GET /api/v1/jobs/recordInfo?taskId=... (see [Get Task Details](/market/common/get-task-detail)). For Suno audio tasks the tracks are in data.response.data[] (audio_url, stream_audio_url, image_url, id, duration). - To ensure callback security, see [Webhook Verification Guide](/common-api/webhook-verification)

Input parameters for the generation task. Simple and Advanced fields are mutually exclusive: Simple sends only `customMode=false` and `prompt`; Advanced sends `customMode=true` and `script`, plus optional fields.

Mode switch. Required. `false` is Simple, `true` is Advanced.

Simple only. Official Idea prompt: a one-line scene description; the model writes the script. Required. After trimming whitespace, 1–3000 characters.

minLength: 1

maxLength: 3000

Advanced only. The text to be spoken. Required. After trimming whitespace, 1–5000 characters. Multiline is supported; use `\n` for line breaks in JSON.

minLength: 1

maxLength: 5000

Advanced only, optional. Tone, rhythm, emotion, and setting. You can also describe accent and accompaniment style. After trimming whitespace, 0–1000 characters.

maxLength: 1000

Advanced only, optional. Integer from `0` to `4`.

Values: 0, 1, 2, 3, 4

minimum: 0

maximum: 4

Advanced only, optional. Vocal gender. Case-insensitive. Do not send `female` / `male`.

Values: "f", "m"

Advanced only, optional. Whether to add background music. - `true`: On - `false`: Off