Skip to main content
POST
/
suno
/
v2
/
audio
/
upload
/
session
/
item
upload one audio to the session-bound account
curl --request POST \
  --url https://api.mountsea.ai/suno/v2/audio/upload/session/item \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sessionId": "e3f2c1a0-1234-5678-abcd-000000000000",
  "audioUrl": "https://example.com/audio.mp3"
}
'
{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}
Upload a single audio file using the account bound in Prepare Upload Session.
Async — returns taskId. Poll Get Task Status with the item taskId for clip details. The clip ID is also appended to the session’s audioIds list automatically.
FieldTypeRequiredDescription
sessionIdstring (UUID)YesFrom Step 1
audioUrlstring (URL)YesPublicly downloadable audio URL
Multiple items may be submitted concurrently with the same sessionId — they still share one account.
Part of Batch Upload Session. Poll the sessionId (not item taskId) to get all audioIds when batch upload finishes.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
sessionId
string<uuid>
required

uploadSession/prepare 返回的 sessionId

Example:

"e3f2c1a0-1234-5678-abcd-000000000000"

​
audioUrl
string<uri>
required

要上传的音频 URL（可公网访问）

Example:

"https://example.com/audio.mp3"

Response

201 - application/json
​
taskId
string
required

task id. Use this id to query task status.

Example:

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