Skip to main content
POST
Suno Upload
suno-upload imports a public audio file as a Suno track, so later operations can use it as a source. Confirm live rates on the SnapGen models page. Failed tasks are not charged.
string
required
Set to suno-upload.
string
required
Public http or https URL of the audio to import.
string
Optional public https URL that receives one signed event when the task finishes. See Task webhooks.
string
Required with webhook: 16 to 256 characters, used to sign the delivery.

Request

The response is HTTP 202 with a task object and a Location: /v1/tasks/{id} header. Poll GET /v1/tasks/{id} every 10 to 20 seconds until status is succeeded or failed.

Result

result.tracks[0] is the imported track. It may carry only its id and no audio_url; it still works as a source. Pass this task’s id as source_task_id, with source_index 1, to edit the track.
Result URLs are kept for about 72 hours. Download the files you want to keep. See Music generation tasks for the task lifecycle, result fields, webhooks, and errors.