Suno · Music Generation
Suno Music API · Introduction
Suno is the most full-featured AI music capability: generate a whole song from one sentence, plus extend, cover, mashup, split stems, make sound effects, add cover art, even train a custom style. Below we explain it in plain language, then link to every capability.
How to call (in 3 lines)
- Every capability goes to one endpoint:
POST /api/cqt/generator/suno; thetaskfield decides what you do. - You first get a
taskIdback — the music is not ready immediately. - Poll with the taskId:
GET /api/cqt/info/suno?id=taskIduntil status becomes success.
About pricing
Each call costs credits, varying by capability: 30 for a song, 10 for a sound effect, 60–150 for stem separation, 1–4 for small tools (lyrics/tags/export). Credits are auto-refunded if a task fails.
Model versions
Creation capabilities need a model: v55 (latest, recommended), v50、v45+、v45、v40. When unsure, use v55.
Capability map
Click any capability for details and live try-out:
Music Creation
POSTCreate New Music
Generate a brand-new song from scratch — just describe the style you want or provide lyrics.
POSTExtend Song
Continue an existing song to make it longer.
POSTCover
Re-perform an existing song in a new style (melody kept, style/arrangement changed).
POSTExtend Uploaded Audio
Continue generating from audio you uploaded.
POSTCover Uploaded Audio
Re-perform your uploaded audio in a new style.
POSTReuse Style with New Lyrics
Keep a song’s style but swap in your new lyrics.
POSTReplace Section
Redo only one part of a song (e.g. the second verse), keeping the rest.
POSTAdd Instrumental
Add backing instruments to a chosen section.
POSTAdd Vocals
Add sung vocals to a chosen instrumental section.
POSTMashup Two Songs
Blend two songs into a new one.
POSTSample
Take a snippet from existing music as inspiration to generate new music.
POSTGenerate Sound Effect
Generate a sound effect (not a song), e.g. thunder or footsteps.
Inspiration Playlist
Stem Separation
Enhance & AssetsNEW
POSTRemasterNEW
Re-optimize a song’s audio quality and clarity.
POSTCover ImageNEW
Generate a cover image for your song.
POSTStandalone VideoNEW
Generate accompanying video footage for music.
POSTCustom ModelNEW
Train a dedicated style model from audio you provide.
POSTVoice PersonaNEW
Extract a "voice persona" from a song to sing other songs later.
Audio EditingNEW
Helpers / Export
POSTGenerate Lyrics
Generate lyrics text only (no song).
POSTEnhance Tags
Expand your simple style tags into a richer description.
POSTUpload Audio
Upload external audio and get back a clip ID for other features.
POSTMerge Clips
Concatenate/merge multiple audio clips into one.
POSTExport MP4 / WAV / Timeline / Downbeats
Export a song to video (MP4), lossless audio (WAV), or get lyric timeline / beat data.
Common Errors
| Code | msg | Meaning | How to fix |
|---|---|---|---|
| 451 | artist name not allowed | Your description references a specific artist, which Suno does not allow. Message: "we don’t reference specific artists on Suno". | Remove the artist name and use style/genre words (e.g. pop, jazz, upbeat), then retry |
| 451 | content moderation | Prompt/lyrics rejected by content moderation | Edit the prompt or lyrics and retry |
| 401 | Unauthorized | Invalid or disabled API Key | Check the Authorization header and API Key |
| 402 | insufficient credits | Insufficient credits | Recharge in the console and retry |
| 429 | Task limit reached | Too many running tasks (concurrency limit) | Wait for running tasks to finish, then submit |
| 500 | failed / timeout | Task failed or request timed out | Retry later; contact support if it persists |
Tip: after saving your API Key via Authorize (top-right), every capability page supports "Try it".