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 |
|
Modellparameter |
|
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 |
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