Skip to main content
For coding agents, discover the current recommended music shortlist first with GET /v1/models?recommended_for=music, then send the selected model explicitly to this endpoint.
Generate music and lyrics using AI. This is an asynchronous API. Create responses return a task identity, and may also return a preferred poll_url for status checks.

Request Body

string
default:"suno_music"
Model to use: suno_music for music generation, suno_lyrics for lyrics only.
string
Music description. Required for music, lyrics, upload-cover, and upload-extend requests; omit for add-instrumental.
string
Title for the generated song.
string
Style tags (e.g., “pop, upbeat, electronic”).
string
Styles to avoid. Required when audio_operation is add-instrumental.
string
Generation type: MUSIC (default) or LYRICS.
string
Official Suno model version. Required for music generation (when action is omitted or MUSIC); omit for lyrics-only requests. Supported values: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.
boolean
Set to true to generate instrumental output without vocals.
string
Publicly reachable reference or uploaded audio URL. When provided without audio_operation, AI Sonar uses the upload-cover flow.
string
Uploaded-audio mode: upload-cover, upload-extend, or add-instrumental. upload-extend requires continue_at; add-instrumental requires audio_url, title, tags, and negative_tags.
string
ID of a previous clip to continue from.
number
Timestamp (in seconds) to continue from. Required when audio_operation is upload-extend.

Response

string
Task ID for polling status.
string
Async task identifier alias when returned by the adapter.
string
Preferred polling URL for this task when provided.
string
Task status: pending, processing, completed, or failed.
integer
Unix timestamp of task creation.