Generate 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": {
    "custom_mode": "\u2026",
    "instrumental": "\u2026",
    "model": "V6"
  },
  "model": "suno-generate-music"
}

Input parameters

Name	Type	Required	Description
`prompt`	string	optional	A description of the desired audio content. Optional. - Custom mode (`custom_mode=true`): When provided, the prompt is used strictly as lyrics and sung in the generated track. Character limits by model: - V4: Maximum 3000 characters - V4_5, V4_5PLUS, V4_5ALL, V5_5, V5: Maximum 5000 characters - Non-custom mode (`custom_mode=false`): When provided, the prompt serves as the core idea. Lyrics are generated automatically based on it and do not strictly match the input. Maximum 3000 characters. `prompt` is not required. In non-custom mode, provide at least one of `image_urls`, `video_urls`, `audio_
`style`	string	optional	Music style specification for the generated audio. - Character limits by model: - V4 (Discontinued): Maximum 200 characters - V4_5 and V4_5PLUS (Discontinued): Maximum 1000 characters - V4_5ALL (Discontinued): Maximum 1000 characters - V5_5 and V5 (Discontinued): Maximum 1000 characters - V6, V6_MINI, and V6_WILD: Maximum 1000 characters - Common examples: Jazz, Classical, Electronic, Pop, Rock, Hip-hop, etc.
`title`	string	optional	Title for the generated music track. - Required in Custom Mode (`custom_mode: true`). - Max length: 80 characters. - Will be displayed in player interfaces and filenames.
`custom_mode`	boolean	required	Determines whether advanced parameter customization is enabled. - If `true`: Allows detailed control - If `false`: Simplified mode
`instrumental`	boolean	required	Determines whether the audio should be instrumental (no lyrics). - In Custom Mode (`custom_mode: true`): - If `true`: Only `style` and `title` are required. - If `false`: `style`, `title`, and `prompt` are required (`prompt` is used as the exact lyrics). - In Non-custom Mode (`custom_mode: false`): - If `true`: Only `style` and `prompt` are required. - If `false`: `style`, `prompt`, and `lyrics` are required (`lyrics` is used as a lyrics attachment and can be used together with the audio description in `prompt`).
`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_MINI`, `V6_WILD` Default: `V6`
`negative_tags`	string	optional	Music styles or traits to exclude from the generated audio. Optional. Use to avoid specific styles.
`vocal_gender`	string	optional	Vocal gender preference. Optional. Use `m` for male and `f` for female. This parameter is only effective when `custom_mode` is true. In practice, it only increases probability and cannot guarantee male/female voice instructions are followed. Values: `m`, `f`
`style_weight`	number	optional	Only available when Custom Mode (`custom_mode: true`) is enabled. Strength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.
`weirdness_constraint`	number	optional	Only available when Custom Mode (`custom_mode: true`) is enabled. Controls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.
`audio_weight`	number	optional	Only available when Custom Mode (`custom_mode: true`) is enabled. Relative weight of audio features. Optional. Range 0–1, up to 2 decimal places. - `audio_weight` is not supported when there are no vocals
`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. Only available for V5 (Discontinued), V5.5 (Discontinued), V6, V6_MINI, and V6_WILD. Values: `style_persona`, `voice_persona`
`duration`	number	optional	Audio duration. Optional; only valid when `custom_mode` is true and the model is V5_5 (Discontinued), V6, V6_MINI, or V6_WILD. Default: `20`
`image_urls`	array	optional	Image references. Only effective when `custom_mode=false`. - Optional - Up to 5 images; each image must not exceed 10 MB - Supported formats: `jpeg`, `png`, `webp`, and `bmp`
`variety`	number	optional	Only available when Custom Mode (`custom_mode: true`) is enabled. Controls the diversity and stylistic variation of generated results. Optional. Range 0–4, integer, 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 Default: `1`
`lyrics`	string	optional	Lyrics for the generated audio. Optional. - V6: Maximum 5000 characters. - When `custom_mode=true`, `lyrics` is used as lyrics first; if `lyrics` is not provided, `prompt` is used as lyrics. - When `custom_mode=false`, `lyrics` is used as a lyrics attachment and can be used together with the audio description in `prompt`.
`audio_urls`	array	optional	Audio references. Only effective when `custom_mode=false`. - Optional - Audio duration must be between 6 seconds and 30 minutes; each audio file must not exceed 500 MB
`video_urls`	array	optional	Video references. Only effective when `custom_mode=false`. - Optional - Up to 1 video file; each file must not exceed 100 MB, duration must not exceed 241 seconds, with no minimum duration - Supported formats: mp4, mov, and webm

Pricing

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