Google

Lyria 3.5

lyria-3.5

Googles Flaggschiff-Modell zur Musikgenerierung, das zunächst die Struktur wie Intro, Strophe und Refrain plant und dann einen vollständigen Song mit Gesang und Liedtext erzeugt; unterstützt mehrsprachigen Gesang und ist über die einheitliche Schnittstelle von HiAPI.ai aufrufbar

lyria-3.5

lyria-3.5 ausprobieren

Eingabe

Lyrics

Galerie

Alle Arbeiten ansehen

Ausgabe

audio

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

lyria-3.5 per song

Einzelpreis	$0.090

Einordnung und Kurzprofil

Lyria 3.5 ist ein Modell für die Text-zu-Musik-Generierung, das über die einheitliche Schnittstelle von HiAPI.ai aufgerufen werden kann. Es kann sowohl aus einer Musikbeschreibung (Genre, Instrumente, Stimmung, Struktur) ein vollständiges Stück erzeugen als auch direkt Liedtexte mit Abschnittsmarkierungen wie [Verse] und [Chorus] zum Gesang einreichen; dabei lassen sich Länge, BPM, Titel und ein zufälliger Seed angeben. Die Ausgabe ist ein vollständiges Lied mit Gesang und eignet sich für Entwickler, die schnell ein klar strukturiertes fertiges Ergebnis benötigen, etwa für Untermalungsmusik von Inhalten, mehrsprachige Lieder und die Validierung kreativer Demos.

Zentrale Highlights

Das gesamte Lied wird abschnittsweise organisiert statt aus Fragmenten zusammengesetzt – vor der Generierung werden Intros, Strophen, Refrain, Bridge und weitere Strukturen geplant, sodass das Ergebnis klar gegliedert und durchgängig zusammenhängend ist.
Bereits eine Beschreibung oder ein Liedtext genügt für ein Stück – mit nur einer Musikbeschreibung lassen sich rein instrumentale Werke oder Vokalstücke erzeugen; mit nur einem Liedtext geht es direkt in die Gesangsgenerierung.
Länge und Tempo lassen sich in der Anfrage festlegen – eine Zieldauer von 1 bis 240 Sekunden und ein numerischer BPM-Wert können angegeben werden, um die Länge passend zum Einsatzort zu planen.

Funktionsbeschreibung

Ganzes Stück aus Textbeschreibung: Mit einer Beschreibung von bis zu 10000 Zeichen zu Genre, Instrumenten, Stimmung und Struktur erhält man direkt ein vollständiges Musikstück und spart manuelle Arrangier- und Schnittschritte.

Gesang auf Basis von Liedtexten: Mit eingereichten Liedtexten inklusive Abschnittsmarkierungen lässt sich ein Lied mit Gesang erzeugen; zusätzlich kann ein Titel angegeben werden, sodass ein direkt anhörbares Text-Musik-Demo entsteht.

Dauer und Tempo steuerbar: Es kann eine Zieldauer von 1 bis 240 Sekunden sowie ein BPM-Wert angegeben werden; die tatsächliche Ausgabedauer kann von der angeforderten abweichen, daher sollte ein Bereich statt eines exakten Werts eingeplant werden.

Zufälliger Seed und reproduzierbare Versuche: Ein numerischer Seed kann übergeben werden, um mehrere Generierungsrunden zu organisieren, doch garantieren gleiche Einstellungen keine vollständig identische Audioausgabe; geeignet für Variantenexploration statt deterministischer Reproduktion.

Ausgabe als reine Audiodatei: Es wird eine fertige Audiodatei zurückgegeben, die direkt in eine Medienbibliothek oder einen späteren Distributionsprozess gelangen kann, ohne weitere Formatkonvertierung.

Anwendungsfälle

Untermalungsmusik für Kurzvideos und Podcasts von Content-Creatoren – eine Musikbeschreibung zu Atmosphäre und Rhythmus eingeben und Hintergrundmusik erhalten, die zur Länge des fertigen Videos passt, direkt verwendbar in der Schnitt-Timeline.
Hörprobe-Demos von Liedtexten für Musikschaffende – Liedtexte mit [Verse]- und [Chorus]-Markierungen einreichen und eine anhörbare Gesangsversion erzeugen, zur Validierung von Text- und Musikideen und zum Vergleichen von Versionen.
Individuelle Musik für Werbung und Markeninhalte – originale Stücke passend zur Bildstimmung anhand von Genre-, Instrumenten- und Stimmungsbeschreibungen erzeugen, als Musikgrundlage für Werbematerial.
Musikprototypen für Spiele und interaktive Medien – mit Beschreibungen sowie BPM- und Längenvorgaben atmosphärische Ausschnitte im Batch erzeugen, als frühe Prototypen für Level- oder Interface-Musik zur Teamabstimmung.

Einschränkungen und Auswahlhinweise

Es werden nur Text- und Liedtexteingaben unterstützt, keine Bildführung; die Ausgabe ist eine Audiodatei mit Wasserzeichen, und die Generierungsergebnisse können nicht zwischengespeichert werden. Ein einzelnes Stück dauert im Sekunden- bis Minutenbereich und eignet sich nicht für lange durchgehende Untermalung oder verlustfreie High-Fidelity-Lieferung. Die tatsächliche Ausgabedauer und Audiodetails sind nicht garantiert vollständig identisch mit den angeforderten Parametern, und derselbe Seed kann nicht dasselbe Ergebnis reproduzieren. Wenn eine präzise steuerbare Audiobearbeitung, Stems oder deterministische Reproduktion nötig sind, sollten andere Lösungen geprüft werden; hier liegt der Vorteil eher in der schnellen Erzeugung vollständiger, strukturell ausgereifter Musikstücke.

Neuigkeiten

Changelog ansehen →

Neues Modell API-Dokumentation für lyria-3.5 hinzugefügt Sep 11, 2026

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: lyria-3.5

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für lyria-3.5 und Route default — siehe Parametertabelle unten.

bpmstringOptionalpattern ^[1-9][0-9]*(\.[0-9]+)?$

Optional, gibt die Geschwindigkeit (BPM) des generierten Stücks an, übergeben als numerischer String, Wert mindestens 1.

seedstringOptionalminLength 1pattern ^[0-9]+$

Optional, Zufallsseed, übergeben als numerischer String; gleiche Einstellungen garantieren nicht, dass exakt dieselbe Audiodatei generiert wird.

titlestringOptional

Optional, legt einen Titel für den generierten Song fest.

lengthintegerOptionalmin 1max 240

Optional, angeforderte Audiodauer (Sekunden), Wertebereich 1 bis 240; die tatsächliche Ausgabedauer kann davon abweichen.

lyricsstringOptionalminLength 1pattern \S

Optional, Liedtext, Abschnitts-Tags wie [Verse], [Chorus] usw. können verwendet werden; Liedtext und Musikbeschreibung – mindestens eines von beiden muss angegeben werden.

promptstringOptionalminLength 1maxLength 10000pattern \S

Optional, Musikbeschreibung zur Angabe von Stil, Instrumenten, Stimmung und Struktur; Musikbeschreibung und Liedtext – mindestens eines von beiden muss angegeben werden.

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "lyria-3.5",
  "input": {}
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "lyria-3.5",
    input: {}
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "lyria-3.5",
        "input": {}
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}