Skip to main content
POST
Flow Music Lyrics
flow-music-lyrics writes lyrics that you can pass to flow-music as lyrics. Confirm live rates on the SnapGen models page. Failed tasks are not charged.
string
required
Set to flow-music-lyrics.
string
required
What the lyrics should be about, up to 3,000 characters, for example the theme, style, and mood.
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.