Skip to main content
POST
Audio Upload
You can also submit through the unified task endpoint POST /v1/task/submit with model set to suno/upload and the parameters inside input. Both behave and bill the same.
When the task succeeds, the result is in data.result:
result.music_id is the ID of the uploaded track. Upload cover, upload extend, reference generation and other actions can use it directly.

Authorizations

Authorization
string
header
required

Send your API key in the Authorization: Bearer YOUR_API_KEY header.

Body

application/json
audio_url
string
required

Audio URL: A publicly downloadable audio URL. Eight minutes or less recommended. MP3, WAV, or M4A.

is_async
boolean
default:false

Async: Return a task ID immediately and fetch the result later. Off waits for completion.

notify_hook
string<uri>

Notify hook: when the task ends, the same content as the fetch result is POSTed to this URL (a public http / https URL). Omit it to poll instead.

Response

OK

code
enum<string>
required
Available options:
success
data
object
required
message
string