Wie verwendet man die Mureka 9.5 API? In 5 Minuten den ersten Song fertigstellen

TL;DR

• Was ist das: Mureka 9.5 ist ein Musikgenerierungsmodell mit zwei Routen auf HiAPI – Lyrics-to-Song nimmt einen vollständigen Liedtext entgegen und liefert einen fertigen Song mit Hauptgesang, Backgroundgesang und Begleitung; Instrumental nimmt nur eine Beschreibung entgegen und liefert ein Instrumentalstück ohne Gesang. Mureka 9.5 ist bereits auf HiAPI verfügbar, öffne die Modellseite für Lyrics-to-Song, um online reinzuhören und zu generieren. Neue Nutzer erhalten bei der Registrierung 200 Credits geschenkt.
• Was kostet es: Jede erfolgreiche Generierung kostet $0.3215 (643 Credits), beide Routen kosten gleich viel, unabhängig von der Liedtextlänge und der Ausgabedauer. Bei Fehlschlag wird die Vorabbuchung erstattet. Für $10 gibt es etwa 31 Songs.
• Wie kommt man am schnellsten zum Laufen: Auf der Modellseite den Liedtext einfügen, den Hauptgesang auswählen, auf Ausführen klicken. Für die Integration in ein eigenes Produkt einfach POST /v1/tasks aufrufen, bei model mureka-9.5/lyrics-to-song eintragen, die taskId holen und per Polling die URL abrufen.

Was ist Mureka 9.5?

Der Liedtext ist fertig, es fehlt nur noch ein gesungenes Endprodukt: Die Lyrics-to-Song-Route von Mureka 9.5 verdichtet das auf eine einzige Anfrage. Man legt den vollständigen Liedtext in lyrics, ergänzt mit dem optionalen prompt Stilrichtung, Stimmung, Instrumente, Rhythmus und Gesangsmerkmale, legt mit gender fest, ob der Hauptgesang weiblich oder männlich ist, und erhält in einem Durchlauf einen fertig abgemischten Song als MP3, 44,1 kHz Stereo, ca. 256 kbps.

Die drei echten Beispiele auf der Seite sind 1:49, 3:02 und 3:30 lang und stammen alle aus derselben Route zum selben Stückpreis. Automatisches Schreiben von Liedtexten bietet es nicht, und es nimmt auch keine Referenzsongs oder Melodien entgegen. Die Eingabegrenze sind der Liedtext plus eine Stilrichtung.

Hör zuerst zwei echte Ergebnisse

City Night Drive aus der Lyrics-to-Song-Route und Wide-screen Overture aus der Instrumental-Route sind beide eine einzige Anfrage für $0.3215.

Anhören: City Night Drive, englischer Indie-Pop, 1:49

Lyrics-to-Song: City Night Drive · 1:49 · MP3 44,1 kHz Stereo 256 kbps

Anhören: Wide-screen Overture, filmische Orchestermusik, 3:12

Instrumental: Wide-screen Overture · 3:12 · MP3 44,1 kHz Stereo 256 kbps

Worin unterscheiden sich die beiden Routen

	Lyrics-to-Song	Instrumental
Modell-ID	mureka-9.5/lyrics-to-song	mureka-9.5/instrumental
Pflichtfelder	lyrics (1–5.000 Zeichen)	prompt (1–1.024 Zeichen)
Optionale Felder	prompt (1–2.000 Zeichen), gender (female / male)	keine
Ausgabe	Vollständiger Gesangsong	Instrumentalstück ohne Gesang
Dauer	Vom Modell anhand der Liedtextstruktur bestimmt	Vom Modell bestimmt, kein Dauerparameter
Stückpreis	$0.3215 / Aufruf	$0.3215 / Aufruf

Wer einen Gesangsong will, nimmt die linke Seite, wer Filmmusik will, die rechte. Auf beiden Seiten gibt es kein Feld für die Dauer. Die drei Instrumentalbeispiele auf der Seite sind 3:12, 3:08 und 3:03.

Online ausprobieren: 4 Schritte

1. Öffne die Modellseite für Lyrics-to-Song, auf der Seite kann man die drei Beispiele direkt anhören.
2. Den vollständigen Liedtext zeilenweise in das Liedtextfeld einfügen und mit Abschnittsmarkierungen wie [Verse 1], [Chorus] unterteilen.
3. Im Feld für die Stilrichtung Stil, Stimmung, Instrumente und Gesangsmerkmale eintragen; als Geschlecht des Hauptgesangs weiblich oder männlich wählen.
4. Auf „Ausführen“ klicken und nach Abschluss des Tasks abspielen und herunterladen. Jeder Aufruf kostet $0.3215.

Bei Instrumental ersetzt man Schritt 2 durch eine Instrumentalbeschreibung, öffne die Modellseite für Instrumental, ebenfalls in vier Schritten.

Für den ersten Versuch kann man für die Stilrichtung direkt diesen Prompt verwenden:

Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.

Mit diesem Prompt generieren →

Nach dem Öffnen wird er in das Feld für die Stilrichtung eingetragen; dann noch vier eigene Zeilen Liedtext einfügen, weiblichen Hauptgesang wählen, und der erste Song kann laufen.

