# Lyria 3.5

> Google's latest Lyria 3.5 music generation model via fal.ai. Generates full-length songs up to a few minutes with vocals and lyrics; control length and structure with duration hints or section timestamps in the prompt. Supports English, German, Spanish, French, Hindi, Japanese, Korean and Portuguese. Returns an MP3 file.

- **Provider**: fal
- **Model ID**: google/lyria-3.5
- **Category**: music_generation
- **Credits**: 230 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**): The text prompt describing the music you want to generate. Include genre, mood, instrumentation, tempo, vocals, and structure for best results. Use duration hints ('a 2-minute track') or section markers like '[0:00-0:30] Intro' / '[0:30-1:00] Verse' to control song length and structure. Supports English, German, Spanish, French, Hindi, Japanese, Korean, and Portuguese.
- `image_url` (string, optional): Optional image URL to use as inspiration for music generation. The model will create music that matches the mood and theme of the image.

## Example Request

```json
{
  "model": "google/lyria-3.5",
  "input": {
    "prompt": "An uplifting pop song with driving electric guitar, energetic drums, and a catchy chorus singing 'Rise up and shine today'. 120 BPM. Two minutes long with a verse-chorus-verse-chorus-bridge-chorus structure."
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "fal",
  "model": "google/lyria-3.5",
  "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

- 230 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

json

## Tags

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

## Documentation

https://fal.ai/models/google/lyria-3.5