Lyria
google/lyria generuje hudbu z textu, umožňuje požadovať jeden až osem klipov a vracia výsledok synchrónne.
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.
google/lyria vytvára hudbu z písomného zadania cez /v1/music/generations. Môžete napríklad požiadať o striedmy inštrumentálny podklad k produktovej ukážke a opísať hlavné nástroje i priestor potrebný pre hovorený komentár. Tento profil zvoľte, keď požadujete vygenerovaný hudobný klip.
Požiadavka vyžaduje model a prompt. Pole n alebo count prijíma jeden až osem klipov a metóda vracia výsledok generovania synchrónne. Uložte každý vrátený klip aj jeho skutočné metadáta. Položka neposkytuje zvukový referenčný vstup, nastavenie dĺžky ani pole tempa, preto nejde o samostatne voliteľné ovládacie prvky. Hudobný zámer opíšte v zadaní bez toho, aby ste ho považovali za zaručenú nameranú vlastnosť výstupu.
Ailoot · Hudba POST /v1/music/generations google/lyria
google/lyriaÚvod
google/lyria generuje hudbu z textu, umožňuje požadovať jeden až osem klipov a vracia výsledok synchrónne.
- 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 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 8 | Predvolené1 |
Polecount | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 8 Podmienky: Ak je uvedené aj n, počet sa musí zhodovať | 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,08 USD za klip
- Len referencia · nepripočítava sa
- 0,08 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,08 USD = 0,08 USD
4 × 0,08 USD = 0,32 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 →
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", "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
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Lyria
- Aké vstupy a výsledky sú dostupné?
POST /v1/music/generations·google/lyria:text→music- Aké polia používa požiadavka?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Aké limity platia?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8