Lyria 3.5 (lyria-3.5) model card #
Overview #
Lyria 3.5 (lyria-3.5) is Google’s flagship music generation model. It produces 44.1 kHz stereo audio, full songs with structural arrangements (intro, verses, chorus, bridge, solo, outro), expressive vocal synthesis, and dynamic intensity shaping from text prompts or visual reference images.
- Model Code:
lyria-3.5 - Release Date: Mid-2026
- Status: Generally Available (GA)
- Vertex AI / Enterprise Location:
global - Documentation: Google Developer Music Generation
Technical specifications #
| Property | Value |
|---|---|
| Input Modalities | Text, Image (up to 10 reference images) |
| Output Modalities | Audio (MP3 / WAV) and Text (Lyrics / Structure) |
| Input Token Limit | 131,072 tokens |
| Audio Output Duration | Controllable multi-minute songs (up to about 3 minutes) |
| Audio Quality | 44.1 kHz stereo, 192 kbps MP3 or uncompressed WAV |
| Supported MIME Types | audio/mp3, audio/wav |
| Supported Languages | English, German, Spanish, French, Hindi, Japanese, Korean, Portuguese |
| Structural Controls | Timestamps, BPM, Key, Section Tags, Dynamic Intensity |
| Watermarking | SynthID (Audio) + C2PA Content Credentials |
Key features and capabilities #
1. Structural arrangement and timestamp control #
Lyria 3.5 interprets structured prompt timelines to guide instrument entrances, transitions, vocal delivery, and dynamic swells:
[0:00 - 0:15] Intro: Atmospheric Rhodes electric piano with ambient vinyl crackle in D minor.
[0:15 - 0:45] Verse 1: Warm bassline and boom-bap drums enter with expressive vocals.
[0:45 - 1:15] Chorus: Full melodic progression with saxophone countermelodies and rich harmonies.
[1:15 - 1:35] Bridge: Stripped-back percussion and solo piano building tension.
[1:35 - 2:05] Final Chorus: Maximum dynamic intensity with full brass accents and rhythm section.
[2:05 - 2:20] Outro: Slow guitar strumming gently fading to silence.2. User-defined lyrics and section tags #
Provide full song lyrics structured by section:
Compose an uplifting indie rock anthem at 128 BPM in G Major:
[Verse 1]
City skyline shining in the dusk
Running free on roads of copper rust
[Chorus]
We ignite the neon spark tonight
Chasing dreams until the morning light3. Multimodal image-to-music guidance #
Supply up to 10 reference images (concept art, title screens, photos, storyboards) to direct the emotional palette, genre mood, and aesthetic tone of the composition.
4. Clean instrumental backing tracks #
Add "Instrumental only, no vocals" to synthesize background beds or ambient soundscapes without vocal bleed.
CLI and SDK examples #
1. Python script (uv run scripts/lyria.py) and gemini-api CLI #
# Generate with uv run scripts/lyria.py (supports GEMINI_API_KEY or Gemini Enterprise / Vertex AI ADC)
uv run scripts/lyria.py \
-p "An atmospheric lo-fi jazz track at 85 BPM in E Minor. Instrumental only, no vocals." \
-f lofi_track.mp3 \
-m lyria-3.5 \
--lyrics-file lofi_track_structure.txt
# Generate uncompressed WAV via Gemini Enterprise / Vertex AI (global location)
uv run scripts/lyria.py \
--enterprise \
--project "${GOOGLE_CLOUD_PROJECT}" \
--location "${GOOGLE_CLOUD_LOCATION:-global}" \
-p "An atmospheric lo-fi jazz track at 85 BPM in E Minor. Instrumental only, no vocals." \
-f lofi_track.wav \
-m lyria-3.5
# Or generate with gemini-api CLI from a prompt file
gemini-api music \
-m lyria-3.5 \
-f lofi_prompt.txt \
--out lofi_track.mp32. Full song in WAV format with timestamps (Python Interactions API) #
import base64
from google import genai
client = genai.Client()
prompt = """
An atmospheric lo-fi jazz track at 85 BPM in E Minor:
[0:00 - 0:20] Intro: Warm upright bass and gentle brush drums.
[0:20 - 0:50] Verse 1: Mellow electric piano melody with subtle trumpet accents.
[0:50 - 1:20] Chorus: Full ensemble with rich saxophone harmonies.
[1:20 - 1:40] Outro: Slow piano chords fading into rain sounds.
Instrumental only, no vocals.
"""
interaction = client.interactions.create(
model="lyria-3.5",
input=prompt,
response_format={"type": "audio", "mime_type": "audio/wav"},
)
if interaction.output_audio:
with open("lofi_track.wav", "wb") as f:
f.write(base64.b64decode(interaction.output_audio.data))
if interaction.output_text:
with open("lofi_track_structure.txt", "w") as f:
f.write(interaction.output_text)3. Multimodal concept-to-soundtrack (Python) #
import base64
from google import genai
client = genai.Client()
def read_b64(path):
with open(path, "rb") as f:
return base64.b64encode(f.read()).decode("utf-8")
interaction = client.interactions.create(
model="lyria-3.5",
input=[
{"type": "image", "data": read_b64("concept_art.jpg"), "mime_type": "image/jpeg"},
{
"type": "text",
"text": "Compose a sweeping cinematic orchestral score reflecting the scale and mysterious tone of this concept art. Instrumental only, no vocals.",
},
],
)
if interaction.output_audio:
with open("film_score.mp3", "wb") as f:
f.write(base64.b64decode(interaction.output_audio.data))4. JavaScript / TypeScript SDK (@google/genai) #
import { GoogleGenAI } from "@google/genai";
import * as fs from "node:fs";
const ai = new GoogleGenAI({});
async function generateSong() {
const interaction = await ai.interactions.create({
model: "lyria-3.5",
input: "An uplifting synthwave anthem at 124 BPM in A Minor with retro analog synthesizers and punchy drum machine. Instrumental only, no vocals.",
});
if (interaction.output_audio) {
fs.writeFileSync("synthwave_anthem.mp3", Buffer.from(interaction.output_audio.data, "base64"));
}
}
generateSong();