Music models › Suno

Add Vocals to Music

Add Vocals to Music

music Suno 16 tokens per request $0.005 per token

Pricing

OptionTokensUnit≈ USD
add-vocals16per request$0.0800

The price is held when the task is created and settled to actual consumption when it completes; a failed task releases the hold.

How to order

This model is listed for its price and is not ordered through the API yet.

Field lists and refusal codes — API reference.

Model parameters

What the model itself understands; the ordering calls above take their own fields and pass these on.

NameTypeRequiredDescription
prompt string optional 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.
model string optional 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. - **`V5_5`** (Discontinued): Custom Models Tailored to Your Unique Taste. - **`V5`** (Discontinued): Superior musical expression, faster generation. - **`V4_5PLUS`** (Discontinued): V4.5+ is richer sound, new ways to create.
Values: V4_5PLUS, V5, V5_5, V6, V6_MINI, V6_WILD
Default: V6
title string required Music title. Required. Will be displayed in the player interface and file name.
negative_tags string required Excluded music styles. Required. Used to avoid including specific styles or elements in the generated music.
style string required Music style. Required. Such as jazz, electronic, classical and other music types.
vocal_gender string optional 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
style_weight number optional Adherence strength to specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraint number optional Controls experimental/creative deviation level. Optional. Range 0–1, up to 2 decimal places.
audio_weight number optional Relative weight of audio elements. Optional. Range 0–1, up to 2 decimal places.
upload_url string required URL of the uploaded audio file. Required. Source audio (`upload_url`) is enough to generate once `title`, `negative_tags`, and `style` are provided.
lyrics string optional 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.
variety integer optional 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