Si tu producto permite subir canciones, los usuarios pueden probar distintos arreglos y voces con el mismo audio. El servidor guarda el ID, envía una tarea por cada enfoque y consulta su estado antes de pasar las versiones terminadas al reproductor.
Integración
Campo | Descripción |
|---|---|
Endpoint |
|
Parámetro de modelo |
|
Origen del audio | Sube audio con purpose=remix para obtener upload_audio_id o usa el song_id de una canción generada en Mureka durante el último mes. |
Duración | 10–480 s |
Resultados por solicitud | n es 2 por defecto y admite un máximo de 3 |
Precio | Nueva versión: $0.5 por canción (V8 se mantiene en $0.2 por canción). |
Documentación |
El resultado reinterpreta la canción original y no conserva el timbre del cantante original. Actualmente tampoco se admite indicar el timbre de un cantante concreto ni subir otro audio como referencia de estilo.
Selección del modelo: en la solicitud, asigna mureka-9.5 a model para usar Remix V9.5 o mureka-8 para usar V8.
Casos de uso
- Apps de versiones y remezclas: convierte una grabación a capela en versiones con arreglos completos en distintos estilos.
- Vídeo corto y plataformas de contenido: adapta una misma pista de fondo a rock, electrónica o jazz según el ambiente de cada escena.
- Músicos y herramientas de producción: convierte rápidamente una demo cantada, tocada o tarareada en un arreglo completo para explorar estilos.
- Música para juegos y anuncios: crea variaciones de un mismo tema con distinta intensidad, como en la demo B.
Flujo de llamadas a la API
Prepara el audio original
El ejemplo usa una canción con voz. Llama a POST /v1/files/upload, configura purpose como remix y guarda el ID devuelto. V9.5 admite MP3 y M4A de 10 a 480 segundos. Guarda la clave de API en el servidor y usa autenticación 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"
Si la canción se creó con la API de generación de Mureka, puedes usar un song_id que cumpla los requisitos. Envía upload_audio_id para un archivo subido o song_id para una canción existente. Usa una opción por solicitud y consulta los límites de cada una en la referencia.
Envía una tarea para un enfoque de remezcla
Envía el ID de subida y un prompt con el estilo deseado a POST /v1/song/remix. El ejemplo especifica mureka-9.5 y solicita una versión rock con voz. Sustituye los marcadores por el ID devuelto y la letra que se va a cantar.
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 para pedir varias opciones con el mismo prompt. Para rock, EDM y una versión con voz femenina, reutiliza el ID de subida en tres solicitudes distintas. Vincula cada tarea con el ID de audio original, la etiqueta de versión y el ID de tarea para identificar el resultado.
Consulta el estado y muestra los resultados
Guarda el ID de tarea devuelto y consulta GET /v1/song/query/{task_id}. Mientras se genera el audio, muestra un estado de espera y sigue consultando. Si termina correctamente, usa la URL del audio para reproducirlo. Si falla, registra el ID y el error.
curl --fail-with-body \
"https://api.mureka.ai/v1/song/query/${TASK_ID}" \
-H "Authorization: Bearer ${MUREKA_API_KEY}"
En el reproductor, usa el mismo título para la canción original y las remezclas y distínguelas con etiquetas. Así se puede volver al original y saber qué versión suena.
Documentación de la API