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

google/lyria-3-clip/music

Google Lyria 3 Clip generates novel music tracks from text prompts and optional image input. 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.04per run·~25 / $1

ExamplesView all

Driving techno track, heavy kick drum at 130 BPM, dark industrial synths, repetitive hypnotic bassline, Berlin underground club style, no vocals

Epic orchestral battle theme, full symphony orchestra, powerful brass fanfare, pounding timpani, rising tension, heroic and dramatic, 140 BPM, Hollywood blockbuster style

Related Models

README

Google Lyria 3 Clip

Google Lyria 3 Clip is Google's advanced AI music generation model. Describe the sound you want in natural language — genre, tempo, instruments, mood, and style — and get a high-quality music clip in seconds. Optionally guide the output with a reference image.

Why Choose This?

  • Detailed text-to-music generation Describe your track with as much or as little detail as you want — genre, BPM, instruments, energy level, and mood all influence the output.

  • 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

Driving techno track, heavy kick drum at 130 BPM, dark industrial synths, repetitive hypnotic bassline, Berlin underground club style, no vocals.

Pricing

Just $0.04 per clip.

Best Use Cases

  • Content Creation — Generate background music for videos, podcasts, reels, and social media content.
  • Game & Interactive Media — Produce atmospheric tracks and sound design for games and apps.
  • Advertising — Create custom music beds for promotional videos without licensing fees.
  • Creative Exploration — Rapidly prototype musical ideas and styles from text descriptions.
  • Mood & Ambience — Generate focus music, relaxation tracks, or energetic workout playlists on demand.

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 abstract or 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.
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 Clip Music API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/google/lyria-3-clip/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 Clip 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-clip/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-clip/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-clip/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 Clip Music API — Frequently asked questions

What is the Lyria 3 Clip Music API?

Lyria 3 Clip Music is a Google model for audio generation, exposed as a REST API on WaveSpeedAI. Google Lyria 3 Clip generates novel music tracks from text prompts and optional image input. 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 Clip 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-clip-music.

How much does Lyria 3 Clip Music cost per run?

Lyria 3 Clip Music starts at $0.04 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 Clip 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-clip-music.

How long does Lyria 3 Clip Music take to generate?

Reported generation time on WaveSpeedAI is around 11 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 Clip 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-clip/music for AI agents and LLMs