ToAPIsToAPIs
Suno Music

Suno Music

Suno AI music generation and editing APIs: task lifecycle and pricing

Suno provides a complete AI music workflow: generation, extension, editing, stem separation, and analysis. All operations share a single submission endpoint, differentiated by the {operation} path segment:

POST https://toapis.com/v1/music/generations/{operation}

All operations are asynchronous tasks: submit, receive a task ID, then poll the task status endpoint for results. Returned media URLs (audio, cover images, video) are persisted on our CDN and remain accessible.

Authorizations

Authorizationstringheaderrequired

Authenticate with a Bearer Token.

Get your API Key: API Key management

Authorization: Bearer YOUR_API_KEY

Conventions

  • model in the request body is always "suno"
  • Operations on existing work take task_id (local IDs, tsk_aud_ prefix); some also accept audio_index to pick a track
  • custom controls the mode: true = custom lyrics mode (prompt is lyrics; title/style/negative_tags apply); false/omitted = inspiration mode (prompt/gpt_description describes the music)
  • max_mode is the high-quality tier at 2× price, only for operations marked Max below; operations with a custom field require effective custom=true for it to apply

Operations & Pricing

Generation

operationDescriptionPriceMax
generationMusic generation (default)$0.05$0.10
lyricsLyrics generation$0.008-
inspoReference-audio inspired generation$0.068$0.136
soundsSound effect generation$0.0096-
upsampleTagsStyle tag expansion$0.004-

Upload

operationDescriptionPriceMax
uploadTaskRegister uploaded audio as a task$0.004-
uploadCoverUpload + cover$0.05$0.10
uploadExtendUpload + extend$0.05$0.10

Extend & Transform

operationDescriptionPriceMax
extendContinue from a timestamp$0.05$0.10
coverSongRe-sing in a new style$0.05$0.10
remasterAudio remaster$0.05-
mashupBlend two songs$0.05$0.10
replaceMusicRewrite a section$0.05$0.10
sampleResample a section (upload sources only)$0.05$0.10

Stems

operationDescriptionPrice
stemsVocal / instrumental split$0.10
stemsAllFull instrument separation$0.24
addStemAdd an instrument track$0.05 (Max $0.10)
addVocalsAdd vocals to an upload$0.05 (Max $0.10)
addInstrumentalAdd backing to an upload$0.05 (Max $0.10)

Editing

operationDescriptionPrice
cropKeep a time range$0.008
removeSectionRemove a time range$0.008
fadeInIntro fade-in$0.008
fadeOutOutro fade-out$0.008
adjustSpeedTempo change (optional pitch lock)$0.024
concatJoin extend segments$0.004

Analysis & Export

operationDescriptionPrice
midiAudio → MIDI note data$0.05
bpmBPM analysis$0.0008
alignedLyricsLyrics timing alignment$0.0008
downloadMulti-format download (mp3/m4a/wav)$0.0016
generateMp4Lyric video$0.004
wavWAV download (legacy, use download)$0.0016

Assets (advanced)

operationDescriptionPrice
personaExtract a vocal persona$0.004
createVoiceVoice cloning (needs clean vocals)$0.016
voxVocal extraction (legacy, use persona)$0.004
createModelCustom model training (6-24 tracks)$0.96

Task Lifecycle

submitted → queued / in_progress → completed / failed

Pre-charged quota is refunded automatically when a task fails. See music task status.

On this page