Obter uma chave de API AssemblyAI

A AssemblyAI é o motor de voz alternativo — faz o mesmo trabalho que a Soniox: transformar o que dizes em palavras. Escolhe-a se já tens lá uma conta, ou se simplesmente preferes não depender da Soniox. O Vito funciona da mesma forma nos dois casos.

Cerca de cinco minutos, e um e-mail. A AssemblyAI dá-te uma chave assim que tens conta, o que a torna a mais rápida das três a configurar.

Encontrar a tua chave

  1. Regista-te em assemblyai.com. A AssemblyAI anuncia 50 $ de crédito grátis ao registares-te, sem cartão de crédito — o que é muito ditado, e a razão de ser a mais fácil das três a experimentar. Podes pôr o Vito a transcrever antes de teres dado a alguém um dado de pagamento.
  2. Abre o painel. Ao contrário da maioria dos fornecedores, a AssemblyAI mostra a tua chave de API no próprio painel, em vez de a esconder atrás de um passo de criação. Copia-a daí.
  3. Adiciona um método de pagamento quando o crédito grátis acabar. Até lá, a transcrição para assim que o crédito se esgota. Define já um limite de gastos ou um alerta de utilização nas definições de faturação — vê mais abaixo.
  4. Cola a chave no Vito. Definições → Reconhecimento de voz, escolhe AssemblyAI, cola. O Vito verifica-a antes de confiares nela.

Preferes ler na fonte?

A documentação da AssemblyAI está em assemblyai.com/docs. Se o painel não se parecer com esta descrição, o deles é que manda — esta página está sempre atrás de uma remodelação.

Quanto custa

Nada, até o crédito grátis acabar. Depois a AssemblyAI fatura por hora de áudio, e a tarifa depende do modelo que usas — à data em que escrevemos, os preços indicados vão de 0,15 $ por hora no Universal-2 a 0,45 $ por hora para tempo real no modelo Pro mais recente. A Soniox, para comparar, indica 0,10 a 0,12 $.

A decisão é, portanto, real e vale a pena conhecê-la antes de escolher: a AssemblyAI é o arranque mais fácil, a Soniox é mais barata de usar. A regra prática do Vito de 0,15 € por hora de voz assenta na configuração com a Soniox; com a AssemblyAI podes esperar um pouco mais, consoante o modelo.

A cobertura de idiomas também varia por modelo — o modelo Pro mais recente indica 18 idiomas enquanto o Universal-2 indica 99, contra os mais de 60 da Soniox. Qual deles é "mais" depende inteiramente do modelo que acabas por usar e de o teu idioma estar na lista mais curta, por isso verifica antes de presumires seja o que for.

Verificado na página de preços da AssemblyAI e na sua documentação sobre idiomas suportados em julho de 2026. Os deles são os números que contam.

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

Como a chave está num painel em vez de numa janela de copiar-uma-vez, o culpado habitual é uma seleção incompleta — um caráter que ficou de fora numa das pontas. Seleciona-a de novo, com cuidado, e cola-a fresca.

Parou passado algum tempo

Provavelmente o crédito grátis esgotou-se. Adiciona um método de pagamento, ou carrega, e retoma.

Devo usar este ou a Soniox?

A Soniox é o que o Vito recomenda, e sobre o que assenta o valor de 0,15 € por hora. A AssemblyAI existe para que não dependas de um único fornecedor. Nenhuma das duas escolhas é definitiva: mudar é colar outra chave.

A seguir

Isso cobre a audição. A limpeza — a parte que transforma uma transcrição bruta em texto que enviarias mesmo — é um serviço separado com a sua própria chave.

Anthropic (Claude) → O passo de limpeza: transforma a transcrição bruta em texto acabado Soniox → O motor de voz recomendado, se quiseres comparar