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
| Name | Type | Required | Description |
|---|---|---|---|
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_personaDefault:
style_persona |
Pricing
Price on request; the charge is settled from actual consumption with the music coefficient ×2.0. See Pricing & tokens.