Suno Music API

by SunoMusic

Suno API on TTAPI provides Suno v6 music generation for songs and lyrics. Create custom models, covers, stems, edits, downloads, analysis, and async result workflows.

InputPrompttext

Models3available

FlowAsyncresult URL

Pricefrom 0.2per paid operation

ALL BLUE AND YOU cover

Featured track

ALL BLUE AND YOUchirp-v6

Slow cinematic electronic soul with warm Rhodes, deep sub-bass, and an intimate low male vocal.

BPM75Vocalslow male

Examples

Prompt to music, in context

Example 01Nuisance

01 / 04 · chirp-v6

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.

Customize and reinterpret

Train a reusable model from 6–24 tracks, then extend, cover, or transform existing music.

Deliver production parts

Fetch results, download mp3, m4a, or wav files, and separate vocals or a full set of stems.

Pricing

Per-action, in quota

Usage is metered in quota by model, action, and output settings.

Suno operationsOfficial pricing

OperationPriceUnit

Music · Extend · Cover · Upload Cover · Upload Extend · Add vocals · Add instrumental · Add stem6 quota/ task

Remaster · Mashup · Inspo · 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

Create model60 quota/ task

File download · WAV (deprecated)0.2 quota/ request

Concat · Persona · Aligned lyrics · Video · Upsample tags · BPMFree/ request

max_mode=true2× base quota/ generation

API request

Suno Music API operations and request fields

Use the endpoint below with your TTAPI key and the request fields shown.

Generate MusicPOST

/suno/v1/music

Generate music from inspiration or custom lyrics.

Official reference

Generate LyricsPOST

/suno/v1/lyrics

Generate lyrics from a text brief.

Official reference

Extend SongPOST

/suno/v1/extend

Continue an existing track from a selected point.

Official reference

Cover StylePOST

/suno/v1/cover

Create a cover version of an existing audio asset.

Official reference

Upload CoverPOST

/suno/v1/upload-cover

Upload a public audio URL and generate a cover in one request.

Official reference

Upload ExtendPOST

/suno/v1/upload-extend

Upload a public audio URL and extend it from a selected point in one request.

Official reference

Upload AudioPOST

/suno/v1/upload

Upload audio for supported continuation and editing flows.

Official reference

Stem ExtractionPOST

/suno/v1/stems

Separate vocals, instrumental, or all available stems.

Official reference

Split All StemsPOST

/suno/v1/stems-all

Create a full multi-track stem separation.

Official reference

Add VocalsPOST

/suno/v1/add-vocals

Add a generated vocal layer to an existing arrangement.

Official reference

Add InstrumentalPOST

/suno/v1/add-instrumental

Build an instrumental layer around existing audio.

Official reference

Add StemPOST

/suno/v1/add-stem

Layer an additional generated stem onto an existing track.

Official reference

Replace SectionPOST

/suno/v1/replace-section

Regenerate a selected section of a song.

Official reference

RemasterPOST

/suno/v1/remaster

Produce a polished remaster of an existing track.

Official reference

MashupPOST

/suno/v1/mashup

Combine songs or ideas into a blended output.

Official reference

InspoPOST

/suno/v1/inspo

Generate a track from one to four inspiration audio URLs.

Official reference

Sample to SongPOST

/suno/v1/sample

Turn a source sample into a complete song.

Official reference

Generate SoundsPOST

/suno/v1/sounds

Generate a standalone sound effect from a prompt.

Official reference

Crop TrackPOST

/suno/v1/crop

Trim a selected time range from a track.

Official reference

Remove SectionPOST

/suno/v1/remove-section

Delete a selected time range from a track.

Official reference

Fade InPOST

/suno/v1/fade-in

Apply a fade-in to a completed track.

Official reference

Fade OutPOST

/suno/v1/fade-out

Apply a fade-out to a completed track.

Official reference

Adjust SpeedPOST

/suno/v1/adjust-speed

Change playback speed with optional pitch preservation.

Official reference

