Introducción
Qué hace este endpoint
Divide una canción mezclada en cinco stems y devuelve cada uno como un archivo WAV propio.
Entradas importantes
audio_url es la única entrada: una canción MP3 o M4A de hasta 10 minutos.
Qué recibes
Cinco assets de audio, cada uno etiquetado en su campo stem: vocals, instrumental, drums, bass, other.
| Campo | Valor |
|---|---|
| Entrada | Audio |
| Salida | Audio |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
audio_url | Sí | La canción a separar: un MP3 subido o un enlace directo a un archivo MP3 o M4A, de hasta 10 minutos. WAV, FLAC y otros formatos se rechazan al enviarla y no se cobran. mínimo 1 caracteres |
Precios
$0.108 / canción
Un cobro fijo por canción sin importar su duración, hasta 10 minutos. Incluye los cinco stems. Las solicitudes fallidas no se cobran.
Casos de uso
Audio → Separación de audio → Audio
Separación de audio
Audio
Tarea asíncrona
Guía de prompts y consejos prácticos
Introducción
Mureka Stem Separation es el separador de stems de Mureka, la empresa de música con IA. Dale una canción terminada y mezclada y te devuelve sus partes: voz principal y coros en una pista, todo el acompañamiento en otra, y ese acompañamiento dividido otra vez en batería, bajo y todo lo demás.
Solicitud
{
"audio_url": "https://example.com/song.mp3"
}
La canción debe ser un archivo MP3 o M4A. WAV, FLAC y otros formatos se rechazan al enviarla.
Qué vuelve
La tarea devuelve cinco assets de audio, uno por stem, cada uno con un campo stem:
| stem | contenido |
|---|---|
vocals | voz principal y coros |
instrumental | todo menos las voces |
drums | percusión del instrumental |
bass | línea de bajo del instrumental |
other | el resto del instrumental: guitarras, teclados, colchones, efectos |
Cada stem es un WAV estéreo de 16 bits a 44,1 kHz con la duración exacta de la canción, así que los cinco quedan alineados desde la primera muestra en cualquier editor.
Qué vimos en las pruebas
Separamos un dueto de bossa nova de 60 segundos y un fragmento de 30 segundos de la misma canción. Ambos terminaron en unos diez segundos o menos. Batería, bajo y otros sumados reproducían el instrumental muestra por muestra. En los pasajes solo instrumentales, el stem de voz quedó casi en silencio, unos 55 dB por debajo de las partes cantadas, así que casi nada de la banda se coló en él. Un WAV de 60 segundos pesaba unos 10,6 MB.
Flujo de la tarea
La llamada es asíncrona: crea la tarea, consúltala hasta que termine y luego descarga cada stem desde el almacenamiento de SpicyAPI. Las solicitudes fallidas no se cobran.
Consejos
- Parte de la mejor copia que tengas; los artefactos de un MP3 muy comprimido pasan a todos los stems.
- Para una pista de karaoke usa
instrumental; para rehacer la mezcla con otro sonido de batería usavocals,bassyother. - Los stems van sin comprimir, así que una canción de tres minutos devuelve unos 160 MB de audio en total.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "mureka/stem-separation/audio-separation",
"input": {
"audio_url": "https://example.com/reference.mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.

