Obtenha uma chave do Google, passo a passo
- Abra o Google AI Studio em aistudio.google.com/apikey e entre com uma conta do Google.
- Clique em Criar chave de API. Toda chave pertence a um projeto do Google Cloud. Um projeto padrão é criado para novos usuários; se você já usa o Google Cloud, escolha ou crie um projeto.
- Copie a chave e guarde-a em um local seguro. Desde 28 de maio de 2026, as novas chaves são chaves de autenticação: vinculadas a uma conta de serviço e restritas à API do Gemini desde a criação.
- Defina a chave como uma variável de ambiente. Os SDKs do Google leem
GEMINI_API_KEYouGOOGLE_API_KEY; se ambas estiverem definidas,GOOGLE_API_KEYtem prioridade.
Você tem uma chave antiga? A API do Gemini rejeita chaves padrão sem restrições. No AI Studio, passe o cursor sobre o rótulo Sem restrições da chave, escolha Adicionar restrições e restrinja-a à API do Gemini.
Teste a chave
O Gemini também aceita requisições no formato da OpenAI, o que permite um teste rápido. Já as requisições nativas enviam a chave em um 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 ele custa para você
Uma nova chave funciona no nível gratuito sem cartão. Ele inclui os modelos Flash e Flash-Lite, Gemini 2.5 Pro, os modelos de conversão de texto em fala e Live e embeddings, com limites de requisições menores que os dos níveis pagos. Gemini 4 Argon, Gemini 3.1 Pro e os modelos de imagem exigem cobrança ativada.
A contrapartida: no nível gratuito, o Google usa o que você envia e as respostas que recebe para melhorar seus produtos, e revisores humanos podem ler esse conteúdo. No nível pago, isso não acontece. Não use uma chave gratuita para dados pessoais ou confidenciais.
Ative a cobrança
No AI Studio, escolha Configurar cobrança no projeto, vincule uma conta de faturamento do Cloud e pague pelo menos $5 antecipadamente. Os limites de gastos aumentam conforme o valor que você já pagou:
| Categoria | Requisito | Limite de gastos |
|---|---|---|
| Grátis | Um projeto ativo | Apenas modelos gratuitos |
| Nível 1 | Uma conta de faturamento vinculada | $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 requisição é cobrada 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. Os benefícios de um plano Google AI valem apenas no site do AI Studio; as chamadas à API Gemini com uma chave são cobradas separadamente, pelo Google Cloud.
Proteja sua chave
- Mantenha a chave no servidor. Uma chave em uma página web ou app pode ser copiada e usada para gerar cobranças na sua conta.
- Restrinja cada chave à API Gemini e use um projeto separado por app.
- Configure um alerta de orçamento no faturamento do Google Cloud, já que o uso pago é cobrado na sua conta.
Outra opção: Gemini na mesma chave que Claude e GPT
Na Zurelay, Gemini é mais um nome de modelo disponível com uma chave compatível com OpenAI, com cobrança por créditos pré-pagos e sem conta de faturamento do Google Cloud (71% abaixo do preço de tabela do Google no 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 faixa gratuita; os créditos começam em $10. Se a faixa gratuita atende ao que você precisa, a chave do próprio Google é a opção mais barata para começar. Veja os preços da API Gemini para todos os modelos.
Passos, faixa gratuita e faturamento consultados nas páginas Chave de API, pricing, limites de requisições, terms e Planos Google AI do Google em 28 de outubro de 2026.