Lyria
Tekst-til-musikk med én til åtte forespurte klipp og synkron resultatlevering.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
google/lyria lager musikk fra skriftlig prompt via /v1/music/generations. En konkret oppgave er et dempet instrumentalspor til produktdemonstrasjon, med beskrivelse av forgrunnsinstrumenter og plass til fortellerstemmen. Velg ruten når ønsket resultat er et generert musikkklipp.
Forespørselen krever model og prompt. n eller count godtar én til åtte klipp, og metoden returnerer genereringsresultatet synkront. Lagre hvert returnert klipp og faktiske metadata. Oppføringen tilbyr ikke lydreferanseinndata, varighetsinnstilling eller tempofelt. Dette er ikke selvstendig valgbare kontroller. Beskriv musikalsk hensikt i prompten uten å behandle den som garantert målt utdataegenskap.
Ailoot · Musikk POST /v1/music/generations google/lyria
google/lyriaStart
Tekst-til-musikk med én til åtte forespurte klipp og synkron resultatlevering.
- Godkjente inndata
- Tekst
- Resultater
- music
Tilgjengelig i Ailoot · inndata & metoder
Ailoot · Musikk POST /v1/music/generations
- Inndatatyper
text- Utdatatyper
music- Utdataformat
- Fullstendige lydklipp du eier / JSON-lenker
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser google/lyria | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Minste lengde: 1 | Standard— |
Feltn | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 8 | Standard1 |
Feltcount | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 8 Vilkår: Hvis n også oppgis, må antallene samsvare | Standard— |
Kombinasjoner av inngående materialer
text_to_music · Påkrevd: prompt
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametermaterial_types | Avtaletext |
Parameterrequired | Avtalenull |
Parameteroptional_controls | Avtalenull |
Livssyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktisk returnert task_id eller oppføring i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Metodestrukturer og ID-er er eksakte; leverandørens evne er adskilt fra godkjenning av forespørselen.
Priser
Satser for Ailoot-metoder
POST /v1/music/generations- Utdata
- 0,08 USD per klipp
- Kun referanse · legges ikke til
- 0,08 USD per forespørsel
Levererte klipp × grunnpris per klipp. Referanseprisen per forespørsel legges ikke til. Eksempler før gjeldende justeringer.
1 × 0,08 USD = 0,08 USD
4 × 0,08 USD = 0,32 USD
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot · Musikk
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
Motta og lagre resultater
Ailoot · Musikk
Fullstendige lydklipp du eier / JSON-lenker
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behold alle ferdige resultater
Behold alle fullstendige returnerte svar, filer og innholdsdeler.
Lagre eller hent hvert returnert klipp, og behold faktisk ID, MIME og metadata. Metoden er synkron; det innføres ingen egen adresse for statusavlesning av musikkgenerering i Ailoot.
Hvis det opprinnelige svaret må kontrolleres
Hvis et musikkresultat må kontrolleres, behold den opprinnelige operation_id/X-Client-Request-ID og informasjonen om returnerte klipp. Gjenopprett eksisterende klipp du eier, via mediebiblioteket med faktiske task_id- eller asset_id-verdier. Ikke send musikkforespørselen på nytt eller bygg en URL for statusavlesning av genereringen fra operation_id.
Svarfelter
| Felt | Type |
|---|---|
Feltmodel | Typestring |
Feltresponse_id | Typestring |
Feltdata[] | Typeowned clip record |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldige påkrevde felter, materialrepresentasjon eller parameterverdi | Neste trinnKorriger de angitte feltene før en ny opprettelsesforespørsel. |
Svarserver_error | VilkårDet returnerte svaret angir at operasjonen eller resultatet må kontrolleres | Neste trinnBevar den opprinnelige returnerte operasjons-/oppgave-ID-en, forespørselshodene og svaret; fortsett å lese den opprinnelige operasjonen på de støttede måtene. Ikke send opprettelsesforespørselen på nytt. |
Aliaser
Modellaliaser
Ailoot google/lyria
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · Lyria
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/music/generations·google/lyria:text→music- Hvilke felt bruker forespørselen?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Hvilke grenser gjelder?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8