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

# Lyria 3 Pro

> Google's Lyria 3 Pro model for full-length compositions up to 2 minutes.

Google's Lyria 3 Pro model for full-length compositions up to 2 minutes. Understands musical structure and supports timed lyrics with timestamp control. Duration varies by prompt.

| | |
| - | - |
| Model id | `lyria-3-pro-preview` |
| Media | audio |
| Submit to | `POST /v1/audio` |
| Price | 40 credits per\_generation before discounts |
| Typical time | about 60.0 s |

## Request

**Required:** `prompt_tags`\
**Optional:** `energy`, `instrumental`, `lyrics`, `tempo`

```json theme={null}
{
  "model": "lyria-3-pro-preview",
  "prompt_tags": [
    "warm indian wedding underscore soft tablas strings hopeful"
  ],
  "energy": "medium",
  "instrumental": "false",
  "tempo": "medium"
}
```

| Field | Allowed | Default |
| - | - | - |
| `energy` | `low`, `medium`, `high` | `"medium"` |
| `instrumental` | `false`, `true` | `"false"` |
| `lyrics` | text | |
| `tempo` | `slow`, `medium`, `fast` | `"medium"` |

Reference inputs take asset ids from [`POST /v1/uploads`](/uploads) or an earlier output's `asset_id`.
Prices and allowed values come from the live catalog; `GET /v1/models/lyria-3-pro-preview` is always current.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.