Se il tuo prodotto consente di caricare brani, gli utenti possono provare più arrangiamenti e voci a partire dallo stesso audio. Il server conserva l’ID, invia una richiesta per ogni direzione creativa, ne verifica lo stato e passa le versioni pronte al lettore.
Integrazione
Campo | Dettagli |
|---|---|
Endpoint |
|
Parametro del modello |
|
Origine audio | Carica audio con purpose=remix per ottenere upload_audio_id oppure usa il song_id di un brano creato con Mureka nell’ultimo mese. |
Durata | 10–480 s |
Risultati per richiesta | n è 2 per impostazione predefinita, massimo 3 |
Prezzo | Nuova versione: $0.5 per brano (la V8 resta a $0.2 per brano). |
Documentazione |
Il risultato reinterpreta il brano originale e non conserva il timbro di chi lo canta. Al momento non puoi specificare il timbro di un cantante preciso né caricare un altro audio come riferimento di stile.
Scelta del modello: nella richiesta, imposta model su mureka-9.5 per usare Remix V9.5 oppure su mureka-8 per usare V8.
Casi d’uso
- App di cover e remix: parti da una registrazione a cappella e crea versioni complete in più stili.
- Video brevi e piattaforme di contenuti: declina la stessa musica di sottofondo in rock, elettronica o jazz per adattarla alle scene.
- Musicisti e strumenti di produzione: trasforma rapidamente una demo suonata, cantata o canticchiata in un arrangiamento completo.
- Musica per giochi e pubblicità: varia l’intensità dello stesso tema in base alla scena, come nella Demo B.
Sequenza di chiamate all’API
Prepara l’audio originale
L’esempio usa un brano cantato. Chiama POST /v1/files/upload impostando purpose su remix e salva l’ID restituito. V9.5 accetta MP3 e M4A da 10 a 480 secondi. Conserva la chiave API sul server e usa l’autenticazione Bearer.
curl --fail-with-body https://api.mureka.ai/v1/files/upload \
-H "Authorization: Bearer ${MUREKA_API_KEY}" \
-F "purpose=remix" \
-F "file=@./original.mp3"
Per un brano creato con l’API di generazione di Mureka, puoi usare un song_id idoneo. Usa upload_audio_id per un file caricato o song_id per un brano esistente. Scegli una sola opzione per richiesta e controlla i limiti nella documentazione.
Invia una richiesta per una direzione di remix
Invia l’ID di caricamento e un prompt con lo stile desiderato a POST /v1/song/remix. L’esempio specifica mureka-9.5 e richiede un remix rock cantato. Sostituisci i segnaposto con l’ID restituito e il testo da cantare.
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
}'
Usa n per chiedere più alternative con lo stesso prompt. Per versioni rock, EDM e con voce femminile, riusa l’ID di caricamento in tre richieste con indicazioni diverse. Associa a ciascuna attività l’ID dell’audio originale, il nome della versione e l’ID dell’attività.
Verifica lo stato e presenta i risultati
Conserva l’ID restituito e chiama GET /v1/song/query/{task_id}. Durante la generazione, mostra lo stato di attesa e continua a verificare. Se la generazione riesce, usa l’URL audio per l’ascolto. Se fallisce, registra l’ID e l’errore.
curl --fail-with-body \
"https://api.mureka.ai/v1/song/query/${TASK_ID}" \
-H "Authorization: Bearer ${MUREKA_API_KEY}"
Nel lettore puoi usare lo stesso titolo per l’originale e i remix, distinguendoli con il nome della versione. Gli utenti possono tornare all’originale e riconoscere la versione in riproduzione.
Documentazione API