Featured track
ALL BLUE AND YOUchirp-v5-5
Slow cinematic electronic soul with warm Rhodes, deep sub-bass, and an intimate low male vocal.
Suno Music API
A complete Suno music workflow covering new songs, lyrics, extensions, covers, uploads, stems, editing, exports, analysis, and result retrieval.
InputPrompttext
Models8available
FlowAsyncresult URL
Pricefrom 0.5per paid operation
Examples
Prompt to music, in context
Example 01Nuisance
01 / 04 · chirp-v5-5
Now playing
Nuisance
Alternative R&B and dark indie folk with intimate tenor vocals and a late-night drift.
Creative brief
Alternative R&B, Dark Indie Folk, 78 Bpm, Fingerpicked Electric Chorus Guitar, Reverb-Striped Acoustic Guitar, Analog Synth Pads, Slow 808 Sub-Bass, Muted Kick-Snare Groove, Brushed Hi-Hats, Spring Reverb, Compressed Drum Bus, Intimate Melancholy, Late-Night Drift, Verse-Pre-Chorus-Chorus, Males Tenor Intimate Stereo Vocals
- BPM
- 78
- Vocals
- male tenor
Capabilities
What you can build with Suno Music API
Generate and write
Create complete songs in inspiration or custom mode, or generate lyrics independently.
Continue and reinterpret
Extend existing music, produce covers, and work from uploaded audio.
Deliver production parts
Fetch completed assets and separate vocals, instrumental, or a full set of stems.
Pricing
Per-action, in quota
Usage is metered in quota by model, action, and output settings.
OperationPriceUnit
Music · Extend · Cover · Add vocals · Add instrumental · Add stem6 quota/ task
Remaster · Mashup · Inspiration · Sample · MIDI · Replace section6 quota/ task
Stem separation12 quota/ task
All stems30 quota/ task
Crop · Remove section · Fade in · Fade out · Lyrics1 quota/ task
Adjust speed3 quota/ task
Sound effects1.2 quota/ task
Upload audio0.5 quota/ task
Create voice2 quota/ task
Concat · Persona · Aligned lyrics · Video · WAV · Vox · Upsample tags · BPMFree/ request
API request
Suno Music API operations and request fields
Use the endpoint below with your TTAPI key and the request fields shown.
/suno/v1/musicGenerate music from inspiration or custom lyrics.
Official reference/suno/v1/lyricsGenerate lyrics from a text brief.
Official reference/suno/v1/extendContinue an existing track from a selected point.
Official reference/suno/v1/coverCreate a cover version of an existing audio asset.
Official reference/suno/v1/uploadUpload audio for supported continuation and editing flows.
Official reference/suno/v1/stemsSeparate vocals, instrumental, or all available stems.
Official reference/suno/v1/stems-allCreate a full multi-track stem separation.
Official reference/suno/v1/add-vocalsAdd a generated vocal layer to an existing arrangement.
Official reference/suno/v1/add-instrumentalBuild an instrumental layer around existing audio.
Official reference/suno/v1/replace-sectionRegenerate a selected section of a song.
Official reference/suno/v1/remasterProduce a polished remaster of an existing track.
Official reference/suno/v1/mashupCombine songs or ideas into a blended output.
Official reference/suno/v1/cropTrim a selected time range from a track.
Official reference/suno/v1/adjust-speedChange playback speed with optional pitch preservation.
Official reference/suno/v1/wavExport a completed song as high-quality WAV audio.
Official reference/suno/v1/gen-midiExport generated music as MIDI for further editing.
Official reference/suno/v1/gen-bpmDetect a song's tempo and beat speed.
Official reference/suno/v2/fetchRetrieve the status and result of a Suno task.
Official referenceHeaders
TT-API-KEYstringrequiredYour TTAPI API key.
Content-TypestringrequiredUse application/json.
Body
custombooleanrequiredUse custom lyrics mode when true.
instrumentalbooleanrequiredGenerate a track without vocals when true.
mvenumrequiredSuno model version, such as chirp-v5-5 or chirp-v5.
gpt_description_promptstringconditionalCreative brief required for inspiration mode.
promptstringconditionalLyrics required for custom mode.
titlestringoptionalTrack title.
tagsstringoptionalGenre, mood, instrumentation, and vocal style tags.
negative_tagsstringoptionalStyles or traits to avoid.
hookUrlstringoptionalCallback URL for completion.
Integrate
From key to first result
Copy the resolved endpoint, authentication headers, and request body for this model.
curl --request POST \
--url https://api.ttapi.io/suno/v1/music \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{"custom":false,"instrumental":false,"mv":"chirp-v5-5","gpt_description_prompt":"slow cinematic electronic soul, 75 BPM, deep sub-bass, warm Rhodes piano, soft brushes, atmospheric pads, intimate low male vocal","title":"ALL BLUE AND YOU","tags":"cinematic electronic soul, melancholic, warm analog","hookUrl":"https://example.com/webhooks/suno"}'Related
