Início › Chaves de API › Google Gemini
✓ Conferido nas páginas oficiais do Google em 23 de setembro de 2026. Telas e preços mudam: se algo parecer diferente, confie no que o Google mostrar para você.
Uma chave de API do Gemini é um código secreto que permite ao TranslateRocket enviar o texto do seu site para o Gemini, o modelo de IA do Google, e receber a tradução de volta; o Google oferece um nível gratuito com limites e um nível pago que você recarrega com antecedência.
📖 Palavras que você vai encontrar
- API key: um código secreto longo. Quem tiver acesso a ele pode usar sua cota (e seu crédito, se você pagar), então trate-o como uma senha.
- Google AI Studio: o site do Google onde você cria chaves do Gemini, em aistudio.google.com.
- Projeto: um contêiner que o Google usa para agrupar suas chaves e seu faturamento. O AI Studio cria um para você.
- Nível gratuito / nível pago: nível gratuito = sem cartão, sem cobranças, mas com limites mais baixos. Nível pago = você adiciona um cartão e paga crédito adiantado.
- Token: a unidade pela qual o Google cobra. No Gemini, 1 token equivale a cerca de 4 caracteres.
O que você precisa antes de começar
- Uma conta Google (um endereço do Gmail funciona).
- Para o nível gratuito: nenhum cartão. Contas novas começam no nível gratuito.
- Para o nível pago: um cartão de pagamento, e um pré-pagamento de pelo menos $5 (ou o equivalente na sua moeda).
- Cerca de 5 minutos.
Antes de escolher o nível gratuito: dois avisos honestos
- Seu texto pode ser usado pelo Google. No nível gratuito, o Google pode usar o que você envia para melhorar seus produtos, e revisores humanos podem lê-lo. Os termos do Google dizem para não enviar informações sensíveis, confidenciais ou pessoais. Suas páginas web públicas normalmente não são segredo, mas pense nisso se seu site tiver conteúdo privado. Exceção: se você está no Espaço Econômico Europeu, na Suíça ou no Reino Unido, o Google diz que as regras de dados do nível pago valem para você mesmo no nível gratuito.
- Empresas na Europa ou no Reino Unido: leia esta linha nos termos do Google. Os termos do Google dizem que, ao disponibilizar um “API Client” para usuários na EEE, na Suíça ou no Reino Unido, você só pode usar os serviços pagos. Se traduzir seu próprio site se enquadra nisso é uma questão jurídica que não podemos responder por você. Se tiver dúvidas, configure o faturamento (passo 7 abaixo) ou consulte seu advogado.
Além disso, o nível gratuito tem limites de taxa (quantas requisições por minuto e por dia). O Google não publica números fixos na página de documentação; você vê seus próprios limites no AI Studio. Sites grandes podem precisar de vários dias, ou do nível pago.
Passo a passo
Isso é tudo o que você precisa para o nível gratuito. Para passar ao nível pago (limites mais altos, e seu texto não é usado para melhorar os produtos do Google):
Bom saber: desde 28 de maio de 2026, toda chave nova criada no AI Studio é de um tipo novo e mais seguro (“auth key”). O Google diz que recusa chaves “standard” antigas a partir de setembro de 2026. Se você tem uma chave antiga do Gemini, crie uma nova.
Quanto custa
Nível gratuito: sem custo nos modelos que o Google oferece gratuitamente, dentro dos seus limites de taxa.
Nível pago — preço oficial (página de preços da Gemini API do Google, conferido em 23 set. 2026), por 1 milhão de tokens:
| Model | Texto que você envia (entrada) | Texto que você recebe de volta (saída, incluindo o “raciocínio”) |
|---|---|---|
| Gemini 2.5 Flash-Lite | $0.10 | $0.40 |
| Gemini 3.5 Flash-Lite | $0.30 | $2.50 |
| Gemini 2.5 Flash | $0.30 | $2.50 |
O modelo padrão do TranslateRocket é gemini-flash-lite-latest, um nome que o Google aponta para a versão mais recente do Flash-Lite. O Google não diz nessa página qual é a versão atual, então confira o preço do modelo Flash-Lite que você vê no AI Studio.
O que isso significa para um site pequeno. Nosso exemplo: um site de 20 páginas com cerca de 600 palavras cada (12.000 palavras, cerca de 75.000 caracteres), traduzido para um idioma.
- 75.000 caracteres são cerca de 19.000 tokens.
- O TranslateRocket também envia instruções curtas em cada lote, e o texto traduzido costuma ser mais longo que o inglês. Para ficar do lado seguro, contamos 30.000 tokens de entrada e 30.000 tokens de saída. Os modelos mais novos do Gemini também podem “pensar” antes de responder, e o Google cobra esse raciocínio como saída, então o valor real pode ser mais alto.
- Nível gratuito: $0.
- Pago, Gemini 2.5 Flash-Lite: 30.000 × $0.10 / 1.000.000 + 30.000 × $0.40 / 1.000.000 ≈ $0.02.
- Pago, Gemini 3.5 Flash-Lite: cerca de $0.08.
O crédito pré-pago expira depois de 12 meses e não é reembolsável (exceto nos casos específicos que o Google lista).
Segurança (leia com atenção)
1. No nível gratuito você não pode ser cobrado. Sem faturamento configurado, o Google não tem nenhum cartão para cobrar.
2. No nível pago, defina um teto de gasto.
- No AI Studio, abra a página Spend.
- Em Monthly spend cap, clique em Edit spend cap.
- Informe um valor mensal, por exemplo $5, e salve.
O Google marca esse recurso como experimental e avisa que o gasto pode ultrapassar o teto por cerca de 10 minutos antes de parar. Se você ativar a recarga automática, defina também um Monthly Limit: página Billing do AI Studio → Manage auto-reload → expanda Monthly Limit → informe um valor → Save. Com crédito pré-pago e a recarga automática desativada, você nunca perde mais do que o crédito que carregou.
3. Defina um limite dentro do TranslateRocket também. Em TranslateRocket → AI Translation, na seção Usage & limits, preencha Daily character limit (por exemplo 200000). Quando o limite é atingido, a tradução por IA para até o dia seguinte. 0 significa sem limite.
4. Nunca compartilhe a chave. O Google diz: trate-a como uma senha. Não a coloque em e-mails, chats, capturas de tela ou chamados de suporte.
5. Se você achar que a chave vazou (checklist do próprio Google):
- Crie uma chave nova no AI Studio e cole-a no TranslateRocket.
- Desative ou exclua a chave antiga na página Credentials do console do Google Cloud: https://console.cloud.google.com/apis/credentials (selecione o projeto e depois a chave). Uma chave excluída pode ser restaurada em até 30 dias, caso você tenha excluído a errada.
- Confira seu uso no AI Studio (Dashboard → Usage) em busca de atividade que você não reconheça.
Onde colá-la no TranslateRocket
- No painel do seu WordPress, abra TranslateRocket → AI Translation.
- Na caixa Provider & keys, encontre o cartão chamado Google Gemini.
- Cole sua chave no campo API key.
- No topo da caixa, defina Active provider como Google Gemini.
- Opcional: o campo Model pode ficar vazio (nesse caso, o TranslateRocket usa o gemini-flash-lite-latest). O botão Load available models lista os modelos que sua chave pode usar.
- Clique em Save AI settings no final da página.
O cartão agora mostra o selo Active. Você pode traduzir pela tela Translations, ou página por página no editor visual.
Se algo não funcionar
| O que você vê | O que geralmente significa | O que fazer |
|---|---|---|
| Um erro sobre chave inválida, ou HTTP 400/403 | A chave foi copiada errada, ou é uma chave standard antiga que o Google não aceita mais, ou está marcada como Blocked no AI Studio. | Cole-a de novo com cuidado. Se ainda assim falhar, crie uma chave nova no AI Studio: as chaves novas são o tipo aceito. |
429 RESOURCE_EXHAUSTED |
Você enviou demais, rápido demais: limites do nível gratuito, ou (nível pago) o limite de velocidade de gasto. Os limites diários são reiniciados à meia-noite do horário do Pacífico. | Espere e tente de novo mais tarde, traduza menos páginas de uma vez, ou passe para o nível pago. |
402 Payment Required |
Nível pago: seu crédito pré-pago está em $0. Todas as chaves vinculadas a essa conta de faturamento param juntas. | Página Billing do AI Studio → Buy credits. |
Perguntas frequentes
A chave de API do Gemini é gratuita?
Sim, existe um nível gratuito sem cartão, com limites de taxa que você vê no Google AI Studio. No nível gratuito, o Google pode usar o texto que você envia para melhorar seus produtos; regras diferentes se aplicam na EEE, na Suíça e no Reino Unido.
Minha chave antiga de API do Gemini parou de funcionar. Por quê?
Desde 28 de maio de 2026, as chaves novas criadas no AI Studio são de um tipo novo e mais seguro, e o Google diz que recusa as chaves “standard” antigas a partir de setembro de 2026. Crie uma chave nova no AI Studio.
O Gemini é a mesma coisa que o Google Cloud Translation?
Não. O Gemini é o modelo de IA do Google, com chaves do Google AI Studio. O Google Cloud Translation é o serviço profissional do Google Translate, com chaves do console do Google Cloud e faturamento obrigatório.
Quanto custa a API paga do Gemini?
O nível pago começa com um pré-pagamento de $5. Com os modelos Flash-Lite, um site de 20 páginas em um idioma custa aproximadamente $0,02 a $0,08.
Qual devo escolher?
Veja nossa página de comparação para uma comparação simples dos cinco serviços, e para a opção gratuita que não precisa de nenhuma chave.
Outros guias: OpenAI · Anthropic (Claude) · DeepL · Google Cloud Translation · Qual devo escolher?
