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

POST /v1/song/remix

Parámetro de modelo

model=mureka-9.5

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

Documentación de la API

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