---
title: "API StemSplit: Integre Separação de Stems com IA nos Seus Apps"
date: "2025-01-05"
lastUpdated: "2026-03-12"
author: "StemSplit Team"
tags: ["api", "desenvolvedores", "separação de stems", "remoção de voz", "automação", "webhooks", "integração"]
excerpt: "A API StemSplit dá aos desenvolvedores acesso programático à remoção de voz e separação de stems com IA — endpoints REST, webhooks, suporte a URLs do YouTube e os mesmos créditos por uso do aplicativo web."
abstract: "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."
locale: "pt-BR"
canonical: "https://stemsplit.io/pt-BR/blog/stemsplit-api-launch"
source: "stemsplit.io"
---

> **Source:** https://stemsplit.io/pt-BR/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.

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

| Tipo de Saída | O Que Você Obtém |
|---|---|
| `VOCALS` | Vocais isolados |
| `INSTRUMENTAL` | Tudo exceto vocais (faixa de karaokê) |
| `BOTH` | Vocais + instrumental como arquivos separados |
| `FOUR_STEMS` | Vocais, bateria, baixo, outros |
| `SIX_STEMS` | Vocais, bateria, baixo, guitarra, piano, outros |

### Processar Vídeos do YouTube Diretamente

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

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

### Notificações por Webhook

Registre um endpoint de webhook e receba um POST quando os jobs forem concluídos, em vez de fazer 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": "..." }
    }
  }
}
```

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

---

**Pronto para começar?** [Obtenha sua chave de API](/developers) — novas contas recebem 5 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:

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

**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

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

| Plataforma | O Que Você Pode Construir |
|---|---|
| [n8n](/developers/guides/n8n) | Workflows automatizados — processe arquivos do armazenamento em nuvem, encaminhe resultados para Slack ou email |
| [Zapier](/developers/guides/zapier) | Automação sem código conectando o StemSplit a mais de 5.000 apps |
| [Make](/developers/guides/make) | Construtor visual de cenários para workflows de processamento em múltiplas etapas |
| [Bot para Discord](/developers/guides/discord-bot) | Bot de separação de stems para servidores de música |
| [White Label](/developers/guides/white-label) | Incorpore separação de stems no seu próprio produto com sua marca |

## Referência Técnica

### Autenticação

```
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx
```

Gere chaves em [Configurações → Chaves de API](/developers). Cada conta suporta até 5 chaves ativas.

### Limites de Taxa e Restrições

| Limite | Valor |
|---|---|
| Requisições por minuto | 60 |
| Tamanho máximo de arquivo | 50 MB |
| Duração máxima de áudio | 60 minutos |
| Chaves de API por conta | 5 |
| Webhooks por conta | 5 |

### Formatos Suportados

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

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

### Configurações de Qualidade

| Configuração | Velocidade | Caso de Uso |
|---|---|---|
| `FAST` | ~20s por minuto de áudio | Visualizações rápidas, testes |
| `BALANCED` | ~40s por minuto | Uso geral |
| `BEST` | ~60s por minuto | Qualidade de produção; necessário para 6 stems |

## 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 5 minutos gratuitos para testar. As tarifas atuais estão na [página de preços](/pricing).

## Documentação

- **[Introdução](/developers/docs)** — Início rápido com exemplos de código em cURL, Python e JavaScript
- **[Referência da API](/developers/reference)** — Documentação completa de endpoints com esquemas de requisição e resposta
- **[Guias de Integração](/developers/guides)** — 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](/developers/reference).

**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](/free-trial)
2. [Gerar uma chave de API](/developers)
3. [Ler a documentação](/developers/docs)

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

[Obter Sua Chave de API →](/developers)

---

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