Skip to main content
POST

Authorizations

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

string
default:"suno"
Audio model. Currently pass suno (defaults to suno if omitted).
string
default:"v6"
Public version: v6 / v6-wild / v6-mini; omitted by default: v6.
string
required
Sound effect text description. If missing, a 400 is returned at submission time (no charge). Prefer English prompts for the best results.
string
default:"one-shot"
Sound effect type: one-shot (default, single hit) / loop (loopable).
integer
Tempo, 1–300; out-of-range values return 400 directly at submission time.
string
Musical key enum: major keys C / C# / D / D# / E / F / F# / G / G# / A / A# / B; minor keys append m (Cm / C#m / … / Bm). Only sharp (#) notation is supported; flats (Db / Eb, etc.) and B# return 400 (key param error).
string
Output audio format: mp3 / m4a / wav.
This interface does not support custom models, Max, variety, or the target duration field.
Get Result: This API is an asynchronous task. After submission, get task_id and poll GET /v1/music/tasks/{task_id} every 3–5s until status is completed or failed (status may be pending or processing, and progress should be a whole number between 0 and 100, not guaranteed to change at fixed intervals). Once completed, get data.result.music[] for audio_url. If it fails, data.error.message contains the reason, and the deducted amount is automatically refunded.

Response

integer
Response status code
array
Returned data array