Lyria
Ustvarjanje glasbe iz besedila z zahtevo za enega do osem posnetkov in sinhrono vrnitvijo rezultata.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
google/lyria ustvarja glasbo iz pisnega poziva prek /v1/music/generations. Uporabite ga na primer za umirjeno instrumentalno podlago za predstavitev izdelka: opišite vodilna glasbila in prostor, ki ga potrebuje pripoved. Pot izberite, kadar želite ustvarjen glasbeni posnetek.
Zahteva mora vsebovati model in prompt. Kontrolnik n ali count sprejema enega do osem posnetkov, metoda pa rezultat ustvarjanja vrne sinhrono. Shranite vsak vrnjen posnetek in njegove dejanske metapodatke. Vnos ne izpostavlja zvočnega referenčnega vhoda, nastavitve trajanja ali polja tempa, zato teh ni mogoče izbirati kot ločene kontrolnike. Glasbeno namero opišite v pozivu, ne da bi jo obravnavali kot zagotovljeno izmerjeno lastnost izhoda.
Ailoot · Glasba POST /v1/music/generations google/lyria
google/lyriaZačetek
Ustvarjanje glasbe iz besedila z zahtevo za enega do osem posnetkov in sinhrono vrnitvijo rezultata.
- Dovoljeni vhodi
- Besedilo
- Rezultati
- music
Na voljo v Ailoot · vhodi in metode
Ailoot · Glasba POST /v1/music/generations
- Vhod
text- Izhod
music- Izhodni format
- celotni zvočni posnetki v vaši lasti / povezave JSON
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve google/lyria | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 8 | Privzeto1 |
Poljecount | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 8 Pogoji: Če je podan tudi n, se mora število ujemati | Privzeto— |
Kombinacije vhodnih gradiv
text_to_music · Obvezno: prompt
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametermaterial_types | Specifikacijatext |
Parameterrequired | Specifikacijanull |
Parameteroptional_controls | Specifikacijanull |
Življenjski cikel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
Cenik
Cene metod Ailoot
POST /v1/music/generations- Izhod
- 0,08 $ na posnetek
- Samo referenca · se ne prišteje
- 0,08 $ na zahtevo
Dostavljeni posnetki × osnovna cena na posnetek. Referenčna cena na zahtevo se ne prišteje. Primeri pred veljavnimi prilagoditvami.
1 × 0,08 $ = 0,08 $
4 × 0,08 $ = 0,32 $
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Primeri zahtev
Ailoot · Glasba
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
Prejmi in shrani rezultate
Ailoot · Glasba
celotni zvočni posnetki v vaši lasti / povezave JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Ohrani vse dokončane rezultate
Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.
Shranite/pridobite vsak vrnjeni posnetek in ohranite dejanski ID, MIME ter metapodatke. Metoda je sinhrona; ločen URL za preverjanje stanja ustvarjanja glasbe v Ailoot ni uveden.
Če je treba preveriti izvirni odgovor
Če je treba preveriti glasbeni rezultat, ohranite prvotni operation_id/X-Client-Request-ID in vrnjene podatke o posnetkih. Obstoječe posnetke v vaši lasti obnovite prek medijske knjižnice z dejanskimi vrednostmi task_id ali asset_id. Glasbene zahteve ne oddajte znova in iz operation_id ne sestavljajte URL-ja za preverjanje ustvarjanja.
Polja odgovora
| Polje | Vrsta |
|---|---|
Poljemodel | Vrstastring |
Poljeresponse_id | Vrstastring |
Poljedata[] | Vrstaowned clip record |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Druga imena
Druga imena modelov
Ailoot google/lyria
Druga imena poti metod
Uporabite zgoraj navedene poti metod.
Povezani ID-ji za klic
FAQ · Lyria
- Kateri vhodi in rezultati so na voljo?
POST /v1/music/generations·google/lyria:text→music- Katera polja uporablja zahteva?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Katere omejitve veljajo?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8