Music models › Suno

Upload And Extend Audio

Upload And Extend Audio

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",
    "upload_url": "\u2026"
  },
  "model": "suno-upload-and-extend-audio"
}

Input parameters

NameTypeRequiredDescription
upload_url string required 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.
instrumental boolean optional 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
prompt string optional 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`.
style string optional 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 - **V5_5 & V5** (Discontinued): Maximum 1000 characters - **V4_5PLUS & V4_5** (Discontinued): Maximum 1000 characters - **V4_5ALL** (Discontinued): Maximum 1000 characters - **V4** (Discontinued): Maximum 200 characters
title string optional Music title. Optional. - Maximum 100 characters. - Displayed in player interfaces and filenames.
continue_at number optional 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.
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 min
Values: V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5, V6, V6_WILD, V6_MINI
negative_tags string optional Music styles to exclude from generation
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. Do not pass this parameter when `instrumental` is `true`.
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.
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 The persona model is only available for models version V5 (Discontinued), V5_5 (Discontinued), V6, V6_MINI, and V6_WILD.
Values: style_persona, voice_persona
lyrics string optional 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`.
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.