Suno Music API

by SunoMusic

A complete Suno music workflow covering new songs, lyrics, extensions, covers, uploads, stems, editing, exports, analysis, and result retrieval.

View examples API reference

InputPrompttext

Models8available

FlowAsyncresult URL

Pricefrom 0.5per paid operation

ALL BLUE AND YOU cover

Featured track

ALL BLUE AND YOUchirp-v5-5

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-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.

Suno operationsOfficial pricing

OperationPriceUnit

Music · Extend · Cover · Upload Cover · Upload Extend · 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.

MusicPOST

/suno/v1/music

Generate music from inspiration or custom lyrics.

Official reference

LyricsPOST

/suno/v1/lyrics

Generate lyrics from a text brief.

Official reference

ExtendPOST

/suno/v1/extend

Continue an existing track from a selected point.

Official reference

CoverPOST

/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

UploadPOST

/suno/v1/upload

Upload audio for supported continuation and editing flows.

Official reference

StemsPOST

/suno/v1/stems

Separate vocals, instrumental, or all available stems.

Official reference

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

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

CropPOST

/suno/v1/crop

Trim a selected time range from a track.

Official reference

Adjust SpeedPOST

/suno/v1/adjust-speed

Change playback speed with optional pitch preservation.

Official reference

WAV ExportPOST

/suno/v1/wav

Export a completed song as high-quality WAV audio.

Official reference

MIDI ExportPOST

/suno/v1/gen-midi

Export generated music as MIDI for further editing.

Official reference

BPM AnalysisPOST

/suno/v1/gen-bpm

Detect a song's tempo and beat speed.

Official reference

Fetch V2GET

/suno/v2/fetch

Retrieve the status and result of a Suno task.

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

Suno model version, such as chirp-v5-5 or chirp-v5.

audio_urlstringconditional

Public audio URL required by Upload Cover and Upload Extend; the source audio should be no longer than eight minutes.

continue_atnumberconditional

Upload Extend only: second at which extension begins. Must be at least 1 and shorter than the source audio duration.

gpt_description_promptstringconditional

Creative brief required for inspiration mode.

promptstringconditional

Lyrics required for custom mode.

titlestringoptional

Track title.

tagsstringoptional

Genre, mood, instrumentation, and vocal style tags.

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

Optional Suno persona used to apply a specific music style.

isStoragebooleanoptional

Defaults to true. Store the result on TTAPI CDN when enabled.

hookUrlstringoptional

Callback URL for completion.

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-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"}'