Introducción
Separa una grabación existente en voz y audio de fondo con una sola solicitud. Usa las dos pistas separadas para practicar música, editar narraciones o crear una nueva mezcla.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Audio |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
audio_url | Sí | La grabación mezclada que se va a separar, proporcionada como URL de audio. El control de carga acepta MP3 o WAV. mínimo 1 caracteres |
Precios
$0.0012 / segundo
Se factura una sola vez por segundo de audio de entrada, redondeando al segundo entero superior. Ambas pistas se incluyen en el mismo cargo por duración. Este endpoint admite de 1 a 600 segundos.
Casos de uso
Texto → audio-separation → Audio
audio-separation
Audio
Tarea asíncrona
Guía de prompts y consejos prácticos
Introducción
Vocal Isolator separa una grabación de audio existente en una pista de voz y una pista de fondo. Envía la grabación mezclada mediante audio_url; no hace falta un prompt ni una tarea de música generada previamente. Este endpoint permite trabajar con sonido que ya tienes, como el ensayo de una canción, un clip narrado o una grabación de podcast con música de fondo.
Funciones principales y aspectos destacados
Dos pistas separadas de una grabación
La tarea está pensada para devolver ambas partes de la misma fuente: primero la voz y después el resto del fondo. En música, el fondo es el acompañamiento instrumental. En una grabación hablada, puede incluir música y sonidos del entorno. Son pistas relacionadas procedentes de un único procesamiento, en lugar de dos generaciones alternativas entre las que elegir. La separación puede dejar filtraciones audibles o eliminar detalles que se superponen entre ambas partes.
La duración de la fuente determina la cantidad facturada
La facturación sigue la duración de la grabación de entrada, redondeada al segundo entero superior. Recibir dos pistas no duplica esa duración. Este endpoint admite grabaciones de 1 a 600 segundos. No ofrece ajustes para solicitar una duración de salida, seleccionar un hablante o elegir un códec de salida. Conserva la mezcla original junto con ambos resultados para comparar la separación sin perder la grabación de la que partiste.
Casos de uso
Preparar una pista para practicar música
Usa la pista de fondo para ensayar con tu propio acompañamiento y conserva la pista de voz para comprobar el fraseo. Escucha tanto las pausas como los pasajes de mayor volumen: pueden quedar reverberación y coros en el acompañamiento. Compara a niveles de escucha similares antes de decidir si una pista es adecuada para el ensayo.
Separar la narración de una mezcla existente
Si un clip tiene voz sobre música, escucha el resultado vocal antes de colocarlo en una nueva edición. La pista de fondo puede servir como referencia de edición, pero no se garantiza que contenga solo música. Mantén ambas pistas alineadas con el mismo inicio de la fuente cuando las compares en el editor.
Guía de prompts y consejos prácticos
Preparar la grabación de origen
No hay ningún prompt que ajustar. Sube la versión más clara que tengas de la grabación mezclada, en lugar de una grabación de la reproducción por altavoces o de una copia con compresión adicional. Usa MP3 o WAV mediante el control de carga. Este endpoint procesa el archivo completo proporcionado; prepara primero un clip de origen independiente si solo necesitas parte de una grabación más larga. Conserva el original y asigna nombres distintos a las pistas derivadas.
Revisar ambas pistas antes de usarlas
Comprueba las consonantes del habla, las notas sostenidas, el silencio entre frases y los canales izquierdo y derecho. Escucha si se filtra música en la voz o queda voz en el fondo. No des por hecho que al volver a sumar las pistas se reconstruye exactamente el original. Mide sus duraciones reales antes de editar secuencias largas y verifica la alineación en el editor de destino. El formato de salida, la frecuencia de muestreo y la calidad de separación todavía requieren validación con tu material.
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": "spicyapi/vocal-isolator-v1/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.