Skip to main content
POST
This endpoint has no version dimension: do not pass version — if passed, it is discarded and does not affect billing.
Known limitation: Do not upload purely instrumental (vocal-free) audio — the upstream may fail to parse it.

Authorizations

Authorization
string
required
All endpoints require authentication using a Bearer TokenGet an API Key:Visit the API Key management page to get your API KeyAdd the following to the request headers when using it:

Body

model
string
default:"suno"
Audio model. Currently pass suno (defaults to suno if omitted).
audioFilePath
string
required
A publicly accessible direct audio URL. If missing, a 400 is returned at submission time (no upstream call, no charge).
Getting the result: This endpoint is an async task. After submitting you get a task_id; poll GET /v1/music/tasks/{task_id} at 3–5s intervals until status is completed or failed (while generating, status is pending and progress goes queued 10 → ready 50 → done 100). Once complete, use this job’s task_id + audio_index=1 as the source for other operations. On failure data.error.message gives the reason and the pre-deducted quota is automatically refunded.

Response

code
integer
Response status code
data
array
Returned data array