API-Integration: 4 Schritte

1. Nach der Registrierung im Console einen API-Key erstellen.
2. Mit POST https://api.hiapi.ai/v1/tasks model und input übermitteln.
3. Aus der zurückgegebenen data.taskId die Task-ID entnehmen und GET /v1/tasks/{taskId} pollen oder auf den Callback warten.
4. Nachdem der Status success geworden ist, aus data.output den Eintrag mit type=audio entnehmen und die MP3 herunterladen.

Lyrics-to-Song: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
      "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
      "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
      "gender": "female"
    }
  }'

Die Task-ID aus der Antwort entnehmen:

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

Instrumental: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/instrumental",
    "input": {
      "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb."
    }
  }'

Status abfragen:

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

data.status kann nacheinander queued, handling, success oder fail sein.

Python: Task erstellen, pollen, Link abrufen

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
        "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
        "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
        "gender": "female",
    },
}

resp = requests.post(BASE, headers=HEADERS, json=payload, timeout=30)
task_id = resp.json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

if data["status"] == "success":
    audio_url = next(item["url"] for item in data["output"] if item["type"] == "audio")
    print(audio_url)
else:
    print(data.get("error"))

Für Instrumental gilt dieselbe Polling-Logik, nur der übermittelte Inhalt ändert sich; es läuft auch eigenständig:

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/instrumental",
    "input": {
        "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb.",
    },
}

task_id = requests.post(BASE, headers=HEADERS, json=payload, timeout=30).json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

print(next((item["url"] for item in data.get("output", []) if item["type"] == "audio"), data.get("error")))

Ausgabe und Format

Jede Anfrage liefert eine MP3, 44,1 kHz, Stereo, ca. 256 kbps. Beim Herunterladen sucht man in data.output den Eintrag, dessen type audio ist; nicht auf der obersten Ebene der Antwort nach einer Zeichenkette suchen.

Die zurückgegebene url läuft ab; vor dem Speichern in der Datenbank die Datei zunächst in den eigenen Speicher übertragen.

Worauf vor dem Livegang zu achten ist

1. Callback plus Polling als Absicherung. Im Request-Body kann man "callback": {"url": "https://yourapp.com/webhook", "when": "final"} mitgeben; der Task benachrichtigt beim Erreichen des Endzustands. Benachrichtigungen können verloren gehen, daher zusätzlich eine regelmäßige Abfrage einrichten.
2. taskId zuerst speichern, nicht doppelt POSTen. Jede Task-Erstellung wird abgerechnet; bei einem Client-Timeout kann der Task bereits erstellt worden sein. Die taskId in der Datenbank ablegen und vor einem erneuten Versuch zuerst den Status prüfen.
3. Liedtext zeilenweise unterteilen. Eine Zeile pro Satz, Reihenfolge von Strophe und Refrain beibehalten und Abschnittsmarkierungen klar schreiben; das ergibt eine deutlich stabilere Struktur. Obergrenze 5.000 Zeichen.
4. Geschlecht des Hauptgesangs explizit angeben. Ohne Angabe entscheidet das Modell; für Serien-Songs oder Markensongs female oder male festlegen, damit die Stimme bei gleichem Material konsistent bleibt.

FAQ

Kann der Liedtext leer bleiben, damit das Modell ihn automatisch schreibt? Nein. lyrics ist Pflicht, 1–5.000 Zeichen. Wer automatische Liedtexte braucht, sollte ein Musikmodell verwenden, das automatische Liedtexte unterstützt.

Wie lang kann ein Song maximal sein? Es gibt keinen Dauerparameter; die Länge bestimmt das Modell anhand der Liedtextstruktur. Die drei Lyrics-to-Song-Beispiele auf der Seite sind 1:49, 3:02 und 3:30, die drei Instrumentalbeispiele 3:12, 3:08 und 3:03.

Enthält Instrumental Gesang? Nein. Die Instrumental-Route erzeugt keinen Gesangsgesang, auch wenn in der Beschreibung ein Hauptgesang erwähnt wird; wer Gesang will, wechselt zur Lyrics-to-Song-Route.

Wird bei einer fehlgeschlagenen Generierung Geld abgebucht? Nein. Der vorab gebuchte Betrag fehlgeschlagener Tasks wird automatisch erstattet.

Jetzt den ersten Song fertigstellen

Den obigen curl in das Terminal einfügen, YOUR_API_KEY durch den eigenen Key und den Liedtext durch den eigenen ersetzen, schon erhält man die erste taskId. Wer zuerst das Ergebnis sehen will, öffnet direkt die Modellseite für Lyrics-to-Song und klickt auf Ausführen. Die vollständige Dokumentation findet sich in der Integrationsdokumentation für Lyrics-to-Song und der Integrationsdokumentation für Instrumental.

Weitere Lektüre: Mureka 9.5 Preise: ein Song für $0.3215 · Mureka 9.5 vs MiniMax Music 2.6 · Mureka 9.5 Prompt-Sammlung: 6 echte Beispiele