Lyria
Szövegből zene készítése egy–nyolc kért részlettel és szinkron eredményátadással.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
google/lyria írott promptból készít zenét a /v1/music/generations végponton. Konkrét alkalmazás visszafogott hangszeres aláfestés kérése termékbemutatóhoz, leírva az előtérben hallható hangszereket és a narráció számára szükséges teret. Akkor válassza ezt az útvonalat, ha generált zenei részlet a kívánt eredmény.
A kérés kötelező mezői model és prompt. Az n vagy count vezérlő egy–nyolc részletet fogad el, a metódus pedig szinkron módon adja vissza a generálás eredményét. Mentsen minden visszaadott részletet és tényleges metaadatát. E bejegyzés nem kínál referenciahang-bemenetet, időtartam-beállítást vagy tempómezőt, így ezek nem választhatók külön vezérlőként. A zenei szándékot a promptban írja le, de ne kezelje a kimenet garantáltan mért tulajdonságaként.
Ailoot · Zene POST /v1/music/generations google/lyria
google/lyriaKezdő lépések
Szövegből zene készítése egy–nyolc kért részlettel és szinkron eredményátadással.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- music
Elérhető az Ailootban · bemenetek és metódusok
Ailoot · Zene POST /v1/music/generations
- Bemenet
text- Kimenet
music- Kimeneti formátum
- teljes saját hangklipek / JSON-hivatkozások
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok google/lyria | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Mezőn | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 8 | Alapértelmezett1 |
Mezőcount | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 8 Feltételek: Ha az n értékét is megadja, a darabszámnak egyeznie kell | Alapértelmezett— |
Bemeneti anyagok kombinációi
text_to_music · Kötelező: prompt
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétermaterial_types | Szerződéstext |
Paraméterrequired | Szerződésnull |
Paraméteroptional_controls | Szerződésnull |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
A metódusok szerkezete és azonosítói pontosak; a beszállítói képesség különbözik a kérelmek befogadásától.
Díjcsomagok
Ailoot-metódusok díjai
POST /v1/music/generations- Kimenet
- 0,08 USD klipenként
- Csak referencia · nem adódik hozzá
- 0,08 USD kérésenként
Átadott klipek × klipenkénti alapdíj. A kérésenkénti referenciadíj nem adódik hozzá. Példák az alkalmazandó módosítások előtt.
1 × 0,08 USD = 0,08 USD
4 × 0,08 USD = 0,32 USD
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot · Zene
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
Eredmények fogadása és mentése
Ailoot · Zene
teljes saját hangklipek / JSON-hivatkozások
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Mentse vagy kérje le az összes visszaadott klipet, és őrizze meg a tényleges azonosítót, MIME-típust és metaadatokat. A metódus szinkron; nem vezet be külön Ailoot zenegenerálási állapotlekérdezési URL-címet.
Ha az eredeti választ ellenőrizni kell
Ha egy zenei eredményt ellenőrizni kell, őrizze meg az eredeti operation_id/X-Client-Request-ID értékeket és a visszaadott klipadatokat. A meglévő, Önhöz tartozó klipeket a médiatárból kérje vissza a tényleges task_id vagy asset_id értékekkel. Ne küldje be újra a zenei kérést, és ne képezzen generálási állapotlekérdezési URL-címet az operation_id alapján.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőmodel | Típusstring |
Mezőresponse_id | Típusstring |
Meződata[] | Típusowned clip record |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Álnevek
Modell álnevei
Ailoot google/lyria
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Lyria
- Milyen bemenetek és eredmények érhetők el?
POST /v1/music/generations·google/lyria:text→music- Mely mezőket használja a kérés?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Milyen korlátok érvényesek?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8