Suno Music
Extend & Upload
extend an existing song; uploadTask/uploadCover/uploadExtend for uploaded audio
All four operations share one entry point; the {operation} path segment selects the behavior:
POST https://toapis.com/v1/music/generations/{operation}Authorizations
AuthorizationstringheaderrequiredBearer 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.
modelstringbodyrequiredFixed
"suno"task_idstringbodyrequiredSource task ID
continue_atnumberbodyrequiredResume point (seconds)
audio_indexnumberbodyTrack index when the task has multiple tracks
promptstringbodyContinuation lyrics (custom mode)
titlestringbodyTitle
stylestringbodyStyle tags
max_modebooleanbodyMax 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.
modelstringbodyrequiredFixed
"suno"audioFilePathstringbodyrequiredPublicly 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)
modelstringbodyrequiredFixed
"suno"audio_urlstringbodyrequiredSource audio URL
custombooleanbodyCustom lyrics mode
promptstringbodyLyrics (custom=true) or description
gpt_descriptionstringbodyInspiration description (required when custom=false)
stylestringbodyTarget style
persona_idstringbodyVocal persona, mutually exclusive with
custom_model_idmax_modebooleanbodyMax tier
uploadExtend — upload + extend ($0.05, Max $0.10)
Upload audio and continue it from a timestamp. Always treated as custom mode.
modelstringbodyrequiredFixed
"suno"audio_urlstringbodyrequiredSource audio URL
continue_atnumberbodyrequiredResume point (seconds)
promptstringbodyContinuation lyrics
stylestringbodyStyle
max_modebooleanbodyMax tier
Response
task_idstringTask ID for status polling
statusstringsubmitted