Concatenate TrackPOST

/suno/v1/concat

Concatenate completed song segments into one track.

Official reference

Generate MIDIPOST

/suno/v1/gen-midi

Export generated music as MIDI for further editing.

Official reference

Aligned LyricsPOST

/suno/v1/alignedLyrics

Retrieve word-level aligned lyrics for a track.

Official reference

Generate VideoPOST

/suno/v1/generateVideo

Create a music video for a completed song.

Official reference

File DownloadPOST

/suno/v1/download

Prepare mp3, m4a, or wav files for delivery; cache returned URLs to avoid repeat charges.

Official reference

Create VoicePOST

/suno/v1/create-voice

Create a reusable Suno voice from a completed song.

Official reference

Create ModelPOST

/suno/v1/create-model

Train a private custom model from 6–24 public reference tracks.

Official reference

PersonaPOST

/suno/v1/persona

Create a reusable Suno persona from an existing song.

Official reference

Upsample TagsPOST

/suno/v1/upsample-tags

Enhance a short style prompt into richer music tags.

Official reference

BPM AnalysisPOST

/suno/v1/gen-bpm

Detect a song's tempo and beat speed.

Official reference

Fetch Result V2GET

/suno/v2/fetch

Retrieve the status and result of a Suno task.

Official reference

Export WAV deprecatedPOST

/suno/v1/wav

Legacy WAV export; migrate to File Download.

Official reference

Extract Vox deprecatedPOST

/suno/v1/vox

Legacy vocal extraction endpoint.

Official reference

Fetch Result deprecatedGET

/suno/v1/fetch

Legacy task retrieval endpoint; migrate to Fetch Result V2.

Official reference

POSThttps://api.ttapi.io/suno/v1/music

Headers

TT-API-KEYstringrequired

Your TTAPI API key.

Content-Typestringrequired

Use application/json.

Body

custombooleanrequired

Use custom lyrics mode when true.

instrumentalbooleanrequired

Generate a track without vocals when true.

mvenumrequired

chirp-v6, chirp-v6-wild, chirp-v6-mini, or chirp-custom:{model_id}. Legacy model names map to chirp-v6.

gpt_description_promptstringconditional

Creative brief required in inspiration mode (custom=false), up to 3,000 characters.

promptstringconditional

Lyrics used in custom mode, required when instrumental=false, up to 5,000 characters.

titlestringoptional

Custom-mode track title, up to 80 characters.

tagsstringoptional

Custom-mode genre, mood, instrumentation, and vocal style tags, up to 1,000 characters.

negative_tagsstringoptional

Styles or traits to avoid.

style_weightnumberoptional

Custom-mode style weight from 0 to 1.

weirdness_constraintnumberoptional

Custom-mode creativity weight from 0 to 1.

audio_weightnumberoptional

Custom-mode source-audio weight from 0 to 1.

durationintegeroptional

Custom-mode output duration from 10 to 360 seconds.

auto_lyricsbooleanoptional

Custom-mode option to reinterpret the supplied lyrics automatically.

vocal_genderenumoptional

Optional vocal gender: Male or Female.

persona_idstringoptional

Custom-mode Suno persona. Cannot be combined with mv=chirp-custom:{model_id}.

audio_formatenumoptional

Audio result format: mp3, m4a, or wav.

varietyenumoptional

Style variety: off, normal, high, extra, or max.

max_modebooleanoptional

Custom-mode consistency boost. Defaults to false and doubles quota consumption when enabled.

hookUrlstringoptional

Callback URL for completion.

isStoragebooleanoptional

Deprecated. Defaults to true and controls whether the result is stored on TTAPI CDN.

Open the official TTAPI documentation

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-v6","gpt_description_prompt":"slow cinematic electronic soul, 75 BPM, deep sub-bass, warm Rhodes piano, soft brushes, atmospheric pads, intimate low male vocal","audio_format":"mp3","variety":"normal","hookUrl":"https://example.com/webhooks/suno"}'