Skip to main content
POST
Multi-format Export
You can also submit through the unified task endpoint POST /v1/task/submit with model set to suno/download and the parameters inside input. Both behave and bill the same.
When the task succeeds, the result is in data.result:
result.files lists one download per format: format is the format and file_url is the URL.

Authorizations

Authorization
string
header
required

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

Body

application/json
music_id
string
required

Source Track: The track to work on. Use the music_id from an earlier result.

formats
string[]
required

Formats: Audio formats to export. You can pick more than one.

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