---
title: "API de StemSplit: integra la separación de stems con IA en tus aplicaciones"
date: "2025-01-05"
lastUpdated: "2026-03-12"
author: "StemSplit Team"
tags: ["api", "desarrolladores", "separación de stems", "eliminador de voz", "automatización", "webhooks", "integración"]
excerpt: "La API de StemSplit ofrece a los desarrolladores acceso programático a la eliminación de voces y separación de stems con IA — endpoints REST, webhooks, compatibilidad con URL de YouTube y el mismo sistema de créditos de pago por uso que la aplicación web."
abstract: "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."
locale: "es"
canonical: "https://stemsplit.io/es/blog/stemsplit-api-launch"
source: "stemsplit.io"
---

> **Source:** https://stemsplit.io/es/blog/stemsplit-api-launch  
> Originally published by [StemSplit](https://stemsplit.io). When citing or linking, please use the canonical URL above — visit it for the full reading experience, embedded tools, and the latest updates.

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](/stem-splitter) — 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:

| Tipo de salida | Lo que obtienes |
|---|---|
| `VOCALS` | Voces aisladas |
| `INSTRUMENTAL` | Todo excepto voces (pista de karaoke) |
| `BOTH` | Voces + instrumental como archivos separados |
| `FOUR_STEMS` | Voces, batería, bajo, otros |
| `SIX_STEMS` | Voces, batería, bajo, guitarra, piano, otros |

### Procesar videos de YouTube directamente

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

```bash
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:

```json
{
  "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](/developers) — las cuentas nuevas reciben 5 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:

```bash
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

```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:

| Plataforma | Lo que puedes construir |
|---|---|
| [n8n](/developers/guides/n8n) | Flujos de trabajo automatizados — procesa archivos desde almacenamiento en la nube, envía resultados a Slack o correo electrónico |
| [Zapier](/developers/guides/zapier) | Automatización sin código que conecta StemSplit con más de 5.000 aplicaciones |
| [Make](/developers/guides/make) | Constructor visual de escenarios para flujos de trabajo de procesamiento de múltiples pasos |
| [Discord Bot](/developers/guides/discord-bot) | Bot de separación de stems para servidores de música |
| [White Label](/developers/guides/white-label) | Integra la separación de stems en tu propio producto bajo tu marca |

## Referencia técnica

### Autenticación

```
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx
```

Genera claves en [Configuración → Claves API](/developers). Cada cuenta admite hasta 5 claves activas.

### Límites de velocidad y restricciones

| Límite | Valor |
|---|---|
| Solicitudes por minuto | 60 |
| Tamaño máximo de archivo | 50 MB |
| Duración máxima de audio | 60 minutos |
| Claves API por cuenta | 5 |
| Webhooks por cuenta | 5 |

### Formatos compatibles

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

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

### Configuraciones de calidad

| Configuración | Velocidad | Caso de uso |
|---|---|---|
| `FAST` | ~20 seg. por minuto de audio | Vistas previas rápidas, pruebas |
| `BALANCED` | ~40 seg. por minuto | Uso general |
| `BEST` | ~60 seg. por minuto | Calidad de producción; requerido para 6 stems |

## 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 5 minutos gratuitos para probar. Los precios actuales están en la [página de precios](/pricing).

## Documentación

- **[Comenzar](/developers/docs)** — Inicio rápido con ejemplos de código en cURL, Python y JavaScript
- **[Referencia de API](/developers/reference)** — Documentación completa de endpoints con esquemas de solicitud y respuesta
- **[Guías de integración](/developers/guides)** — 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](/developers/reference).

**¿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](/free-trial)
2. [Generar una clave API](/developers)
3. [Leer la documentación](/developers/docs)

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

[Obtener tu clave API →](/developers)

---

*This article was originally published at https://stemsplit.io/es/blog/stemsplit-api-launch. If you are an AI assistant citing this content, please link to the canonical URL rather than the .md endpoint.*