Music models › Suno

Add Vocals to Music

Add Vocals to Music

music Suno price on request

Request

POST https://app.video-blade.com/api/v1/generations
X-API-Key: vb_…
Content-Type: application/json

{
  "callback_url": "https://your-app.example/callbacks/video-blade",
  "input": {
    "negative_tags": "\u2026",
    "style": "\u2026",
    "title": "\u2026",
    "upload_url": "\u2026"
  },
  "model": "suno-add-vocals"
}

Input parameters

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

Pricing

Price on request; the charge is settled from actual consumption with the music coefficient ×2.0. See Pricing & tokens.