Skip to main content
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:
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

​
string
required
Authenticate with a Bearer Token.Get your API Key: API Key management

​
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

​
Upload

​
Extend & Transform

​
Stems

​
Editing

​
Analysis & Export

​
Assets (advanced)

​
Task Lifecycle

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

Generation

generation / inspo / sounds / lyrics

Extend & Upload

extend / uploadTask / uploadCover / uploadExtend

Edit & Transform

crop / fadeIn / fadeOut / replaceMusic / mashup / …

Analysis & Export

midi / bpm / alignedLyrics / download / generateMp4