Skip to main content
POST
Extend & Upload
All four operations share one entry point; the {operation} path segment selects the behavior:

Authorizations

string
required
Bearer Token. Get your API Key: API Key management

extend — continue a song (0.05,Max0.05, Max 0.10)

Continue generation from a timestamp of an existing task. custom defaults to true for extend.
string
required
Fixed "suno"
string
required
Source task ID
number
required
Resume point (seconds)
number
Track index when the task has multiple tracks
string
Continuation lyrics (custom mode)
string
Title
string
Style tags
boolean
Max tier $0.10

uploadTask — register an upload ($0.004)

Registers a public audio URL as a task. Its product is the required source for sample/addVocals/addInstrumental/addStem.
string
required
Fixed "suno"
string
required
Publicly accessible audio URL
Send only model + audioFilePath; extra fields such as version are rejected upstream.

uploadCover — upload + cover (0.05,Max0.05, Max 0.10)

string
required
Fixed "suno"
string
required
Source audio URL
boolean
Custom lyrics mode
string
Lyrics (custom=true) or description
string
Inspiration description (required when custom=false)
string
Target style
string
Vocal persona, mutually exclusive with custom_model_id
boolean
Max tier

uploadExtend — upload + extend (0.05,Max0.05, Max 0.10)

Upload audio and continue it from a timestamp. Always treated as custom mode.
string
required
Fixed "suno"
string
required
Source audio URL
number
required
Resume point (seconds)
string
Continuation lyrics
string
Style
boolean
Max tier

Response

string
Task ID for status polling
string
submitted