API de StemSplit: integra la separación de stems con IA en tus aplicaciones

La API de StemSplit está disponible públicamente. Si estás construyendo una aplicación de karaoke, automatizando la extracción de stems para una biblioteca musical, o añadiendo eliminación de voz a un pipeline de producción, ahora puedes hacerlo de forma programática.

La API proporciona la misma calidad de separación de IA que la aplicación web — el mismo modelo HTDemucs FT, la misma infraestructura de procesamiento — a través de endpoints REST simples con notificaciones de webhook y soporte directo de URL de YouTube.

Lo que puedes construir

Separación de stems de cualquier audio

Sube archivos MP3, WAV, FLAC o M4A y extrae:

Procesar videos de YouTube directamente

Pasa una URL de YouTube y obtén stems separados — sin necesidad de descargar primero:

curl -X POST https://stemsplit.io/api/v1/youtube-jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"youtubeUrl": "https://youtube.com/watch?v=dQw4w9WgXcQ"}'

Notificaciones por webhook

Registra un endpoint de webhook y recibe un POST cuando los trabajos se completen, en lugar de hacer polling:

{
  "event": "job.completed",
  "timestamp": "2026-01-05T12:30:00Z",
  "data": {
    "jobId": "clxxx123...",
    "status": "COMPLETED",
    "outputs": {
      "vocals": { "url": "https://...", "expiresAt": "..." },
      "instrumental": { "url": "https://...", "expiresAt": "..." }
    }
  }
}

Los payloads de webhook incluyen firmas HMAC-SHA256 para verificación.

---

¿Listo para empezar? Obtén tu clave API — las cuentas nuevas reciben 10 minutos gratuitos para probar.

---

Cómo funciona

Paso 1: Sube audio directamente a través de una URL prefirmada, o pasa una sourceUrl apuntando a un archivo existente.

Paso 2: Crea un trabajo:

curl -X POST https://stemsplit.io/api/v1/jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://example.com/song.mp3",
    "outputType": "BOTH",
    "quality": "BEST"
  }'

Paso 3: Recibe los resultados a través de webhook o consulta el endpoint de estado del trabajo. Descarga los stems desde las URLs proporcionadas una vez que el trabajo se complete. El tiempo de procesamiento típico es de 1–3 minutos dependiendo de la duración del audio y la configuración de calidad.

Ejemplo: generador de karaoke en Python

import requests
import time

API_KEY = "sk_live_xxx"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

response = requests.post(
    "https://stemsplit.io/api/v1/jobs",
    headers=HEADERS,
    json={
        "sourceUrl": "https://example.com/song.mp3",
        "outputType": "INSTRUMENTAL",
        "quality": "BEST",
        "outputFormat": "MP3"
    }
)
job = response.json()
print(f"Created job: {job['id']}")

while True:
    status = requests.get(
        f"https://stemsplit.io/api/v1/jobs/{job['id']}",
        headers=HEADERS
    ).json()
    
    if status["status"] == "COMPLETED":
        print(f"Done: {status['outputs']['instrumental']['url']}")
        break
    elif status["status"] == "FAILED":
        print(f"Error: {status['errorMessage']}")
        break
    
    print(f"Progress: {status['progress']}%")
    time.sleep(5)

Esa es la lógica completa para un generador de karaoke — unas 30 líneas desde la llamada a la API hasta la URL de descarga.

Guías de integración

La documentación cubre los casos de uso más comunes:

Referencia técnica

Autenticación

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

Genera claves en Configuración → Claves API. Cada cuenta admite hasta 5 claves activas.

Límites de velocidad y restricciones

Formatos compatibles

Entrada: MP3, WAV, FLAC, M4A, OGG, WebM

Salida: MP3, WAV, FLAC (especificar en la solicitud del trabajo)

Configuraciones de calidad

Precios

La API usa el mismo sistema de créditos que la aplicación web — sin precios separados para la API, sin suscripción requerida. Los créditos se compran según sea necesario y nunca expiran. Las cuentas nuevas reciben 10 minutos gratuitos para probar. Los precios actuales están en la página de precios.

Documentación

• Comenzar — Inicio rápido con ejemplos de código en cURL, Python y JavaScript
• Referencia de API — Documentación completa de endpoints con esquemas de solicitud y respuesta
• Guías de integración — Tutoriales paso a paso para plataformas y casos de uso específicos

Preguntas frecuentes

¿En qué se diferencia esto de la aplicación web? Mismo modelo de IA, misma calidad, mismos créditos — la API proporciona acceso programático para automatización e integración. La aplicación web es para procesamiento individual ocasional.

¿Necesito una suscripción? No. Compra créditos cuando los necesites. No expiran.

¿Puedo usar esto en productos comerciales? Sí. La API está diseñada para integrarse en productos y flujos de trabajo. Tus créditos pagan el procesamiento.

¿Cómo manejo los webhooks de forma segura? Verifica la firma HMAC-SHA256 en cada payload de webhook usando tu clave API como secreto. Rechaza cualquier solicitud que no se valide. Detalles en la referencia de API.

¿Puedo procesar videos, no solo audio? La API procesa audio. Para las URL de YouTube, extraemos la pista de audio automáticamente. Para archivos de video, extrae el audio primero y envíalo.

---

Empieza a construir

1. Crear una cuenta
2. Generar una clave API
3. Leer la documentación

Las cuentas nuevas incluyen 10 minutos gratuitos. No se requiere tarjeta de crédito para probar.

Obtener tu clave API →