Lyria
Tekstistä musiikiksi -generointi yhdestä kahdeksaan pyydetyllä leikkeellä ja synkronisella tulostoimituksella.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
google/lyria luo musiikkia kirjallisesta kehotteesta /v1/music/generations-päätepisteessä. Konkreettinen käyttö on hillityn instrumentaalitaustan pyytäminen tuote-esittelyyn kuvaamalla etualan soittimet ja kerronnan tarvitsema tila. Valitse reitti, kun haluttu tulos on generoitu musiikkileike.
Pyyntö vaatii model- ja prompt-kentät. n- tai count-säädin hyväksyy yhdestä kahdeksaan leikettä, ja menetelmä palauttaa generointituloksen synkronisesti. Tallenna jokainen palautettu leike ja sen todellinen metadata. Merkintä ei tarjoa ääniviitesyötettä, kestoasetusta tai tempokenttää, joten ne eivät ole itsenäisesti valittavia säätimiä. Kuvaile musiikillinen tarkoitus kehotteessa pitämättä sitä tuloksen taattuna mitattuna ominaisuutena.
Ailoot · Musiikki POST /v1/music/generations google/lyria
google/lyriaAloitus
Tekstistä musiikiksi -generointi yhdestä kahdeksaan pyydetyllä leikkeellä ja synkronisella tulostoimituksella.
- Hyväksytyt syötteet
- Teksti
- Tulokset
- music
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot · Musiikki POST /v1/music/generations
- Syötetyypit
text- Tulostyypit
music- Tulosteen muoto
- kokonaiset käyttäjälle kuuluvat äänileikkeet / JSON-linkit
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat google/lyria | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Vähimmäispituus: 1 | Oletus— |
Kenttän | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 8 | Oletus1 |
Kenttäcount | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 8 Ehdot: Jos myös n annetaan, lukumäärien on täsmättävä | Oletus— |
Syöteaineistojen yhdistelmät
text_to_music · Pakollinen: prompt
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametrimaterial_types | Sopimustext |
Parametrirequired | Sopimusnull |
Parametrioptional_controls | Sopimusnull |
Elinkaari: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Menetelmien rakenteet ja ID:t ovat täsmällisiä; toimittajan kyvykkyys on erillinen pyynnön hyväksymisestä.
Hinnoittelu
Ailoot-menetelmien hinnat
POST /v1/music/generations- Tuloste
- 0,08 $ leikettä kohden
- Vain viite · ei lisätä
- 0,08 $ pyyntöä kohden
Toimitetut leikkeet × leikkeen perushinta. Pyyntökohtaista viitehintaa ei lisätä. Esimerkit ennen sovellettavia muutoksia.
1 × 0,08 $ = 0,08 $
4 × 0,08 $ = 0,32 $
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Esimerkkipyynnöt
Ailoot · Musiikki
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
Vastaanota ja tallenna tulokset
Ailoot · Musiikki
kokonaiset käyttäjälle kuuluvat äänileikkeet / JSON-linkit
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Säilytä kaikki valmistuneet tulokset
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Tallenna tai nouda jokainen palautettu leike ja säilytä sen todellinen tunniste, MIME-tyyppi ja metatiedot. Menetelmä on synkroninen; erillistä Ailoot-musiikinluonnin tilakyselyosoitetta ei oteta käyttöön.
Jos alkuperäinen vastaus on tarkistettava
Jos musiikkitulos edellyttää tarkistusta, säilytä alkuperäinen operation_id/X-Client-Request-ID ja palautettujen leikkeiden tiedot. Palauta olemassa olevat käyttäjälle kuuluvat leikkeet mediakirjastosta todellisilla task_id- tai asset_id-arvoilla. Älä lähetä musiikkipyyntöä uudelleen äläkä muodosta luontityön tilakyselyn URL-osoitetta operation_id-arvosta.
Vastauksen kentät
| Kenttä | Tyyppi |
|---|---|
Kenttämodel | Tyyppistring |
Kenttäresponse_id | Tyyppistring |
Kenttädata[] | Tyyppiowned clip record |
Virheet ja seuraavat vaiheet
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Vastausserver_error | EhtoPalautettu vastaus ilmoittaa, että operaatio tai tulos edellyttää tarkistusta | Seuraava vaiheSäilytä alkuperäinen palautettu operaation tai tehtävän ID, pyynnön otsakkeet ja vastaus; jatka kyseisen alkuperäisen operaation tuettuja lukutoimintoja. Älä lähetä luontipyyntöä uudelleen. |
Aliakset
Mallin aliakset
Ailoot google/lyria
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
FAQ · Lyria
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/music/generations·google/lyria:text→music- Mitä kenttiä pyyntö käyttää?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Mitä rajoja sovelletaan?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8