Tutorial de configuração do Soniox

1Registre uma conta Soniox

Acesse console.soniox.com/signup e crie uma conta gratuita. Se você já tem uma conta Soniox, faça login diretamente em console.soniox.com.

2Abra o console

Após o login, abra o console do Soniox. Sua conta começa com um projeto padrão ("My First Project").

3Vá para API Keys

No console, abra seu projeto e clique na seção API Keys na barra lateral.

4Crie uma chave API

Clique em Criar nova chave, dê um nome a ela (por exemplo, "Sokuji") e confirme. Copie a chave imediatamente — ela é exibida apenas uma vez.

5Configure no Sokuji

Abra o Sokuji e selecione Soniox como seu provedor de IA no painel de configurações. Cole sua chave API, escolha o idioma de origem (ou detecção automática) e o idioma de destino, e selecione uma voz. No bloco Voz (configurações rápidas, ou Configurações → Avançado → Áudio), Tradução que o outro lado ouve decide se a sua tradução é lida em voz alta ou mostrada só como texto.

6Teste a conexão

Clique no botão Iniciar sessão e fale no microfone para verificar se a tradução em tempo real está funcionando. Você deverá ver a transcrição e a tradução. A tradução falada vai para o microfone virtual, para o outro lado; para ouvi-la também, ative Eu também ouço no bloco Voz.

O que é o Soniox?

O Soniox é um serviço de tradução de voz em tempo real de ponta a ponta:

• Tradução de voz para voz em tempo real: transcrição, tradução e síntese de voz em um único pipeline
• Transcreve e traduz mais de 60 idiomas na mesma chamada de API de streaming, sem custo adicional pela tradução
• Detecção automática de idioma: defina a origem como detecção automática e o Soniox identifica o idioma falado
• 200 vozes integradas para a tradução falada, e vozes que você clona a partir de uma gravação curta

Idiomas suportados

Suporta mais de 60 idiomas com tradução de qualquer idioma para qualquer outro:

• O idioma de origem pode ser um idioma específico ou detecção automática
• O idioma de destino pode ser qualquer um dos mais de 60 idiomas
• Inclui chinês, inglês, japonês, coreano, espanhol, francês, alemão, italiano, português, russo e muitos mais

Modos e opções

• Falada ou só texto: no bloco Voz, Tradução que o outro lado ouve lê a sua tradução em voz alta no microfone virtual, e Tradução que eu ouço lê para você a tradução do outro lado. Desative qualquer uma delas e esse lado fica só em texto
• Vozes: em Configurações → Avançado → Provedor → Configurações de Voz, escolha uma das 200 vozes integradas ou clone a sua. Enquanto Tradução que eu ouço estiver ativada, uma segunda linha, Voz que eu ouço, escolhe a voz que lê o outro lado para você: só vozes integradas, e se você escolher ali a sua própria voz, outra lê no lugar dela
• Tradução bidirecional: no modo "Ambos", cada direção usa por padrão a sua própria sessão do Soniox (Sessão compartilhada no modo Ambos: Desabilitado). Escolha Ativado para traduzir os dois lados em uma só sessão com separação automática de falantes, com menor custo e latência; duas sessões custam cerca do dobro, mas funcionam melhor quando as duas pessoas falam ao mesmo tempo
• Cara a cara: no modo "Ambos", defina Onde está o outro como Ao meu lado e duas pessoas compartilham um microfone; cada uma ouve em um fone o que a outra diz, traduzido. O cara a cara sempre usa uma sessão compartilhada
• Idioma de origem e modo de tradução: a detecção automática funciona ao traduzir a sua própria voz (modo "Eu"). Nos modos "Outro" ou "Ambos", escolha um idioma de origem específico — a detecção automática não pode ser invertida para traduzir o outro lado para o seu idioma.
• Sem configuração manual de detecção de turnos — o Soniox detecta os pontos finais da fala no servidor

Problemas comuns

Erro de autenticação: Verifique se a chave API foi copiada corretamente sem espaços extras. Se a chave foi perdida, crie uma nova no console do Soniox — as chaves são exibidas apenas uma vez.

Erro de conexão: Verifique sua conexão de rede e certifique-se de que os firewalls não estão bloqueando conexões WebSocket. Se estiver usando um proxy, certifique-se de que ele suporta WebSocket.

Sem áudio traduzido: Se você vê a tradução mas não ouve nada, verifique o bloco Voz: Tradução que o outro lado ouve precisa estar ativada. A sua tradução vai para o microfone virtual, para o outro lado; para ouvi-la também, ative Eu também ouço e confira o dispositivo dessa linha.

Dicas para melhores resultados

1. Use uma conexão de rede estável para obter a melhor qualidade em tempo real
2. Use em um ambiente silencioso para reconhecimento de voz ideal
3. Defina o idioma de origem explicitamente se a detecção automática escolher o idioma errado
4. Monitore seu uso e saldo no console do Soniox