Lyria
Musik aus Text mit einem bis acht gewünschten Clips und synchroner Ergebnisrückgabe.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
google/lyria erzeugt Musik aus einem schriftlichen Prompt über /v1/music/generations. Ein konkreter Einsatz ist eine zurückhaltende instrumentale Begleitung einer Produktdemo mit Angaben zu Vordergrundinstrumenten und Freiraum für die Erzählstimme. Wähle die Route für einen generierten Musikclip als Ergebnis.
Die Anfrage benötigt model und prompt. n oder count akzeptiert einen bis acht Clips; die Methode liefert das Generierungsergebnis synchron. Sichere alle zurückgegebenen Clips samt tatsächlichen Metadaten. Audioreferenzeingabe, Dauer- und Tempofeld werden nicht angeboten und sind deshalb nicht unabhängig wählbar. Beschreibe musikalische Absichten im Prompt, ohne sie als garantierte gemessene Ausgabeeigenschaften zu behandeln.
Ailoot · Musik POST /v1/music/generations google/lyria
google/lyriaEinstieg
Musik aus Text mit einem bis acht gewünschten Clips und synchroner Ergebnisrückgabe.
- Zulässige Eingaben
- Text
- Ergebnisse
- music
In Ailoot verfügbar · Eingaben und Methoden
Ailoot · Musik POST /v1/music/generations
- Eingabe
text- Ausgabe
music- Ausgabeformat
- vollständige, Ihnen zugeordnete Audioclips / JSON-Links
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits google/lyria | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 8 | Standard1 |
Feldcount | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 8 Bedingungen: Wenn auch n angegeben wird, muss die Anzahl übereinstimmen | Standard— |
Kombinationen von Eingabematerialien
text_to_music · Erforderlich: prompt
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext |
Parameterrequired | Vertragnull |
Parameteroptional_controls | Vertragnull |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
Tarife
Ailoot-Methodentarife
POST /v1/music/generations- Ausgabe
- $ 0,08 pro Clip
- Nur Referenz · nicht addiert
- $ 0,08 pro Anfrage
Gelieferte Clips × Grundpreis je Clip. Der Referenzpreis je Anfrage wird nicht addiert. Beispiele vor anwendbaren Anpassungen.
1 × $ 0,08 = $ 0,08
4 × $ 0,08 = $ 0,32
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
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
Ergebnisse abrufen und speichern
Ailoot · Musik
vollständige, Ihnen zugeordnete Audioclips / JSON-Links
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Speichern oder laden Sie jeden zurückgegebenen Clip und bewahren Sie die tatsächliche ID, den MIME-Typ und die Metadaten auf. Die Methode ist synchron; es wird keine separate Ailoot-Abfrage-URL für die Musikgenerierung eingeführt.
Wenn die ursprüngliche Antwort geprüft werden muss
Falls ein Musikergebnis eine Prüfung erfordert, bewahren Sie die ursprüngliche operation_id/X-Client-Request-ID und die zurückgegebenen Clipinformationen auf. Stellen Sie vorhandene, Ihnen zugeordnete Clips über die Medienbibliothek anhand tatsächlicher task_id- oder asset_id-Werte wieder her. Übermitteln Sie die Musikanfrage nicht erneut und konstruieren Sie aus operation_id keine Abfrage-URL für die Generierung.
Antwortfelder
| Feld | Typ |
|---|---|
Feldmodel | Typstring |
Feldresponse_id | Typstring |
Felddata[] | Typowned clip record |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Aliasnamen
Modellaliasnamen
Ailoot google/lyria
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Lyria
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/music/generations·google/lyria:text→music- Welche Felder verwendet die Anfrage?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Welche Grenzen gelten?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8