Pular para o conteúdo

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.

SB1 Prototype

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:

POST https://api.elevenlabs.io/v1/sound-generation

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

  • Headers:
    • Authorization: Bearer YOUR_API_KEY
    • Content-Type: application/json
  • Body parameters:
    • prompt (string): description of the sound
    • n (integer): number of variations (1–10)
    • format (string, optional): wav or mp3 (defaults to wav)

Um exemplo de requisição fica assim:

{
  "prompt": "rain hitting the roof of a tent",
  "n": 4,
  "format": "wav"
}

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:

  1. Pré-definido: carrega de um conjunto salvo de URLs de sons
  2. 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.

Artigos relacionados

Crie com o áudio de IA da mais alta qualidade