Skip to main content
POST

Headers

Authorization
string
required

Bearer API key, e.g. Bearer sk-....

Example:

"Bearer sk-..."

Body

application/json

Suno music submit body (custom / description modes).

prompt
string

Lyrics or song text (custom mode).

Example:

"[Verse]\nCity lights on wet asphalt\n[Chorus]\nWe keep walking through the neon rain"

tags
string

Style tags, e.g. genre / mood / instruments.

Example:

"cinematic indie pop, atmospheric, neon"

title
string

Track title.

Example:

"Neon Rain"

mv
string

Model version / clip engine (e.g. chirp-v4, chirp-auk). Upstream-dependent.

Example:

"chirp-v4"

gpt_description_prompt
string

Natural-language description when not writing full lyrics (description mode).

Example:

"Upbeat indie pop about walking through neon rain in a futuristic city"

make_instrumental
boolean

Instrumental only (no vocals).

Example:

false

continue_at
number

Continue generation from this timestamp (seconds).

continue_clip_id
string

Clip id to continue from.

task_id
string

Related task id for continue flows.

Response

200 - application/json

Task accepted

code
string
Example:

"success"

message
string
data
string

Public task id (task_xxxx).

Example:

"task_xxxxxxxx"