# Lyria 3 Pro

> Google's most capable music generation model. Generates full-length songs up to 3 minutes with vocals, lyrics, song structure tags ([Verse], [Chorus], [Bridge]) and timestamp control from a text prompt, optionally inspired by up to 10 reference images. Returns an MP3 file.

- **Provider**: replicate
- **Model ID**: google/lyria-3-pro
- **Category**: music_generation
- **Credits**: 190 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `prompt` (string, **required**): Text prompt describing the song to generate. Include details like genre, instruments, mood, tempo, lyrics, and song structure (e.g. [Verse], [Chorus], [Bridge]) for best results. You can also use timestamps like [0:00 - 0:30] to control timing.
- `seed` (integer, optional): Random seed for generation. Set to a specific value for more reproducible results, though exact determinism is not guaranteed.
- `images` (array, optional): Input images to inspire the music composition (up to 10 images)

## Example Request

```json
{
  "model": "google/lyria-3-pro",
  "input": {
    "prompt": "[Verse 1]\nWalking through the neon glow,\ncity lights reflect below,\nevery shadow tells a story,\nevery corner, fading glory.\n\n[Chorus]\nWe are the echoes in the night,\nburning brighter than the light,\nhold on tight, don't let me go,\nwe are the echoes down below.\n\nSynth-pop, 110 BPM, female vocals, about two minutes."
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "google/lyria-3-pro",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null,
  "credits_used": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

When the job is `completed`, `result` holds the output URL(s) or data and `credits_used` the net credits charged. When it is `failed`, `error` and `error_code` say why and the charge is refunded.

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Pricing

- 190 credits per request

These are list prices. The amount charged is rounded, and large charges are discounted progressively. `POST /predictions/estimate` with the same `model` and `input` returns the charge for that input without creating a job (an estimate when the price depends on the output).

## Output Type

url

## Tags

music-generation, text-to-music, full-length-song, vocals, lyrics, multilingual, google, lyria

## Documentation

https://replicate.com/google/lyria-3-pro