Skip to main content
POST
Lyric Writing
You can also submit through the unified task endpoint POST /v1/task/submit with model set to suno/lyrics and the parameters inside input. Both behave and bill the same.
When the task succeeds, data.lyrics holds two lyric drafts. Pick one and pass it as prompt when generating a song.
string
Suggested title.
string
required
Lyrics, with section markers such as [Verse] and [Chorus].
string
Suggested style tags.

Authorizations

Authorization
string
header
required

Send your API key in the Authorization: Bearer YOUR_API_KEY header.

Body

application/json
prompt
string
required

Lyrics: Full lyrics, up to 5000 characters. Use markers like [Verse] and [Chorus] to shape the structure.

lyrics_model
enum<string>
default:classic

Lyric Style: Which lyric writing approach to use. Options: classic Classic; remi Remi.

Available options:
classic,
remi
notify_hook
string<uri>

Notify hook: when the task ends, the same content as the fetch result is POSTed to this URL (a public http / https URL). Omit it to poll instead.

Response

OK

code
enum<string>
required
Available options:
success
data
object
required
message
string