Lyria
Muzyka z tekstu, od jednego do ośmiu klipów, ze synchronicznym wynikiem.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
google/lyria tworzy muzykę z promptu przez /v1/music/generations. Przykład: stonowany podkład instrumentalny do demonstracji produktu z opisem głównych instrumentów i miejsca dla narracji. Wybierz trasę, gdy potrzebny jest klip muzyczny.
Wymagane model i prompt; n lub count przyjmuje od jednego do ośmiu klipów. Wynik jest synchroniczny; zachowaj każdy klip i faktyczne metadane. Brak wejścia audio referencyjnego, długości i pola tempa. Intencję muzyczną opisz w prompcie, bez traktowania jako gwarantowanej zmierzonej cechy wyniku.
Ailoot · Muzyka POST /v1/music/generations google/lyria
google/lyriaStart
Muzyka z tekstu, od jednego do ośmiu klipów, ze synchronicznym wynikiem.
- Akceptowane dane wejściowe
- Tekst
- Wyniki
- music
Dostępne w Ailoot · dane wejściowe i metody
Ailoot · Muzyka POST /v1/music/generations
- Wejście
text- Wyjście
music- Format wyjściowy
- kompletne klipy dźwiękowe należące do użytkownika / odnośniki w JSON
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity google/lyria | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Minimalna długość: 1 | Domyślnie— |
Polen | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 8 | Domyślnie1 |
Polecount | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 8 Warunki: Jeśli podano również n, liczba musi się zgadzać | Domyślnie— |
Kombinacje materiałów wejściowych
text_to_music · Wymagane: prompt
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrmaterial_types | Kontrakttext |
Parametrrequired | Kontraktnull |
Parametroptional_controls | Kontraktnull |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktury metod i ID są dokładne; możliwości dostawcy są odrębne od dopuszczenia żądania.
Cennik
Stawki metod Ailoot
POST /v1/music/generations- Wyjście
- 0,08 USD za klip
- Tylko referencja · nie dodawana
- 0,08 USD za żądanie
Dostarczone klipy × stawka bazowa za klip. Stawka referencyjna za żądanie nie jest dodawana. Przykłady przed stosownymi korektami.
1 × 0,08 USD = 0,08 USD
4 × 0,08 USD = 0,32 USD
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
Ailoot · Muzyka
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
Odbieranie i zapisywanie wyników
Ailoot · Muzyka
kompletne klipy dźwiękowe należące do użytkownika / odnośniki w JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Zachowaj wszystkie ukończone wyniki
Zachowaj każdą kompletną zwróconą odpowiedź, plik i część treści.
Zapisz lub pobierz każdy zwrócony klip i zachowaj jego rzeczywisty identyfikator, MIME i metadane. Metoda jest synchroniczna; nie wprowadza się osobnego adresu URL do odpytywania generowania muzyki w Ailoot.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Jeśli wynik muzyczny wymaga sprawdzenia, zachowaj pierwotne operation_id/X-Client-Request-ID i zwrócone informacje o klipach. Odzyskaj istniejące klipy należące do użytkownika z biblioteki multimediów, używając rzeczywistych wartości task_id lub asset_id. Nie wysyłaj ponownie żądania muzycznego ani nie twórz adresu URL do odpytywania generowania na podstawie operation_id.
Pola odpowiedzi
| Pole | Typ |
|---|---|
Polemodel | Typstring |
Poleresponse_id | Typstring |
Poledata[] | Typowned clip record |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowe wymagane pola, sposób reprezentacji materiału lub wartość parametru | Następny krokPopraw wskazane pola przed nowym żądaniem utworzenia. |
Odpowiedźserver_error | WarunekZwrócona odpowiedź wskazuje, że operacja lub wynik wymaga sprawdzenia | Następny krokZachowaj pierwotnie zwrócony identyfikator operacji lub zadania, nagłówki żądania i odpowiedź; kontynuuj obsługiwane odczyty tej pierwotnej operacji. Nie wysyłaj ponownie żądania utworzenia. |
Aliasy
Aliasy modelu
Ailoot google/lyria
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · Lyria
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/music/generations·google/lyria:text→music- Jakich pól używa żądanie?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Jakie limity obowiązują?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8