API StemSplit: Integre Separação de Stems com IA nos Seus Apps

A API StemSplit está disponível publicamente. Se você está construindo um app de karaokê, automatizando a extração de stems de uma biblioteca de músicas, ou adicionando remoção de voz a um pipeline de produção, você pode fazer isso programaticamente agora.

A API oferece a mesma qualidade de separação com IA do aplicativo web — mesmo modelo HTDemucs FT, mesma infraestrutura de processamento — por meio de endpoints REST simples com notificações de webhook e suporte direto a URLs do YouTube.

O Que Você Pode Construir

Separação de Stems de Qualquer Áudio

Faça upload de arquivos MP3, WAV, FLAC ou M4A e extraia:

Processar Vídeos do YouTube Diretamente

Passe uma URL do YouTube e receba os stems separados — sem precisar baixar primeiro:

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"}'

Notificações por Webhook

Registre um endpoint de webhook e receba um POST quando os jobs forem concluídos, em vez de fazer polling:

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

Os payloads de webhook incluem assinaturas HMAC-SHA256 para verificação.

---

Pronto para começar? Obtenha sua chave de API — novas contas recebem 10 minutos gratuitos para testar.

---

Como Funciona

Passo 1: Faça upload do áudio diretamente via URL pré-assinada, ou passe uma sourceUrl apontando para um arquivo existente.

Passo 2: Crie um job:

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"
  }'

Passo 3: Receba os resultados via webhook ou faça polling do endpoint de status do job. Baixe os stems das URLs fornecidas assim que o job for concluído. O tempo típico de processamento é de 1 a 3 minutos, dependendo da duração do áudio e da configuração de qualidade.

Exemplo: Gerador de Karaokê em 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)

É a lógica completa de um gerador de karaokê — cerca de 30 linhas da chamada à API até a URL de download.

Guias de Integração

A documentação cobre os casos de uso mais comuns:

Referência Técnica

Autenticação

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

Gere chaves em Configurações → Chaves de API. Cada conta suporta até 5 chaves ativas.

Limites de Taxa e Restrições

Formatos Suportados

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

Saída: MP3, WAV, FLAC (especifique na requisição do job)

Configurações de Qualidade

Preços

A API usa o mesmo sistema de créditos do aplicativo web — sem preços separados para API, sem assinatura necessária. Créditos são comprados conforme necessário e nunca expiram. Novas contas recebem 10 minutos gratuitos para testar. As tarifas atuais estão na página de preços.

Documentação

• Introdução — Início rápido com exemplos de código em cURL, Python e JavaScript
• Referência da API — Documentação completa de endpoints com esquemas de requisição e resposta
• Guias de Integração — Tutoriais passo a passo para plataformas e casos de uso específicos

Perguntas Frequentes

Em que isso difere do aplicativo web? Mesmo modelo de IA, mesma qualidade, mesmos créditos — a API fornece acesso programático para automação e integração. O aplicativo web é para processamento individual e pontual.

Preciso de uma assinatura? Não. Compre créditos quando precisar. Eles não expiram.

Posso usar isso em produtos comerciais? Sim. A API foi criada para integração em produtos e workflows. Seus créditos pagam pelo processamento.

Como lidar com webhooks de forma segura? Verifique a assinatura HMAC-SHA256 em cada payload de webhook usando sua chave de API como segredo. Rejeite qualquer requisição que não valide. Detalhes na referência da API.

Posso processar vídeos, não apenas áudio? A API processa áudio. Para URLs do YouTube, extraímos a faixa de áudio automaticamente. Para arquivos de vídeo, extraia o áudio primeiro e envie esse arquivo.

---

Comece a Construir

1. Criar uma conta
2. Gerar uma chave de API
3. Ler a documentação

Novas contas incluem 10 minutos gratuitos. Não é necessário cartão de crédito para testar.

Obter Sua Chave de API →