ToAPIsToAPIs
Suno Music

Extend & Upload

extend an existing song; uploadTask/uploadCover/uploadExtend for uploaded audio

POST
/v1/music/generations/extend

All four operations share one entry point; the {operation} path segment selects the behavior:

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

Authorizations

Authorizationstringheaderrequired

Bearer Token. Get your API Key: API Key management

extend — continue a song ($0.05, Max $0.10)

Continue generation from a timestamp of an existing task. custom defaults to true for extend.

modelstringbodyrequired
Fixed "suno"
task_idstringbodyrequired
Source task ID
continue_atnumberbodyrequired
Resume point (seconds)
audio_indexnumberbody
Track index when the task has multiple tracks
promptstringbody
Continuation lyrics (custom mode)
titlestringbody
Title
stylestringbody
Style tags
max_modebooleanbody
Max tier $0.10
curl --request POST \
  --url https://toapis.com/v1/music/generations/extend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","task_id":"tsk_aud_xxx","continue_at":60,"prompt":"[Chorus] ..."}'

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.

modelstringbodyrequired
Fixed "suno"
audioFilePathstringbodyrequired
Publicly accessible audio URL
Send only model + audioFilePath; extra fields such as version are rejected upstream.
curl --request POST \
  --url https://toapis.com/v1/music/generations/uploadTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","audioFilePath":"https://example.com/my-vocals.mp3"}'

uploadCover — upload + cover ($0.05, Max $0.10)

modelstringbodyrequired
Fixed "suno"
audio_urlstringbodyrequired
Source audio URL
custombooleanbody
Custom lyrics mode
promptstringbody
Lyrics (custom=true) or description
gpt_descriptionstringbody
Inspiration description (required when custom=false)
stylestringbody
Target style
persona_idstringbody
Vocal persona, mutually exclusive with custom_model_id
max_modebooleanbody
Max tier

uploadExtend — upload + extend ($0.05, Max $0.10)

Upload audio and continue it from a timestamp. Always treated as custom mode.

modelstringbodyrequired
Fixed "suno"
audio_urlstringbodyrequired
Source audio URL
continue_atnumberbodyrequired
Resume point (seconds)
promptstringbody
Continuation lyrics
stylestringbody
Style
max_modebooleanbody
Max tier

Response

task_idstring
Task ID for status polling
statusstring
submitted