Lyria
Text-till-musik med ett till åtta begärda klipp och synkron resultatleverans.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
google/lyria skapar musik från skriftlig prompt genom /v1/music/generations. Ett konkret användningsfall är återhållsam instrumental bakgrund till en produktdemonstration med beskrivning av framträdande instrument och utrymmet berättarrösten behöver. Välj rutten när genererat musikklipp är önskat resultat.
Förfrågan kräver model och prompt. n eller count accepterar ett till åtta klipp och metoden returnerar genereringsresultatet synkront. Spara varje returnerat klipp och faktisk metadata. Posten ger ingen ljudreferensindata, varaktighetsinställning eller tempofält, så de är inte oberoende valbara kontroller. Beskriv musikalisk avsikt i prompten utan att behandla den som garanterad uppmätt utdataegenskap.
Ailoot · Musik POST /v1/music/generations google/lyria
google/lyriaStart
Text-till-musik med ett till åtta begärda klipp och synkron resultatleverans.
- Godkända indata
- Text
- Resultat
- music
Tillgängligt i Ailoot · indata & metoder
Ailoot · Musik POST /v1/music/generations
- Indatatyper
text- Utdatatyper
music- Utdataformat
- fullständiga ljudklipp som du äger / JSON-länkar
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser google/lyria | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältn | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 8 | Standard1 |
Fältcount | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 8 Villkor: Om även n anges måste count stämma överens | Standard— |
Kombinationer av indatamaterial
text_to_music · Krävs: prompt
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametermaterial_types | Avtaltext |
Parameterrequired | Avtalnull |
Parameteroptional_controls | Avtalnull |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Metodernas strukturer och ID:n är exakta; leverantörens funktioner är åtskilda från att begäran tillåts.
Priser
Priser för Ailoot-metoder
POST /v1/music/generations- Utdata
- 0,08 US$ per klipp
- Endast referens · läggs inte till
- 0,08 US$ per begäran
Levererade klipp × grundpris per klipp. Referenspriset per begäran läggs inte till. Exempel före tillämpliga justeringar.
1 × 0,08 US$ = 0,08 US$
4 × 0,08 US$ = 0,32 US$
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot · Musik
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
Ta emot och spara resultat
Ailoot · Musik
fullständiga ljudklipp som du äger / JSON-länkar
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behåll alla färdiga resultat
Behåll varje fullständigt returnerat svar, fil och innehållsdel.
Spara eller hämta varje returnerat klipp och bevara faktiskt ID, MIME och metadata. Metoden är synkron; ingen separat URL för kontroll av musikgenerering i Ailoot införs.
Om det ursprungliga svaret behöver kontrolleras
Om ett musikresultat kräver kontroll, behåll ursprungligt operation_id/X-Client-Request-ID och returnerade klippuppgifter. Återställ befintliga klipp som du äger via mediebiblioteket med faktiska task_id- eller asset_id-värden. Skicka inte musikbegäran igen och konstruera ingen URL för kontroll av genereringsstatus utifrån operation_id.
Svarsfält
| Fält | Typ |
|---|---|
Fältmodel | Typstring |
Fältresponse_id | Typstring |
Fältdata[] | Typowned clip record |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Alias
Modellalias
Ailoot google/lyria
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · Lyria
- Vilka indata och resultat finns?
POST /v1/music/generations·google/lyria:text→music- Vilka fält använder begäran?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Vilka gränser gäller?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8