Wenn Nutzer in deinem Produkt Songs hochladen können, können sie mit derselben Audiodatei verschiedene Arrangements und Gesangsstile ausprobieren. Dein Server speichert die Audio-ID, sendet einen Auftrag pro Remix-Richtung, fragt den Status ab und übergibt fertige Versionen an den Player.

Integration

Feld

Details

Endpunkt

POST /v1/song/remix

Modellparameter

model=mureka-9.5

Audioquelle

Lade Audio mit purpose=remix für eine upload_audio_id hoch oder nutze die song_id eines im letzten Monat mit Mureka erstellten Songs.

Länge

10–480 s

Ergebnisse pro Anfrage

n ist standardmäßig 2, maximal 3

Preis

Neue Version: $0.5 pro Titel (V8 bleibt bei $0.2 pro Titel).

Dokumentation

API-Dokumentation

Die Ausgabe interpretiert den Originalsong neu. Die Klangfarbe der Originalstimme bleibt dabei nicht erhalten. Eine bestimmte Gesangsstimme oder eine zusätzliche Audiodatei als Stilreferenz werden derzeit nicht unterstützt.

Modellauswahl: Setze model in der Anfrage auf mureka-9.5 für Remix V9.5 oder auf mureka-8 für V8.

Anwendungsfälle

  • Apps für Cover und Remixe: Aus einer A-cappella-Aufnahme entstehen voll arrangierte Versionen in mehreren Stilen.
  • Kurzvideos und Content-Plattformen: Eine Hintergrundmusik lässt sich für unterschiedliche Szenen als Rock-, Elektronik- oder Jazzversion arrangieren.
  • Musikschaffende und Produktionstools: Aus gesungenen, gespielten oder gesummten Demos entstehen schnell vollständige Arrangements für Stiltests.
  • Musik für Spiele und Werbung: Variiere die Intensität desselben Themas je nach Szene, wie in Demo B.

API-Ablauf

Originalaudio vorbereiten

Das Beispiel verwendet einen Song mit Gesang. Rufe POST /v1/files/upload mit purpose=remix auf und speichere die zurückgegebene Datei-ID. V9.5 akzeptiert MP3 und M4A mit 10 bis 480 Sekunden Länge. Bewahre den API-Schlüssel auf deinem Server auf und nutze Bearer-Authentifizierung.

curl --fail-with-body https://api.mureka.ai/v1/files/upload \
  -H "Authorization: Bearer ${MUREKA_API_KEY}" \
  -F "purpose=remix" \
  -F "file=@./original.mp3"

Für Songs aus der Mureka-API zur Songgenerierung kannst du eine zulässige song_id verwenden. Sende upload_audio_id für einen Upload oder song_id für einen vorhandenen Song. Wähle eine Option pro Anfrage und prüfe ihre Grenzen in der API-Referenz.

Einen Auftrag für eine Remix-Richtung senden

Sende die Upload-ID und einen prompt mit dem gewünschten Stil an POST /v1/song/remix. Das Beispiel setzt mureka-9.5 und fordert einen Rockremix mit Gesang an. Ersetze die Platzhalter durch die Upload-ID und den tatsächlichen Liedtext.

curl --fail-with-body https://api.mureka.ai/v1/song/remix \
  -H "Authorization: Bearer ${MUREKA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "upload_audio_id": "<UPLOAD_AUDIO_ID>",
    "model": "mureka-9.5",
    "lyrics": "<LYRICS_FOR_THIS_VERSION>",
    "prompt": "Keep the chorus melody. Use distorted guitars and live rock drums, with a restrained verse and a bigger chorus.",
    "n": 1
  }'

Mit n kannst du mehrere Varianten für denselben prompt anfordern. Für Rock, EDM und eine weibliche Leadstimme nutze dieselbe Upload-ID in drei Anfragen mit unterschiedlichen Vorgaben. Verknüpfe jeden Auftrag mit Originalaudio-ID, Versionsbezeichnung und Auftrags-ID.

Auftragsstatus abfragen und Ergebnisse abspielen

Speichere die zurückgegebene Auftrags-ID und rufe GET /v1/song/query/{task_id} auf. Zeige während der Erstellung einen Wartestatus und frage weiter ab. Nutze nach Erfolg die Audio-URL für die Wiedergabe. Protokolliere bei einem Fehler die Auftrags-ID und die Fehlermeldung.

curl --fail-with-body \
  "https://api.mureka.ai/v1/song/query/${TASK_ID}" \
  -H "Authorization: Bearer ${MUREKA_API_KEY}"

Verwende im Player denselben Songtitel für Original und Remixe und unterscheide sie per Versionsbezeichnung. So finden Nutzer zum Original zurück und erkennen die laufende Version.

API-Dokumentation