Upload reference audio

Submit a publicly accessible reference-audio URL and obtain a track ID for covers, extensions, or adding vocals.

This API accepts audio_url in JSON, not a Multipart file upload. Use is_async to select synchronous or asynchronous processing.

POST/suno/mj/submit/upload

Authorization

bearerAuth

AuthorizationBearer <token>

Authenticate with Authorization: Bearer your-api-key.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

audio_url*string

Publicly accessible audio URL.

is_async?boolean

Whether to upload asynchronously; defaults to false. A successful synchronous upload usually returns music_id directly.

Defaultfalse

hookUrl?string

Optional user callback URL. Only ports 80, 443, 8080, and 8443 are supported. When provided, the platform forwards notifications to it.

Response Body

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/upload' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "audio_url": "https://example.com/reference-vocal.wav",
  "is_async": false
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "music_id": "MUSIC_ID"
  }
}

Process the upload result

Synchronous upload: is_async=false (default). After success, read the track ID from data.music_id.
Asynchronous upload: is_async=true. After submission, save data.jobId, then use Retrieve a task to wait for completion. The completed track ID is in data.data.data.musics[].musicId.

status: SUCCESS in an asynchronous submission response only means the task was accepted; it does not mean upload processing is complete. Supply the track ID as music_id to Cover music, Extend music, or Add vocals. A task ID cannot replace a track ID.

Authorization

Request Body

Response Body

200application/json

400application/json

Process the upload result

`application/json`

`application/json`