Music models › Suno

Generate Mashup Music

Generate Mashup 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": {
    "model": "V4",
    "style": "\u2026",
    "title": "\u2026",
    "upload_url_list": "\u2026"
  },
  "model": "suno-generate-mashup"
}

Input parameters

NameTypeRequiredDescription
upload_url_list array required Array of audio file URLs to mashup. Provide 2 audio URLs. Upstream uses only the first 2. Each URL must be publicly accessible.
prompt string optional 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.
style string required Music style specification for the generated audio. Required. - Character limits by model: - **V4** (Discontinued): Maximum 200 characters - **V4_5 & V4_5PLUS** (Discontinued): Maximum 1000 characters - **V4_5ALL** (Discontinued): Maximum 1000 characters - **V5 & V5_5** (Discontinued): Maximum 1000 characters - **V6, V6_MINI & V6_WILD**: Maximum 1000 characters - Common examples: Jazz, Classical, Electronic, Pop, Rock, Hip-hop, etc.
title string required Title for the generated music track. Required. - Character limits by model: - **V4** (Discontinued): Maximum 80 characters - **V4_5 & V4_5PLUS** (Discontinued): Maximum 100 characters - **V4_5ALL** (Discontinued): Maximum 80 characters - **V5 & V5_5** (Discontinued): Maximum 100 characters - **V6, V6_MINI & V6_WILD**: Maximum 100 characters - Will be displayed in player interfaces and filenames.
model string required The AI model version to use for generation. - Required for all requests. - 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+ delivers richer sound, new ways to create, max 8
Values: V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5, V6, V6_WILD, V6_MINI
vocal_gender string optional 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
style_weight number optional Strength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.
weirdness_constraint number optional Controls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.
audio_weight number optional Balance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.
duration integer optional Audio duration in seconds. Optional. Range 10–360, default 20. Valid when `model` is ~~V5_5~~ (Discontinued), V6, V6_MINI, or V6_WILD.
Default: 20
lyrics string optional 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.
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
persona_id string optional 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 endpoint to create a personalized music Persona based on generated music. To generate a Voice ID, use the Generate Voice endpoint.
persona_model string optional Persona model. Optional. Use `style_persona` for Generate Persona IDs, or `voice_persona` for Suno Voice IDs. Default: `style_persona`. Available for V5 (Discontinued), V5_5 (Discontinued), V6, V6_MINI, and V6_WILD.
Values: style_persona, voice_persona
Default: style_persona

Pricing

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