Ana içeriğe geç
google avatarı

Lyria 3 Clip API

google/lyria-3/clip

Tek bir metin prompt’undan, varsayılan olarak vokal ve sözleriyle birlikte 30 saniyelik bir şarkı klibini MP3 olarak üretin.

0.04

Model girdisi

Input

Describe the music you want in plain language — genre, mood, instrumentation, tempo and key (for example, 'uplifting indie-folk with bright fingerpicked acoustic guitar, warm claps and a hopeful melody'). Output is a fixed ~30-second clip. Vocals and lyrics are generated by default; add 'instrumental only, no vocals' to get an instrumental. Supply your own words with a 'Lyrics:' section and steer structure with tags like [Verse], [Chorus] and [Bridge]. Shape the arrangement over time with timestamped cues such as '[0:00-0:10] soft intro, [0:10-0:30] full band'. Lyrics can be produced in English, German, Spanish, French, Hindi, Japanese, Korean or Portuguese — name the language in the prompt. Negative prompting is not supported; steer with positive description instead.

You need to be logged in to run this model and view results.
Log in

Model çıktısı

Output

Loading
Generated in 11.258 seconds
Logs (1 lines)

Örnek istekler

Örnekler

Lyria 3 Clip API

Lyria 3 Clip is a music AI model by google. On ModelRunner it runs through a REST API or via MCP from any AI assistant, at $0.04 per audio clip.

POST https://queue.modelrunner.run/google/lyria-3/clip

cURL

# Submit a request to the queue. Input fields go at the top level of the
# body. The optional reserved "metadata" object holds your own flat string
# tags — stored on the request, never sent to the model; filter later with
# GET https://queue.modelrunner.run/requests?metadata=<url-encoded JSON>.
curl -X POST https://queue.modelrunner.run/google/lyria-3/clip \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "An anthemic pop track with a soaring female vocal, punchy drums, bright synths and a euphoric festival-ready chorus",
    "metadata": {
      "project": "my-project"
    }
  }'
# → { "request_id": "...", "status_url": "...", "response_url": "..." }

# Poll status_url until "COMPLETED", then fetch the result
curl "https://queue.modelrunner.run/google/lyria-3/clip/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/google/lyria-3/clip/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("google/lyria-3/clip", {
  input: {
    "prompt": "An anthemic pop track with a soaring female vocal, punchy drums, bright synths and a euphoric festival-ready chorus"
  },
});
console.log(result);

Python

import os
import requests

headers = {"Authorization": f"Key {os.environ['MRUN_API_KEY']}"}

submitted = requests.post(
    "https://queue.modelrunner.run/google/lyria-3/clip",
    headers=headers,
    json={
      "prompt": "An anthemic pop track with a soaring female vocal, punchy drums, bright synths and a euphoric festival-ready chorus"
    },
).json()

# Poll submitted["status_url"] until "COMPLETED", then:
result = requests.get(submitted["response_url"], headers=headers).json()

Input parameters

Input parameters of Lyria 3 Clip
NameTypeRequiredDescription
promptstringyesDescribe the music you want in plain language — genre, mood, instrumentation, tempo and key (for example, 'uplifting indie-folk with bright fingerpicked acoustic guitar, warm claps and a hopeful melody'). Output is a fixed ~30-second clip. Vocals and lyrics are generated by default; add 'instrumental only, no vocals' to get an instrumental. Supply your own words with a 'Lyrics:' section and steer structure with tags like [Verse], [Chorus] and [Bridge]. Shape the arrangement over time with timestamped cues such as '[0:00-0:10] soft intro, [0:10-0:30] full band'. Lyrics can be produced in English, German, Spanish, French, Hindi, Japanese, Korean or Portuguese — name the language in the prompt. Negative prompting is not supported; steer with positive description instead.

Machine-readable: OpenAPI schema · llms.txt

Use Lyria 3 Clip from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Lyria 3 Clip becomes a tool your assistant can call directly — it authorizes via OAuth (no API key in config) and runs this model with the run_model tool using the endpoint google/lyria-3/clip.

MCP client config (Claude Desktop, Cursor)

{
  "mcpServers": {
    "modelrunner": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp

Then ask your assistant, for example: “Run google/lyria-3/clip on ModelRunner to generate music”. MCP setup guide.

Model Detayları

Model Detayları

Lyria 3 Clip, Google DeepMind’ın kısa klipler için geliştirdiği text-to-music modelidir. İstediğiniz parçayı tek bir `prompt` içinde tarif edin — tür, ruh hali, enstrümantasyon, tempo ve ton — model de 30 saniyelik bir MP3 (192 kbps, 44.1 kHz) döndürür. Önceki Lyria modellerinin aksine vokal ve sözleri varsayılan olarak kendisi üretir: enstrümantal bir parça istemediğiniz sürece brief’inize uyan sözler yazıp seslendirir. Böylece düz bir dille anlatılmış bir fikri, hook’u olan ve bitmiş gibi duyulan kısa bir parçaya hızla dönüştürebilirsiniz.

## En uygun olduğu işler - Tek satırlık bir brief’ten kısa marka jingle’ları, logo stinger’ları ve intro/outro müzikleri - Video, reklam, oyun ve sunumlar için fon müziği - Sosyal medya için ses klipleri, bildirim ve UI sesleri - Tam bir prodüksiyondan önce bir türü, ruh halini ya da şarkı fikrini denemek - İngilizce ya da yedi başka dilde söylenen hook’lar ve kısa vokal parçaları

## Şu durumlarda başka bir model seçin - Tam bir şarkı ya da 30 saniyeden uzun bir parça gerekiyorsa — süre girdisi olan, daha uzun formatlı bir müzik modeli kullanın - Kesin olarak enstrümantal müzik istiyorsanız — prompt’a "instrumental only, no vocals" yazın ya da yalnızca enstrümantal üreten bir müzik modeli kullanın - Müzik yerine konuşma anlatımı istiyorsanız — bir text-to-speech modeli kullanın - Müzik yerine ses efekti ya da foley gerekiyorsa — bir ses efekti modeli kullanın

## İpuçları - `prompt` alanını bir müzik brief’i gibi yazın: türü, ruh halini, ana enstrümanları ve tempoyu belirtin ("upbeat indie-folk, bright fingerpicked acoustic guitar, hopeful, 110 bpm") - Vokal ve sözler varsayılan olarak açıktır; kapatmak için prompt’a "instrumental only, no vocals" ekleyin - Kendi sözlerinizi bir "Lyrics:" bölümüyle verin, şarkının yapısını [Verse], [Chorus] ve [Bridge] etiketleriyle şekillendirin - Klibin akışını "[0:00-0:10] soft intro, [0:10-0:30] full band" gibi zaman damgalı işaretlerle kurgulayın - Sözler İngilizce, Almanca, İspanyolca, Fransızca, Hintçe, Japonca, Korece ya da Portekizce üretilebilir — dili prompt’ta belirtin

## Sınırlamalar - Public preview aşamasındadır ve henüz production kullanımı için tasarlanmamıştır; davranışı ve erişim durumu değişebilir - Çıktı sabit ~30 saniyelik bir kliptir ve prompt başına tek klip üretilir — süre kontrolü yoktur - Negative prompt desteklenmez; bunun yerine sonucu ne istediğinizi tarif ederek yönlendirin

ModelRunner JavaScript client ile çalıştırmak için: ```js import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("google/lyria-3/clip", { input: { prompt: "Uplifting indie-folk with bright fingerpicked acoustic guitar, warm claps, and a hopeful sung chorus", }, }); ```