Music
Suno V6, in simple or custom mode. One request returns two tracks.
Generate music
Submits a Suno V6 job and charges it. One request yields two complete
tracks, both returned in output.
Headers
Idempotency-KeyMakes this submission safe to retry. A replay within 15 minutes returns
the original body with status 200 and is not charged again; a replay while
the first request is still in flight returns 409 request_in_progress.
The key is fingerprinted with the request's prompt (its dialogue, for
speech), so reusing a key with a different prompt starts a new
generation. A client_request_id body field works identically.
Generate music › Request Body
promptIn simple mode, a description of the track (max 3,000 characters). In custom mode, the lyrics (max 5,000).
modelOptional. Anything outside the catalog fails with invalid_model.
customModefalse — describe the track in prompt and let the model handle the
rest. true — prompt carries the lyrics and style and title
take effect.
styleGenre and production direction. Custom mode only.
titleCustom mode only. Truncated to 79 UTF-16 units — an emoji costs two — and falls back to the prompt or style if omitted.
instrumentalRender without vocals.
Generate music › Responses
An Idempotency-Key replay within 15 minutes. The body is byte-identical
to the original 202 and nothing was charged again.
idPoll this with GET /generations/{id}/.
typeMedia type of the job.
modelThe model as you requested it.
statusAlways processing — nothing is rendered yet.
credits_chargedAlready debited. This is the final price, except for seedance25 edit/extend jobs where it is a hold that is partially refunded after delivery.
created_at