1. Antes de começar
- A sua conta precisa do desbloqueio BYOK — compra única, veja Preços. Inicie sessão no app ou na extensão com a conta que o comprou.
- Obtenha uma chave no fornecedor: Gemini no Google AI Studio, ou Qwen no Alibaba Cloud Model Studio (edição International).
- Há um único campo de chave. O Voxis reconhece o fornecedor pela própria chave:
AIza…é Gemini,sk-…é Qwen. Pode guardar as duas lado a lado — o Voxis escolhe o melhor motor por idioma de destino (o Qwen fala cerca de 29 destinos com voz natural; o Gemini cobre todos os 79).
2. Adicionar uma chave Gemini
Crie uma chave de API no Google AI Studio, copie o valor AIza…, cole no campo de chave e guarde. Para o Gemini não aparece linha de workspace — é normal; o Gemini não precisa de um.
3. Adicionar uma chave Qwen — cole o ficheiro inteiro
O Model Studio entrega a chave como um pequeno ficheiro de credenciais descarregável (CSV). A única regra que faz tudo funcionar:
Não cole o caminho do ficheiro, nem cole só a chave. Abra o ficheiro, selecione todo o conteúdo, copie e cole tudo no campo de chave.
O Voxis lê desse colar as duas metades de uma vez: a chave de API e o workspace. O workspace importa porque uma chave Qwen pertence a um workspace e — sobretudo no navegador — o workspace faz parte do próprio endereço de ligação. Sem ele, a chave não consegue ligar.
- Colou só a chave
sk-…nua? O Voxis pedirá o workspace pelo nome. - Colou o caminho do ficheiro (tipo
C:\Users\…\key.csv)? Verá o aviso "cole uma chave de API" — cole antes o conteúdo do ficheiro. - Crie a chave no Model Studio International. Uma chave da região errada falha como se fosse uma chave inválida.
4. Começar a traduzir
Na extensão: abra a guia onde o vídeo toca, clique no ícone do Voxis e confira a linha sob o botão Iniciar — ela nomeia a guia que será traduzida ("Iniciar traduz esta guia: …"). Se nomear a guia errada, mude para a guia do vídeo e abra o popup lá. Depois prima Iniciar. No app do Windows: escolha Vídeo/Jogo ou Reunião e inicie — as primeiras palavras traduzidas podem levar alguns segundos.
Se algo não funcionar
- Aviso "cole uma chave de API" — colou um caminho de ficheiro ou texto simples. Abra o ficheiro e cole o conteúdo.
- Um erro logo após Iniciar que nomeia o workspace — falta o workspace. Cole novamente o ficheiro de credenciais inteiro.
- Um erro rápido e específico sobre o par chave/workspace — os dois não pertencem um ao outro, ou a região está errada. Descarregue o ficheiro de novo e cole outra vez.
- Ligado, mas em silêncio — confirme que premiu Iniciar na guia que toca o vídeo e que ele está mesmo a tocar.
- Um idioma não arranca só com a chave Qwen — esse destino não tem voz Qwen. Adicione também uma chave Gemini; o Voxis encaminha automaticamente.