Uma chave de API do Gemini permite que um aplicativo use os modelos do Google com a sua própria conta, em vez de uma assinatura. Criar uma leva cerca de dois minutos e você só precisa de uma conta do Google.
Crie a chave
- Abra o Google AI Studio e faça login.
- Se for sua primeira visita, aceite os Termos de Serviço. Para um usuário novo, o AI Studio cria um projeto padrão do Google Cloud e uma primeira chave de API.
- Se nenhuma chave foi criada, abra a página API Keys e clique em Create API key.
- Copie a chave e guarde-a em um lugar privado. Trate-a como uma senha.
Se você já usa o Google Cloud, o AI Studio não cria um projeto para você. Abra Dashboard → Projects, clique em Import projects, escolha seu projeto e importe-o. Depois disso, Create API key funciona na página API Keys.
Se o botão estiver desativado com a mensagem “You do not have permission to create a key in this project”, o projeto pertence a uma organização que restringe a criação de chaves. Peça permissão ao administrador ou crie um projeto novo que não esteja vinculado à organização.
Se uma chave antiga parar de funcionar
O Google mudou seus tipos de chave em 2026. As chaves criadas no AI Studio desde 28 de maio de 2026 são de um tipo novo que o Google chama de auth keys, e a API do Gemini agora recusa chaves padrão sem restrições. Chaves sem restrição que ficaram muito tempo sem uso aparecem como Blocked.
Se uma chave criada antes falhar de repente, abra-a no AI Studio, escolha Add restrictions, depois Restrict to Gemini API only e Restrict key. Ou simplesmente crie uma chave nova.
Quais modelos são gratuitos
| Modelo | Nível gratuito | Aceita imagens |
|---|---|---|
| Gemini 3.1 Flash-Lite | Sim | Sim |
| Gemini 3.5 Flash-Lite | Sim | Sim |
| Gemini 3.6 Flash | Sim | Sim |
| Gemini 3.8 Flash | Sim | Sim |
| Gemini 3.1 Pro (prévia) | Não | Sim |
| Gemini 4 Argon | Não | Sim |
O Gemini 4 Argon, lançado em outubro de 2026, é somente pago. Para o modelo gratuito mais novo com a mesma chave, use o Gemini 3.8 Flash.
Outra diferença: no nível gratuito, o Google pode usar seus prompts e respostas para melhorar seus produtos; no nível pago, não. Lembre-se disso antes de enviar algo privado.
O que o nível gratuito oferece
O Google não publica um número único que valha para todos. Três coisas valem a pena saber:
- Os limites são contados de três formas: solicitações por minuto, tokens de entrada por minuto e solicitações por dia. Ultrapassar qualquer um deles retorna um erro até a redefinição.
- Os limites pertencem ao projeto, não à chave. Criar uma segunda chave no mesmo projeto não dobra a sua cota.
- A contagem diária é redefinida à meia-noite, no horário do Pacífico.
Os seus números aparecem no AI Studio, modelo por modelo. Confira-os antes de depender de um modelo para algo longo: os modelos Flash-Lite, mais leves, costumam permitir mais solicitações que os maiores.
Qual modelo escolher
Para perguntas do dia a dia, comece com o Gemini 3.5 Flash-Lite, o mais rápido e econômico dos modelos 3.5. Passe para o Gemini 3.6 Flash ou o Gemini 3.8 Flash quando a resposta exigir mais raciocínio. Todos aceitam imagens, então gráficos e diagramas também funcionam.
Mantenha a chave segura
- Não cole a chave em mensagens de chat, capturas de tela, repositórios públicos ou notas compartilhadas.
- No AI Studio, use Add restrictions e escolha Restrict to Gemini API only, para que uma chave vazada não sirva em outros serviços do Google.
- Se uma chave vazar, crie outra, passe a usar a nova e depois desative a antiga.
Usando a chave no LuciQA
O LuciQA é um aplicativo de desktop que responde perguntas sobre o que está na sua tela com o provedor que você escolher. Abra Configurações, escolha Google Gemini, cole a chave, selecione um modelo e salve. A chave fica no armazenamento seguro do sistema operacional, e as solicitações vão direto do seu computador para o Google.
O guia de configuração do Gemini repete esses passos com a lista atual de modelos, e a comparação de APIs de IA gratuitas mostra os outros provedores com nível gratuito.