Generate Song (Inspiration Mode)

POST

/suno/submit/music

• Use gpt_description_prompt to describe your creative intent (inspiration mode)
• Response data is a task ID; poll query endpoints for results

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Lyrics content; for custom mode only

Model version (e.g. chirp-v3-0, chirp-v3-5); default chirp-v3-0

Song title; for custom mode only

Style tags; for custom mode only; separate multiple tags with commas

Whether to generate instrumental only; true for instrumental

Task ID for operations on an existing task (e.g. continuation)

Continuation start time in seconds

Clip ID of the song to continue from

Creative description prompt; for inspiration mode only

Callback URL when the task completes

Responses

Success

Content-Type

application/json

object