Para usar a API Gemini, autentique suas solicitações. Você pode fazer a autenticação usando uma chave de API padrão ou de autorização.
Criar ou consultar uma chave da API Gemini
Tipos de chave de API: padrão versus autorização
As chaves de API fornecem acesso à API Gemini, mas as características de segurança delas são diferentes. A API Gemini está fazendo a transição de chaves de API padrão para chaves de autorização para melhorar a segurança:
- Chaves de API padrão: associam solicitações a um projeto do Google Cloud para fins de faturamento e cota. As chaves padrão não identificam um autor da chamada, o que limita a granularidade das permissões e o controle de acesso que elas podem oferecer.
- Chaves de autorização (auth): vinculadas diretamente a uma conta de serviço do Google Cloud. Quando você usa uma chave de autorização, as solicitações são processadas na identidade dessa conta de serviço vinculada, permitindo o controle de acesso granular. As chaves de autorização são restritas à API Generative Language (API Gemini) por padrão e fornecem uma aplicação de chave vazada de ação rápida que interrompe rapidamente o uso de chaves vazadas detectadas pelos nossos sistemas.
Para garantir o uso seguro, a API Gemini vai migrar de chaves padrão para chaves de autorização:
- Chaves de autorização padrão: todas as novas chaves de API criadas no Google AI Studio são criadas automaticamente como chaves de autorização.
- Chaves irrestritas rejeitadas: a API Gemini rejeita solicitações de chaves padrão irrestritas. As chaves de API padrão que têm restrições explícitas aplicadas continuam funcionando. Essa restrição impede o uso não autorizado de chaves que podem ser compartilhadas publicamente ou vinculadas a outros serviços.
- Em setembro de 2026: a API Gemini vai rejeitar solicitações de chaves padrão. Você deve migrar para chaves de autorização antes dessa data para evitar interrupções no serviço. Migre para chaves de autorização antes de setembro de 2026.
Como gerenciar chaves de API no Google AI Studio
Você pode gerenciar seus projetos e chaves diretamente no Google AI Studio.
Projetos do Google Cloud
Cada chave da API Gemini está associada a um projeto do Google Cloud. Os projetos do Google Cloud gerenciam o faturamento, os colaboradores e as permissões. O Google AI Studio oferece uma interface leve para acessar esses projetos.
- Projeto padrão: se você for um novo usuário, o Google AI Studio vai criar automaticamente um projeto na nuvem do Google Cloud e uma chave de API padrão depois que você aceitar os Termos de Serviço. Você pode renomear esse projeto navegando até a visualização Projetos no painel.
- Projetos atuais: se você já tiver uma conta do Google Cloud, o AI Studio não vai criar um projeto padrão. Em vez disso, importe seus projetos atuais.
Como importar projetos
Por padrão, o Google AI Studio não mostra todos os seus projetos do Google Cloud. Você precisa importar os projetos que quer usar:
- Acesse o Google AI Studio.
- Abra o painel no painel esquerdo e selecione Projetos.
- Clique no botão Importar projetos.
- Pesquise e selecione o projeto do Google Cloud que você quer importar e clique em Importar.
- Depois de importado, navegue até a página Chaves de API no painel para criar uma chave nesse projeto.
Resolver problemas de permissões de criação de chaves
Se o botão Criar chave de API não estiver disponível e mostrar a mensagem: "Você não tem permissão para criar uma chave neste projeto", você não tem as permissões necessárias do IAM.
Peça ao administrador do projeto ou da organização do Google Cloud para conceder a você um papel que contenha as seguintes permissões (como Editor de projetos):
resourcemanager.projects.get: permite que o AI Studio verifique o projeto.apikeys.keys.create: permite a geração de chaves.serviceusage.services.enable: garante que a API Generative Language esteja ativada.iam.serviceAccounts.create: necessária para criar a conta de serviço vinculada.iam.serviceAccountApiKeyBindings.create: vincula a conta de serviço à chave de API.
Se você não conseguir acesso administrativo, crie um novo projeto do Google Cloud que não esteja associado a uma organização para gerar suas chaves.
Como configurar o ambiente
Depois de ter uma chave, configure seu ambiente para usá-la com segurança nos aplicativos.
Opção 1: usar variáveis de ambiente (recomendado)
Defina a variável de ambiente GEMINI_API_KEY ou GOOGLE_API_KEY. As bibliotecas de cliente da API Gemini detectam e usam essas variáveis automaticamente. Se as duas estiverem definidas,