Obter uma chave da Google, passo a passo
- Abra o Google AI Studio em aistudio.google.com/apikey e inicie sessão com uma conta Google.
- Clique em Criar chave de API. Cada chave pertence a um projeto Google Cloud. Para novos utilizadores, é criado um projeto predefinido; se já usa o Google Cloud, escolha ou crie um projeto.
- Copie a chave e guarde-a num local seguro. Desde 28 de maio de 2026, as novas chaves são chaves de autenticação: estão associadas a uma conta de serviço e restritas à API Gemini desde o início.
- Defina-a como variável de ambiente. Os SDKs da Google leem
GEMINI_API_KEYouGOOGLE_API_KEY; se ambas estiverem definidas,GOOGLE_API_KEYtem prioridade.
Tem uma chave antiga? A API Gemini rejeita chaves padrão sem restrições. No AI Studio, passe o cursor sobre a etiqueta Sem restrições da chave, escolha Adicionar restrições e restrinja-a à API Gemini.
Testar a chave
O Gemini também responde a pedidos no formato da OpenAI, o que permite um teste rápido. Os pedidos nativos enviam a chave num cabeçalho x-goog-api-key.
export GEMINI_API_KEY="your-key"curl https://generativelanguage.googleapis.com/v1beta/openai/chat/completions \ -H "Authorization: Bearer $GEMINI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gemini-3.8-flash", "messages": [{"role": "user", "content": "Say hello"}]}'O nível gratuito e o que lhe custa
Uma chave nova funciona no nível gratuito sem cartão. Este inclui os modelos Flash e Flash-Lite, o Gemini 2.5 Pro, os modelos de conversão de texto em voz e Live e embeddings, com limites de pedidos inferiores aos dos níveis pagos. O Gemini 4 Argon, o Gemini 3.1 Pro e os modelos de imagem exigem faturação.
A contrapartida: no nível gratuito, a Google usa o que envia e as respostas que recebe para melhorar os seus produtos, e revisores humanos podem ler esse conteúdo. No nível pago, não o faz. Não envie dados pessoais ou confidenciais com uma chave gratuita.
Ativar a faturação
No AI Studio, escolha Configurar faturação no projeto, associe uma conta de faturação Cloud e faça um pré-pagamento de pelo menos $5. Os limites de despesa aumentam consoante o montante já pago:
| Escalão | Requisitos | Limite de despesa |
|---|---|---|
| Grátis | Um projeto ativo | Apenas modelos gratuitos |
| Nível 1 | Uma conta de faturação associada | $250 |
| Nível 2 | $100 pagos, 3 dias após o primeiro pagamento | $2,000 |
| Nível 3 | $1,000 pagos, 30 dias depois | $20,000 ou mais |
Depois, cada pedido é faturado por token. Preços de tabela por 1M tokens:
| Modelo | Entrada | Saída | Na Zurelay (entrada / saída) |
|---|---|---|---|
| Gemini 4 Argon | $2.00 | $10.00 | $0.80 / $4.00 |
| Gemini 3.1 Pro | $2.00 | $12.00 | $0.50 / $3.45 |
| Gemini 3.8 Flash | $0.75 | $3.75 | $0.22 / $1.10 |
| Gemini 3.5 Flash-Lite | $0.30 | $2.50 | $0.12 / $1.04 |
O Google AI Pro ou Ultra inclui a API?
Não. As vantagens de um plano Google AI aplicam-se apenas no site do AI Studio; as chamadas à Gemini API com uma chave são faturadas separadamente, através do Google Cloud.
Mantenha a chave segura
- Guarde-a no servidor. Uma chave numa página web ou aplicação pode ser copiada e usada para gerar custos na sua conta de faturação.
- Restrinja cada chave à Gemini API e use um projeto separado para cada aplicação.
- Defina um alerta de orçamento na faturação do Google Cloud, pois a utilização paga é cobrada à sua conta.
Outra opção: Gemini com a mesma chave que Claude e GPT
Na Zurelay, Gemini é mais um nome de modelo disponível com uma chave compatível com OpenAI, com os custos deduzidos do saldo pré-pago e sem conta de faturação Cloud (71% abaixo do preço de tabela da Google para o Gemini 3.8 Flash):
from openai import OpenAIclient = OpenAI(base_url="https://api.zurelay.com/v1", api_key="YOUR_ZURELAY_KEY")reply = client.chat.completions.create( model="gemini-3.8-flash", messages=[{"role": "user", "content": "Say hello"}],)print(reply.choices[0].message.content)A Zurelay não tem um nível gratuito; o saldo começa nos $10. Se o nível gratuito cobrir as suas necessidades, a chave da própria Google é a opção mais económica para começar. Consulte os preços da Gemini API para ver todos os modelos.
Os passos, o nível gratuito e a faturação foram consultados nas páginas Chave de API, pricing, limites de pedidos, terms e Planos Google AI da Google em 28 de outubro de 2026.