Início › Chaves de API › Google Gemini
✓ Verificado nas páginas oficiais da Google a 23 de setembro de 2026. Os ecrãs e os preços mudam: se algo parecer diferente, confie no que a Google lhe mostrar.
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 da Google, e receber a tradução de volta; a Google oferece um plano gratuito com limites, e um plano pago que carrega antecipadamente.
📖 Palavras que vai encontrar
- API key: um código secreto longo. Quem o tiver pode usar a sua quota (e o seu crédito, se pagar), por isso trate-o como uma palavra-passe.
- Google AI Studio: o site da Google onde cria chaves do Gemini, em aistudio.google.com.
- Projeto: um contentor que a Google usa para agrupar as suas chaves e faturação. O AI Studio cria um para si.
- Plano gratuito / plano pago: plano gratuito = sem cartão, sem cobranças, mas limites mais baixos. Plano pago = adiciona um cartão e pré-paga crédito.
- Token: a unidade pela qual a Google cobra. Para o Gemini, 1 token equivale a cerca de 4 caracteres.
O que precisa antes de começar
- Uma conta Google (um endereço Gmail serve).
- Para o plano gratuito: sem cartão. As novas contas começam no plano gratuito.
- Para o plano 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 plano gratuito: dois avisos honestos
- O seu texto pode ser usado pela Google. No plano gratuito, a Google pode usar o que envia para melhorar os seus produtos, e revisores humanos podem lê-lo. Os termos da Google dizem para não enviar informação sensível, confidencial ou pessoal. As suas páginas web públicas normalmente não são secretas, mas pense nisso se o seu site tiver conteúdo privado. Exceção: se estiver no Espaço Económico Europeu, na Suíça ou no Reino Unido, a Google diz que as regras de dados do plano pago se aplicam a si mesmo no plano gratuito.
- Empresas na Europa ou no Reino Unido: leiam esta linha nos termos da Google. Os termos da Google dizem que, quando disponibiliza um “API Client” a utilizadores no EEE, na Suíça ou no Reino Unido, só pode usar os serviços pagos. Se traduzir o seu próprio site conta como isso é uma questão jurídica que não podemos responder por si. Se tiver dúvidas, configure a faturação (passo 7 abaixo) ou consulte o seu consultor.
Além disso, o plano gratuito tem limites de taxa (quantos pedidos por minuto e por dia). A Google não publica números fixos na sua página de documentação; vê os seus próprios limites no AI Studio. Sites grandes podem precisar de vários dias, ou do plano pago.
Passo a passo
Isto é tudo o que precisa para o plano gratuito. Para passar ao plano pago (limites mais altos, e o seu texto não é usado para melhorar os produtos da Google):
Bom saber: desde 28 de maio de 2026 toda a nova chave criada no AI Studio é de um tipo novo e mais seguro (“auth key”). A Google diz que rejeita as chaves “standard” mais antigas a partir de setembro de 2026. Se tiver uma chave Gemini antiga, crie uma nova.
Quanto custa
Plano gratuito: gratuito nos modelos que a Google oferece de graça, dentro dos seus limites de taxa.
Plano pago — preço oficial (página de preços da API do Gemini da Google, verificado a 23 de setembro de 2026), por 1 milhão de tokens:
| Model | Texto que envia (entrada) | Texto que recebe de volta (saída, incluindo “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 predefinido do TranslateRocket é gemini-flash-lite-latest, um nome que a Google aponta para a sua versão Flash-Lite mais recente. A Google não diz nessa página qual é a versão de hoje, por isso verifique o preço do modelo Flash-Lite que vê no AI Studio.
O que isto significa para um site pequeno. O 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 breves com cada lote, e o texto traduzido é muitas vezes mais longo do que o inglês. Para segurança, contamos 30 000 tokens de entrada e 30 000 de saída. Os modelos mais recentes do Gemini também podem “pensar” antes de responder, e a Google fatura esse raciocínio como saída, por isso o valor real pode ser maior.
- Plano 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 ao fim de 12 meses e não é reembolsável (exceto nos casos específicos que a Google indica).
Segurança (leia, por favor)
1. No plano gratuito não pode ser cobrado. Sem faturação configurada, a Google não tem cartão para cobrar.
2. No plano pago, defina um teto de gastos.
- No AI Studio, abra a página Spend.
- Em Monthly spend cap, clique em Edit spend cap.
- Introduza um valor mensal, por exemplo $5, e guarde.
A Google marca esta funcionalidade como experimental e avisa que os gastos podem ultrapassar o teto durante cerca de 10 minutos antes de parar. Se ativar a recarga automática, defina também um Monthly Limit: página Billing do AI Studio → Manage auto-reload → expanda Monthly Limit → introduza um valor → Save. Com crédito pré-pago e recarga automática desativada, nunca pode perder mais do que o crédito que carregou.
3. Defina também um limite dentro do TranslateRocket. Em TranslateRocket → AI Translation, secção Usage & limits, preencha Daily character limit (por exemplo 200000). Quando o limite é atingido, a tradução por IA para até ao dia seguinte. 0 significa sem limite.
4. Nunca partilhe a chave. A Google diz: trate-a como uma palavra-passe. Não a coloque em e-mails, conversas, capturas de ecrã ou pedidos de suporte.
5. Se achar que a chave foi exposta (lista de verificação da própria Google):
- Crie uma nova chave no AI Studio e cole-a no TranslateRocket.
- Desative ou elimine a chave antiga na página Credentials da consola Google Cloud: https://console.cloud.google.com/apis/credentials (selecione o projeto, depois a chave). Uma chave eliminada pode ser restaurada dentro de 30 dias se eliminou a errada.
- Verifique a sua utilização no AI Studio (Dashboard → Usage) para atividade que não reconheça.
Onde a colar no TranslateRocket
- No seu painel do WordPress, abra TranslateRocket → AI Translation.
- Na caixa Provider & keys, encontre o cartão chamado Google Gemini.
- Cole a sua chave no campo API key.
- No topo da caixa, defina Active provider para Google Gemini.
- Opcional: o campo Model pode ficar vazio (o TranslateRocket usa então gemini-flash-lite-latest). O botão Load available models lista os modelos que a sua chave pode usar.
- Clique em Save AI settings no fundo da página.
O cartão mostra agora o emblema Active. Pode traduzir a partir do ecrã Translations, ou página a página no editor visual.
Se algo não funcionar
| O que vê | O que normalmente significa | O que fazer |
|---|---|---|
| Um erro sobre uma chave inválida, ou HTTP 400/403 | A chave foi copiada incorretamente, ou é uma chave standard antiga que a Google já não aceita, ou está marcada como Blocked no AI Studio. | Cole-a novamente com cuidado. Se continuar a falhar, crie uma nova chave no AI Studio: as chaves novas são o tipo aceite. |
429 RESOURCE_EXHAUSTED |
Enviou demasiado, demasiado depressa: limites do plano gratuito, ou (plano pago) o limite de velocidade de gastos. Os limites diários repõem-se à meia-noite no horário do Pacífico. | Aguarde e tente mais tarde, traduza menos páginas de cada vez, ou passe ao plano pago. |
402 Payment Required |
Plano pago: o seu crédito pré-pago está a $0. Todas as chaves ligadas a essa conta de faturação param em conjunto. | Página Billing do AI Studio → Buy credits. |
Perguntas frequentes
A chave de API do Gemini é gratuita?
Sim, há um plano gratuito sem cartão, com limites de taxa que vê no Google AI Studio. No plano gratuito, a Google pode usar o texto que envia para melhorar os seus produtos; aplicam-se regras diferentes no EEE, na Suíça e no Reino Unido.
A minha antiga chave de API do Gemini deixou de funcionar. Porquê?
Desde 28 de maio de 2026, as novas chaves criadas no AI Studio são de um tipo novo e mais seguro, e a Google diz que rejeita as chaves “standard” mais antigas a partir de setembro de 2026. Crie uma nova chave no AI Studio.
O Gemini é o mesmo que o Google Cloud Translation?
Não. O Gemini é o modelo de IA da Google, com chaves do Google AI Studio. O Google Cloud Translation é o serviço profissional do Google Translate, com chaves da consola Google Cloud e faturação obrigatória.
Quanto custa o Gemini pago?
O plano pago começa com um pré-pagamento de $5. Com os modelos Flash-Lite, um site de 20 páginas num idioma custa aproximadamente entre $0,02 e $0,08.
Qual devo escolher?
Veja a 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 chave nenhuma.
Outros guias: OpenAI · Anthropic (Claude) · DeepL · Google Cloud Translation · Qual devo escolher?
