Lyria 3 Clip Preview
Lyria 3 Clip Preview je hudobný model od Googlu pre krátke klipy, slučky a ukážky. Prijíma textovú alebo obrazovú inšpiráciu a vytvára 30-sekundovú hudbu so stereofónnym zvukom 48 kHz, s podporou spevu, časovaných textov piesní a inštrumentálnych aranžmánov.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Lyria 3 Clip Preview je profil generovania hudby od Googlu pre krátke klipy, slučky a ukážky. Prijíma textový prompt alebo obrazovú inšpiráciu a vracia text a zvuk. Publikovaný profil opisuje 30-sekundové klipy so stereofónnym zvukom 48 kHz vrátane spevu, časovaných textov piesní a plných inštrumentálnych aranžmánov.
Opíšte hudobný moment
Pomenujte účel klipu a náladu, ktorú má niesť. Krátka úvodná znelka môže určiť zdržanlivý úvod a zreteľný nástup; hudobný podklad môže definovať tempo a zvukovú štruktúru potrebné pod vizuálnou scénou. Uveďte, či má výsledok obsahovať spev alebo byť inštrumentálny, a pomenujte hudobné prvky dôležité pre zadanie.
Štruktúru udržte dostatočne kompaktnú pre klip. Určte úvod, hlavnú frázu a záver alebo bod slučky. Ak záleží na slovách, dodajte zamýšľanú myšlienku textu piesne alebo konkrétne znenie a overte skutočne zaspievaný výsledok. Hudobné zadanie má odlíšiť obsah spevu od pokynov k aranžmánu.
Obrazová inšpirácia a aranžmán
Pri dodaní obrázka vysvetlite, akou scénou alebo náladou prispieva k hudobnej požiadavke. Pokojná krajina a rušná nočná scéna naznačujú odlišné smerovanie, ale požadovaná emocionálna úloha má byť aj tak výslovne uvedená v texte. Pri porovnávaní vráteného klipu so zamýšľaným konceptom uchovajte obrázok spolu s promptom.
Skontrolujte vyváženie spevu, nástrojov a hlavnej hudobnej frázy. Pri slučke si vypočujte koniec a začiatok spolu; pri ukážke overte, či krátke trvanie vyjadruje zamýšľaný smer. Klip sprevádzajúci strih treba posudzovať voči tomuto strihu, nielen samostatne.
Zachovajte zvukový výstup na počúvanie
Skutočný zvuk a prípadný sprievodný text uložte so zadaním. Pri príprave prehrávania alebo importe do editora skontrolujte vlastnosti súboru a zachovajte prípadné informácie o texte piesne alebo časovaní vrátené požiadavkou. Hudba je výstupom modelu; strihy, titulky, vizuálne prechody a konečný produkčný mix možno pripraviť okolo tohto skontrolovaného materiálu.
Tento konkrétny profil Clip Preview sa hodí na kompaktný hudobný výstup. Pri plánovaní dlhšej kompozície zachovajte jeho odlišnú krátku formu a vrátený klip vyberajte počúvaním celej frázy, znenia spevu a záveru.
Ailoot · Hudba POST /v1/music/generations google/lyria-3-clip-preview
google/lyria-3-clip-previewÚvod
Lyria 3 Clip Preview je hudobný model od Googlu pre krátke klipy, slučky a ukážky. Prijíma textovú alebo obrazovú inšpiráciu a vytvára 30-sekundovú hudbu so stereofónnym zvukom 48 kHz, s podporou spevu, časovaných textov piesní a inštrumentálnych aranžmánov.
- Povolené vstupy
- Text
- Výsledky
- music
Dostupné v Ailoot · vstupy a metódy
Ailoot · Hudba POST /v1/music/generations
- Vstup
text- Výstup
music- Výstupný formát
- úplné zvukové klipy vo vašom vlastníctve / odkazy v JSON
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity google/lyria-3-clip-preview | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Kombinácie vstupných podkladov
text_to_music · Povinné: prompt
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametermaterial_types | Špecifikáciatext |
Parameterrequired | Špecifikácianull |
Parameteroptional_controls | Špecifikácianull |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Štruktúry metód a ID sú presné; možnosti dodávateľa sa posudzujú oddelene od prijatia požiadavky.
Cenník
Sadzby metód Ailoot
POST /v1/music/generations- Výstup
- 0,04 USD za klip
- Len referencia · nepripočítava sa
- 0,04 USD za požiadavku
Dodané klipy × základná sadzba za klip. Referenčná sadzba za požiadavku sa nepripočítava. Príklady pred príslušnými úpravami.
1 × 0,04 USD = 0,04 USD
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Podrobnosti referenčnej tarify
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
Referenčné sadzobníky modelu
Ceny podľa konfigurácie
| Konfigurácia | Úroveň služby | Podmienka kontextu | Poplatok |
|---|---|---|---|
| KonfiguráciaUltra | Úroveň službystandard | Podmienka kontextu{} | Poplatok Výstup · hudba 0,08 USD za skladbu |
Príklady požiadaviek
Ailoot · Hudba
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/lyria-3-clip-preview", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
export AILOOT_API_KEY
python3 - <<'PY_RESULT'
import json, os, subprocess
from pathlib import Path
from urllib.parse import urljoin, urlparse
result=json.loads(Path("result.json").read_text(encoding="utf-8"))
print(json.dumps(result,ensure_ascii=False,indent=2))
for number,clip in enumerate(result.get("data") or []):
u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))
if u.scheme!="https" or not u.hostname or u.username or u.password:
raise SystemExit("Result URL must be HTTPS without embedded credentials")
owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
raw=subprocess.check_output(args)
ext="wav" if raw.startswith(b"RIFF") and raw[8:12]==b"WAVE" else "flac" if raw.startswith(b"fLaC") else "ogg" if raw.startswith(b"OggS") else "mp3" if raw.startswith(b"ID3") or raw[:1]==b"\xff" else "bin"
f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)
print("Saved",f,clip.get("asset_id"))
PY_RESULT
Prijať a uložiť výsledky
Ailoot · Hudba
úplné zvukové klipy vo vašom vlastníctve / odkazy v JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Uložte alebo načítajte každý vrátený klip a zachovajte skutočné ID, MIME a metadáta. Metóda je synchrónna; nezavádza sa samostatná URL na zisťovanie stavu generovania hudby v Ailoot.
Ak treba overiť pôvodnú odpoveď
Ak výsledok hudby vyžaduje kontrolu, zachovajte pôvodné operation_id/X-Client-Request-ID a vrátené informácie o klipoch. Existujúce klipy vo vašom vlastníctve obnovte cez knižnicu médií pomocou skutočných hodnôt task_id alebo asset_id. Hudobnú požiadavku znova neodosielajte ani z operation_id nevytvárajte URL na zisťovanie stavu generovania.
Polia odpovede
| Pole | Typ |
|---|---|
Polemodel | Typstring |
Poleresponse_id | Typstring |
Poledata[] | Typowned clip record |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Odpoveďserver_error | PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať | Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte. |
Aliasy
Aliasy modelov
Ailoot google/lyria-3-clip-preview
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Lyria 3 Clip Preview
- Aké vstupy a výsledky sú dostupné?
POST /v1/music/generations·google/lyria-3-clip-preview:text→music- Aké polia používa požiadavka?
POST /v1/music/generations·google/lyria-3-clip-preview:model,prompt