Skip to main content
POST
Suno Lyrics
suno-lyrics writes song lyrics about a theme you describe. Confirm live rates on the SnapGen models page. Failed tasks are not charged.
string
required
Set to suno-lyrics.
string
required
What the lyrics should be about, up to 3,000 characters, for example the theme, style, and mood.
string
Lyrics model: classic or remi. The provider default applies if you omit it.
string
Optional public https URL that receives one signed event when the task finishes. See Task webhooks.
string
Required with webhook: 16 to 256 characters, used to sign the delivery.

Request

The response is HTTP 202 with a task object and a Location: /v1/tasks/{id} header. Poll GET /v1/tasks/{id} every 10 to 20 seconds until status is succeeded or failed.

Result

Lyrics arrive in result.lyrics[], each entry with text and, when the provider returns them, title and tags. result.urls is empty.
See Music generation tasks for the task lifecycle, result fields, webhooks, and errors.