Obter uma chave de API Soniox
A Soniox é o serviço que transforma a tua voz em texto — faz a audição, em cada um dos 60 idiomas. É o fornecedor que recomendamos, e esta é toda a configuração: uma conta, um pouco de crédito, uma chave, colada uma só vez no Vito.
Conta com cerca de cinco minutos. Precisas de um e-mail e de um método de pagamento; a Soniox é pré-paga, por isso a conta precisa de saldo antes de transcrever seja o que for.
Criar a chave
- Regista-te em console.soniox.com. Se as contas novas recebem crédito de teste não consta na página de preços da Soniox, por isso conta com adicionares tu um valor pequeno. Se preferes primeiro experimentar sem pagar absolutamente nada, a AssemblyAI dá às contas novas crédito grátis e podes sempre mudar mais tarde.
- Abre a secção de faturação e adiciona crédito. Adiciona um método de pagamento e carrega um valor pequeno — uns euros cobrem muitas horas de voz. Procura já o limite de gastos e define um; as razões estão mais abaixo e é muito mais fácil agora do que lembrares-te mais tarde.
-
Vai à secção de chaves de API e cria uma. Dá-lhe um nome que
reconheças mais tarde, como
vito, para veres num relance para que serve. - Copia a chave já. Os fornecedores mostram uma chave uma vez, por inteiro, no momento em que a crias. Depois vês que existe, mas não o que contém. Se a perderes, apaga-la e crias uma nova — não é um drama, mas é mais fácil de evitar.
- Cola-a no Vito. Definições → Reconhecimento de voz, escolhe Soniox, cola. O Vito diz-te se a chave funciona antes de confiares nela.
Preferes ler na fonte?
A Soniox documenta a consola e os preços em soniox.com/docs. Se algum ecrã aqui não corresponder ao que vês, o deles é que manda — as consolas são redesenhadas, e esta página vai atrás.
Quanto custa
A Soniox fatura pela quantidade de áudio que envias, não por mês. Com o passo de limpeza, ditar através do Vito dá cerca de 0,15 € por hora de voz — uma hora de fala em cada dia útil ronda os três euros por mês.
À data em que escrevemos, a Soniox indica 0,10 $ por hora para áudio gravado e 0,12 $ por hora para tempo real, em mais de 60 idiomas. Isso torna-a o mais barato dos dois motores de voz que o Vito suporta, e é a principal razão de ser o recomendado.
Verificado na página de preços da Soniox em julho de 2026. Os preços mexem-se; o deles é o número que conta, não o nosso.
Cuidar da tua chave
Esta parte é igual seja qual for o fornecedor que escolheste, e vale dois minutos. Nada disto é burocracia: uma chave que sai é outra pessoa a gastar o teu dinheiro.
Trata-a como uma palavra-passe, porque é isso que é
Qualquer pessoa que tenha a tua chave pode fazer pedidos que tu pagas. Não a coles num chat, numa mensagem de fórum, num relatório de erros nem numa captura de ecrã, e nunca a envies para um repositório — há bots que percorrem código público à procura de chaves e encontram-nas em minutos.
Define um limite de gastos antes de a usares
Todos os fornecedores te deixam limitar o que a conta pode gastar por mês, ou avisar-te num limiar. É a proteção mais eficaz que tens e configurá-la leva um minuto. Com um limite, um erro custa-te o limite em vez de todo o saldo.
Mantém algum crédito na conta
São serviços pré-pagos. Se o saldo chegar a zero, a transcrição simplesmente deixa de funcionar — normalmente com uma mensagem de erro pouco útil. Carregar um valor pequeno e definir um alerta de saldo baixo poupa-te o diagnóstico de um problema que não é um.
A maioria dos fornecedores também oferece recarga automática: quando o saldo desce abaixo de um valor que escolhes, cobram no teu cartão outro valor fixo. Vale a pena ativá-la. É a diferença entre um ditado que funciona sempre e um que para numa terça-feira de manhã porque te esqueceste de iniciar sessão algures há três semanas.
A recarga automática acompanha o limite de gastos, não o substitui
As duas andam juntas. Uma recarga que se enche sozinha, sem um teto por cima, é um balde com a torneira aberta: o que quer que corra mal continua a ser pago. Define primeiro o limite mensal e deixa a recarga manter-te por baixo dele.
Cria uma chave que só o Vito usa
Se já usas o mesmo fornecedor para outra coisa, cria uma chave separada em vez de reutilizar uma. Não custa nada, mostra-te a partir da página de utilização do fornecedor o que o Vito gasta realmente, e se alguma vez precisares de a revogar não partes mais nada no processo.
Se vazar, revoga-a
Apagar uma chave no fornecedor torna-a inutilizável de imediato — sem período de graça com que te preocupares e sem forma de alguém continuar a usá-la. Cria uma nova, cola-a no Vito e segue em frente. Rodar uma chave é coisa de dois minutos, por isso fá-lo à primeira suspeita em vez de esperar por certezas.
A fatura é tua
Tu és o titular da conta. O fornecedor fatura-te diretamente, aos preços dele, por tudo aquilo para que a chave for usada. O Vito não é um intermediário: não mantém qualquer conta em teu nome, nunca vê a tua utilização, e não pode limitar, reembolsar nem contestar nada. O que também significa que a poupança é tua — ninguém leva uma parte — mas a responsabilidade também.
Onde o Vito a guarda
Na tua própria máquina, nas definições do Vito, e só é enviada ao fornecedor a que pertence. Ninguém no Vito a pode ler. É esse o objetivo, e tem uma consequência que vale a pena conhecer: ninguém a pode recuperar por ti também. Perde-la e crias uma nova.
Se alguma coisa não funcionar
O Vito diz que a chave é inválida
Nove em cada dez vezes é um problema de cópia — um caráter em falta no início, ou um espaço no fim que entrou na seleção. Apaga o que colaste, copia de novo, e certifica-te de que não há mais nada selecionado. Se ainda assim falhar, cria uma chave nova; é mais rápido do que investigar a antiga.
Funcionava ontem e parou hoje
Verifica primeiro o saldo. Uma conta pré-paga que ficou a seco costuma dar um erro de autenticação ou de quota em vez de simplesmente dizer que está vazia.
A transcrição está no idioma errado
Isso é uma definição do Vito, não da Soniox — escolhe o teu idioma de ditado nas definições do Vito.
A seguir
A Soniox trata da audição. A limpeza — tirar os "hã", reestruturar frases, adicionar quebras de linha — é um passo separado, e precisa da sua própria chave.