--- title: "Configurar BYOK — com a sua própria chave de API | VoxisLive" description: "Ative o desbloqueio BYOK do VoxisLive: adicione a sua chave do Google Gemini ou cole as credenciais do Alibaba Qwen e comece a traduzir." url: https://voxislive.com/pt/byok-setup language: "pt" source_html: https://voxislive.com/pt/byok-setup site: "Voxis — real-time voice translation" og_image: https://voxislive.com/assets/og.png generated_by: voxislive-markdown-pipeline --- [Início](https://voxislive.com/pt/) · / · Configuração BYOK BYOK # Configure a sua própria chave de API O desbloqueio BYOK faz o Voxis funcionar com a sua própria chave de API do Google Gemini ou do Alibaba Qwen — uma única compra cobre o app do Windows e a extensão do Chrome. Esta página mostra como configurar a chave corretamente logo na primeira vez. O desbloqueio é uma compra única de **US$ 99,99** que cobre os dois aplicativos e **não é reembolsável após a ativação**. A partir da ativação, a tradução roda com a sua própria chave e os minutos Voxis já pagos que restarem na conta não podem mais ser usados. Veja [preços](https://voxislive.com/pt/pricing#byok) e a [política de reembolso](https://voxislive.com/pt/refund). ## 1. Antes de começar - A sua conta precisa do **desbloqueio BYOK** — compra única, veja [Preços](https://voxislive.com/pricing#byok). 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 prima Iniciar — 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. FAQ ## Perguntas frequentes ### A minha chave de API é enviada ao Voxis? Não. A chave fica só no seu dispositivo — cifrada com DPAPI do Windows no app, no armazenamento local da extensão no navegador. As sessões de tradução ligam diretamente do seu dispositivo à Google ou à Alibaba; o Voxis apenas verifica que a sua conta possui a licença BYOK. ### As sessões BYOK gastam os meus minutos Voxis? Não. Em BYOK o seu saldo de minutos Voxis fica intacto — o uso é faturado pelo seu fornecedor, na sua própria chave. ### Uma única compra cobre o app e a extensão? Sim. A licença vive na sua conta, por isso o app do Windows e a extensão do Chrome são desbloqueados pela mesma compra. ### Posso manter guardadas uma chave Gemini e uma Qwen ao mesmo tempo? Sim. Os dois lugares coexistem e o Voxis escolhe o motor por idioma de destino. Guardar com o campo vazio não muda nada; Limpar remove as chaves guardadas. ## Continue a ler [Extensão do navegador · Ouça qualquer guia traduzida e falada no seu idioma, ao vivo.](https://voxislive.com/extension) · [Preços · Planos, pacotes de minutos e o desbloqueio BYOK de compra única.](https://voxislive.com/pricing#byok) · [Licenciamento · Termos comerciais e o que o repositório público permite — e o que não permite.](https://voxislive.com/licensing) ## Structured data (JSON-LD) ```json { "@context": "https://schema.org", "@graph": [ { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Início", "item": "https://voxislive.com/pt/" }, { "@type": "ListItem", "position": 2, "name": "Configuração BYOK", "item": "https://voxislive.com/pt/byok-setup" } ] }, { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "A minha chave de API é enviada ao Voxis?", "acceptedAnswer": { "@type": "Answer", "text": "Não. A chave fica só no seu dispositivo — cifrada com DPAPI do Windows no app, no armazenamento local da extensão no navegador. As sessões de tradução ligam diretamente do seu dispositivo à Google ou à Alibaba; o Voxis apenas verifica que a sua conta possui a licença BYOK." } }, { "@type": "Question", "name": "As sessões BYOK gastam os meus minutos Voxis?", "acceptedAnswer": { "@type": "Answer", "text": "Não. Em BYOK o seu saldo de minutos Voxis fica intacto — o uso é faturado pelo seu fornecedor, na sua própria chave." } }, { "@type": "Question", "name": "Uma única compra cobre o app e a extensão?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. A licença vive na sua conta, por isso o app do Windows e a extensão do Chrome são desbloqueados pela mesma compra." } }, { "@type": "Question", "name": "Posso manter guardadas uma chave Gemini e uma Qwen ao mesmo tempo?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Os dois lugares coexistem e o Voxis escolhe o motor por idioma de destino. Guardar com o campo vazio não muda nada; Limpar remove as chaves guardadas." } } ] }, { "@type": "WebPage", "name": "Configurar BYOK — com a sua própria chave de API | VoxisLive", "url": "https://voxislive.com/pt/byok-setup", "description": "Ative o desbloqueio BYOK do VoxisLive: adicione a sua chave do Google Gemini ou cole as credenciais do Alibaba Qwen e comece a traduzir.", "inLanguage": "pt", "dateModified": "2026-08-30", "isPartOf": { "@type": "WebSite", "name": "VoxisLive", "url": "https://voxislive.com/" } } ] } ```