Seedream 5.0 Flash is LIVE — Faster & Cheaper | Try Now →

google/lyria-3-pro/music

Google Lyria 3 Pro generates high-quality music tracks from text prompts and optional image input. Pro tier delivers enhanced audio quality and richer compositions. Produces complete songs with lyrics, descriptions, and audio output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-audio
Input
Enable Safety Checker

Idle

$0.08per run·~12 / $1

ExamplesView all

Dark ambient sci-fi underscore, deep pulsing bass drones, ethereal synth pads, subtle percussion, tense and mysterious, space horror atmosphere, no melody, slow tempo

Heavy metal instrumental, distorted electric guitars, fast double bass drumming, aggressive riffs, shredding guitar solo, dark and powerful, 160 BPM

Related Models

README

Google Lyria 3 Pro

Google Lyria 3 Pro is Google's premium AI music generation model. Describe the sound you want in natural language — genre, tempo, instruments, mood, and style — and get a higher-fidelity music clip with richer detail and more nuanced musical expression than the standard Clip tier. Optionally guide the output with a reference image.

Why Choose This?

  • Premium music generation quality Richer instrumentation, more nuanced musical expression, and higher audio fidelity than the Clip tier.

  • Detailed text-to-music control Describe your track with genre, BPM, instruments, energy level, and mood for precise, on-target results.

  • Image-guided generation Upload a reference image to inspire the musical mood and atmosphere of the clip.

  • Prompt Enhancer Built-in tool to automatically refine your music descriptions for richer results.

Parameters

ParameterRequiredDescription
promptYesText description of the desired music style, genre, tempo, and instruments.
imageNoReference image to guide the mood and atmosphere of the generated music.

How to Use

  1. Write your prompt — describe the genre, tempo, instruments, mood, and style. Use the Prompt Enhancer for better results.
  2. Upload a reference image (optional) — provide an image to inspire the musical atmosphere.
  3. Submit — generate and download your music clip.

Example Prompt

Dark ambient sci-fi underscore, deep pulsing bass drones, ethereal synth pads, subtle percussion, tense and mysterious, space horror atmosphere, no melody, slow tempo.

Pricing

Just $0.08 per clip.

Best Use Cases

  • Film & Video Scoring — Generate high-quality music beds and underscore for professional video productions.
  • Game & Interactive Media — Produce rich atmospheric tracks and dynamic soundscapes for games and apps.
  • Advertising & Brand Content — Create polished custom music for campaigns without licensing fees.
  • Podcast & Streaming — Generate premium intro, outro, and background music for audio content.
  • Creative Production — Rapidly prototype and explore musical styles with professional-grade output.

Pro Tips

  • Be specific about BPM, key instruments, and energy level for the most accurate results.
  • Put exclusions in the prompt itself, for example "no vocals" or "no drums".
  • Generation is not deterministic; run the same prompt again to get a new variation.
  • Try pairing atmospheric images with a minimal prompt to let the image drive the mood.
  • Use the Prompt Enhancer to expand a simple style reference into a detailed music description.

Notes

  • Only prompt is required; image is optional.
  • Please ensure your content complies with Google's usage policies.

Related Models

Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

Lyria 3 Pro Music API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/google/lyria-3-pro/music with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Lyria 3 Pro Music below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "prompt": "A cinematic shot of a city at sunset, soft golden light"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/google/lyria-3-pro/music" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/google/lyria-3-pro/music";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "prompt": "A cinematic shot of a city at sunset, soft golden light"
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "prompt": "A cinematic shot of a city at sunset, soft golden light"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/google/lyria-3-pro/music", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

Lyria 3 Pro Music API — Frequently asked questions

What is the Lyria 3 Pro Music API?

Lyria 3 Pro Music is a Google model for audio generation, exposed as a REST API on WaveSpeedAI. Google Lyria 3 Pro generates high-quality music tracks from text prompts and optional image input. Pro tier delivers enhanced audio quality and richer compositions. Produces complete songs with lyrics, descriptions, and audio output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Lyria 3 Pro Music API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates Python, JavaScript, and cURL examples for submitting requests and polling results. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/google/google-lyria-3-pro-music.

How much does Lyria 3 Pro Music cost per run?

Lyria 3 Pro Music starts at $0.08 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Lyria 3 Pro Music accept?

Key inputs: `prompt`, `image`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/google/google-lyria-3-pro-music.

How long does Lyria 3 Pro Music take to generate?

Reported generation time on WaveSpeedAI is around 40 seconds per request. This is an estimate, not a latency guarantee; queue time and input settings can change the total wait. live status is visible in the prediction record.

Can I use Lyria 3 Pro Music outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Google). Check the provider's applicable terms and WaveSpeedAI's Terms of Service before commercial use.

llms.txtgoogle/lyria-3-pro/music for AI agents and LLMs
Lyria 3 Pro Music | Realistic Voice & TTS API on WaveSpeedAI