Music models
| Model | Slug | Max duration | Formats | Operations |
|---|---|---|---|---|
| Suno V4 | suno-v4 | 240s | mp3, wav | generate, extend, upload_cover, upload_extend, vocal_removal, lyrics |
| Suno V4.5 | suno-v4-5 | 240s | mp3, wav | generate, extend, upload_cover, upload_extend, vocal_removal, lyrics |
| Suno V4.5 Plus | suno-v4-5-plus | 240s | mp3, wav | generate, extend, upload_cover, upload_extend, vocal_removal, lyrics, add_vocals, add_instrumental |
| Suno V5 | suno-v5 | 240s | mp3, wav | generate, extend, upload_cover, upload_extend, vocal_removal, lyrics, add_vocals, add_instrumental, sounds |
| Suno V5.5 | suno-v5-5 | 240s | mp3, wav | generate, extend, upload_cover, upload_extend, vocal_removal, lyrics, add_vocals, add_instrumental, sounds |
Operations
- generate — Create a new song from a text prompt. Use
custom_mode: truefor full control over style, title and lyrics. - extend — Continue an existing track from a specific timestamp (
continue_at). Requiresaudio_id. - upload_cover — Create a cover version from an uploaded audio file (
upload_url). - upload_extend — Extend an uploaded audio file.
- add_vocals — Add vocals to an instrumental track (V4.5 Plus+).
- add_instrumental — Add instrumental backing to a vocal track (V4.5 Plus+).
- vocal_removal — Separate vocals from a track. Use
separation_type: "split_stem"for up to 12 stems. - sounds — Generate short sound effects (V5+). Supports
sound_loop,sound_tempo,sound_key. - lyrics — Generate lyrics from a prompt (low cost).
Custom mode parameters
Whencustom_mode: true:
title— Track title (max 100 chars)style— Genre/style description (max 1000 chars)lyrics— Full lyrics textinstrumental— Settruefor instrumental onlynegative_tags— Styles to excludevocal_gender—"m"or"f"persona_id/persona_model— Apply a saved voice persona
Tuning parameters
style_weight(0–1) — How closely to follow the style promptaudio_weight(0–1) — How much input audio influences the outputweirdness_constraint(0–1) — Creativity/novelty level

