Skip to main content
POST

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).
version
string
default:"v5.5"
Generation version: only v5 / v5.5; defaults to v5.5 if omitted.
prompt
string
required
Sound effect text description (mapped to the upstream sound). If missing, a 400 is returned at submission time (no upstream call, no charge).
type
string
default:"one-shot"
Sound effect type: one-shot (default, single hit) / loop (loopable).
bpm
integer
Tempo, 1300; out-of-range values return 400 directly at submission time.
key
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).
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). On completion take audio_url from data.result.music[]. 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