> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snapgen.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Flow Music Lyrics

> Write lyrics for Flow Music from a theme. $0.03 per request.

`flow-music-lyrics` writes lyrics that you can pass to `flow-music` as `lyrics`.

| Property | Value |
| - | - |
| Model ID | `flow-music-lyrics` |
| Endpoint | `POST /v1/music/generations` (asynchronous task) |
| Group | Flow Music |
| Input | Text: what the lyrics should be about |
| Result | Lyrics in `result.lyrics` |
| Price | \$0.03 per request (3 credits) |

Confirm live rates on the [SnapGen models page](https://snapgen.org/models). Failed tasks are not charged.

<ParamField body="model" type="string" required>
  Set to `flow-music-lyrics`.
</ParamField>

<ParamField body="prompt" type="string" required>
  What the lyrics should be about, up to 3,000 characters, for example the theme, style, and mood.
</ParamField>

<ParamField body="webhook" type="string">
  Optional public `https` URL that receives one signed event when the task finishes. See [Task webhooks](/api-reference/webhooks).
</ParamField>

<ParamField body="webhook_secret" type="string">
  Required with `webhook`: 16 to 256 characters, used to sign the delivery.
</ParamField>

## Request

```bash theme={null}
curl https://api.snapgen.org/v1/music/generations \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flow-music-lyrics",
    "prompt": "A rock song about never giving up"
  }'
```

The response is HTTP `202` with a task object and a `Location: /v1/tasks/{id}` header. Poll [`GET /v1/tasks/{id}`](/api-reference/task-status) 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.

```json theme={null}
{
  "urls": [],
  "lyrics": [
    {
      "title": "Old Friend",
      "text": "[Verse]\nWe laughed like it was yesterday",
      "tags": "acoustic ballad, warm"
    }
  ]
}
```

<Note>
  See [Music generation tasks](/api-reference/music-generations) for the task lifecycle, result fields, webhooks, and errors.
</Note>