Skip to main content
POST
/
suno
/
v2
/
upload
upload audio to suno
curl --request POST \
  --url https://api.mountsea.ai/suno/v2/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "audioUrl": "<string>"
}
'
{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}
Upload an audio file by providing its URL. Suno will download and process the file. The uploaded audio can then be used with upload_extend or upload_cover tasks in the Generate endpoint.
This is an async task. The response contains a taskId — use Get Task Status to poll for the upload result, which will contain the clip_id needed for subsequent operations.
The audioUrl must be a publicly accessible URL that our servers can download. Supported formats include MP3, WAV, and other common audio formats.
Each single upload may use a different Suno account. To upload multiple files on the same account (for Inspiration, Persona, etc.), use Batch Upload Session instead.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
audioUrl
string<uri>
required

The audio url to upload, must be a url that we can download

Response

201 - application/json
​
taskId
string
required

task id. Use this id to query task status.

Example:

"15c257ff-43f7-4678-bd41-202ad6b8488b"