Como criamos um soundboard usando a SFX API da ElevenLabs
- Publicado
- Última atualização
OuvirOuça este artigo
Imagine um soundboard capaz de gerar sons ilimitados sob demanda. Foi exatamente isso que criamos na ElevenLabs — conheça o SB1, nosso soundboard infinito. À primeira vista, ele parece uma grade comum de pads que você aciona com cliques ou atalhos do teclado. Por trás, ele é alimentado pelo nosso modelo de IA que transforma texto em efeitos sonoros.
Para usar, basta descrever qualquer som que você imaginar e o SB1 gera na hora. Também existem alguns sons padrão, mas até eles podem ser trocados.
Da ideia ao protótipo
Começamos com uma pergunta simples: e se você pudesse digitar uma descrição, como “sons suaves de floresta ao fundo” ou “suspiro dramático da plateia”, e receber um efeito sonoro pronto para usar?
Soundboards tradicionais dependem de bibliotecas de MP3 estáticas que você precisa procurar na internet. Mesmo quando encontra um som, muitas vezes não é exatamente o que queria. Com IA generativa, isso não é mais um problema. Você não tem mais limites.

Antes de partir para o código, buscamos a Cativante para criar um protótipo básico do que seria o SB1. Ainda sem conexão com a API, isso nos permitiu testar opções de design e posicionamento dos botões antes da nossa equipe criar a interface e o código final.
Queríamos conteúdo dinâmico — qualquer som, gerado na hora. O núcleo da nossa solução é a SFX API da ElevenLabs. A API fica atrás de um único endpoint:
Você envia um payload JSON com o seu prompt, o número de variações desejadas (por padrão, quatro) e sua chave de API no header de autorização.
A resposta retorna um array de URLs apontando para arquivos WAV gerados. A partir daí, você pode ouvir, baixar e atribuir cada clipe a um pad. Também é possível ativar o loop. Use prompts descritivos para mais detalhes.
Key API details
- Endpoint:
/v1/sound-effects/generate - Method: POST
- Headers:
Authorization: Bearer YOUR_API_KEYContent-Type: application/json
- Body parameters:
prompt(string): description of the soundn(integer): number of variations (1–10)format(string, optional): wav or mp3 (defaults to wav)
Um exemplo de requisição fica assim:
E você recebe um array com quatro URLs. Pensamos a API para escalar em qualquer cenário — desde criar soundboards sob demanda até gerar em massa para assets de jogos.
Construindo a interface do SB1
Com a API pronta, fomos para o front-end. O SB1 é um web app feito com React e Tailwind CSS. Cada pad tem dois modos:
- Pré-definido: carrega de um conjunto salvo de URLs de sons
- Personalizado: gerado pelo usuário via SFX API
Ao clicar em um pad vazio no modo custom, aparece uma caixa de prompt. Você digita a descrição, clica em Gerar, e a API retorna quatro opções. Você escuta ali mesmo, escolhe a favorita e o pad atualiza na hora. Também dá para acionar pads pelo teclado, tocando ritmos ou efeitos ao vivo.
Também adicionamos controles de loop. Basta pressionar o botão de loop, tocar o som desejado e ele continua tocando até você parar. Isso faz do SB1 uma ferramenta útil não só para brincadeiras — pense em drum machines e ambientes relaxantes — mas também para podcasts, efeitos em lives e meditações guiadas.
Exemplos na prática
Paisagem sonora ambiente
- Chuva leve: "chuva leve pingando nas folhas"
- Chuva forte: "chuva forte caindo em telhado de zinco"
- Ondas do mar: ondas suaves chegando na praia
Geramos cada um enviando prompts como “chuva leve pingando nas folhas” e “ondas suaves chegando na praia”. Depois, colocamos esses pads em loop, criando um fundo para foco ou meditação.
Bateria eletrônica
- 808 kick: "808 kick bem grave"
- Bateria: "snare seco e preciso"
- Prato aberto: "prato aberto soando"
Você não precisa de amostras de áudio de uma biblioteca de bateria. Basta descrever “808 kick bem grave” ou “snare seco e preciso” e a API te dá quatro versões para testar. Mapeamos para as teclas A, S e D para uma demo ao vivo.
Se quiser ir além, também dá para criar trechos curtos de voz no estilo de um personagem. É só indicar o personagem e colocar as palavras entre colchetes.
- DJ animado: DJ animado dizendo "Vamos começar a festa"
- Orc em missão: Orc com voz rouca dizendo: "Esta sala está acima da capacidade"
- Canto de sereia: Vocal feminino marcante cantando: "Hora de ir para casa, a festa acabou"
Presets personalizados
Você pode salvar e nomear seus próprios presets — por exemplo, “FX para live” com suspiro, risada e aplausos. Depois de montar seu board, clique em Compartilhar para copiar o link ou postar direto nas redes sociais. Quem tiver o link carrega sua configuração do SB1 e pode tocar os sons que você escolheu.
Dicas para desenvolvedores
- Geração sem estado: Cada chamada de API é independente. Não precisa gerenciar pipeline de treinamento nem armazenar grandes bibliotecas — só guardar os URLs usados na interface.
- Baixa latência: O tempo médio de geração é de menos de dois segundos, o que parece instantâneo ao demonstrar o recurso.
- Escalável: Dá para gerar centenas de sons em paralelo e armazenar no seu próprio CDN para uso intenso.
- Formatos flexíveis: WAV para máxima qualidade, MP3 se precisar de arquivos menores.
Para começar, acesse nossa documentação. Lá você encontra exemplos de código em JavaScript, Python e cURL mostrando como integrar a SFX API aos seus projetos.
E agora?
O SB1 é só uma demonstração do que nosso modelo de efeitos sonoros pode fazer. Estamos desenvolvendo plugins para OBS e estações de trabalho de áudio digital, assim você pode criar novos sons sem sair do seu software de streaming ou produção. Também estamos ajustando o modelo para melhorar o desempenho em
Se você criar algo legal, queremos ver! Marque a gente nas redes sociais ou compartilhe o link do seu preset. Seja streamer, podcaster, desenvolvedor de jogos ou só alguém que gosta de brincar com som, o SB1 e a SFX API colocam criatividade sonora ilimitada nas suas mãos.
Experimente grátis hoje mesmo — não precisa de biblioteca de MP3.




