Español – América Latina Português – Brasil Para usar a API Gemini, é necessário autenticar suas solicitações. É possível autenticar usando uma chave de API padrão ou de autorização. Criar ou visualizar uma chave da API Gemini Tipos de chaves de API: padrão x 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á migrando 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 chamador, o que limita a granularidade das permissões e do 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, suas 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 oferecem uma aplicação rápida de chaves vazadas 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 autenticação: Chaves de autenticação padrão : a partir de 28 de maio de 2026, todas as novas chaves de API criadas no Google AI Studio serão criadas automaticamente como chaves de autenticação. Chaves irrestritas rejeitadas : a API Gemini rejeita solicitações de chaves padrão irrestritas . As chaves de API padrão com 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ê precisa migrar para chaves de autenticação antes dessa data para evitar interrupções no serviço. Migre para chaves de autenticaçã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 de API do 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 padrão do Google Cloud e uma chave de API depois que você aceitar os Termos de Serviço. Para renomear o projeto, acesse 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. Importar projetos Por padrão, o Google AI Studio não mostra todos os seus projetos do Google Cloud. Importe os projetos que você quer usar: Acesse o Google AI Studio . Abra o Painel no painel à esquerda e selecione Projetos . Clique no botão Importar projetos . Pesquise e selecione o projeto na nuvem do Google Cloud que você quer importar e clique em Importar . Depois da importação, acesse 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 estiver indisponível e mostrar a mensagem: "Você não tem permissão para criar uma chave neste projeto" , significa que 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 : obrigatório para criar a conta de serviço vinculada. iam.serviceAccountApiKeyBindings.create : vincula a conta de serviço à chave de API. Se não for possível conseguir acesso administrativo, crie um 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 seus 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 ambos estiverem definidos, GOOGLE_API_KEY terá precedência. Selecione seu sistema operacional para definir a variável: Linux/macOS: Bash Verifique se você tem um arquivo de configuração do bash: Se não houver, crie e abra um: Adicione o comando de exportação ao final do arquivo: Salve o arquivo e aplique as mudanças: Verifique se você tem um arquivo de configuração do zsh: Se não houver, crie e abra um: Adicione o comando de exportação: Salve o arquivo e aplique as mudanças: Pesquise "Variáveis de ambiente" na barra de pesquisa do Windows. Clique em Variáveis de ambiente na caixa de diálogo "Propriedades do sistema". Em Variáveis de usuário ou Variáveis do sistema , clique em Nova... . Defina o nome da variável como GEMINI_API_KEY e o valor como sua chave de API. Clique em OK para salvar. Abra uma nova sessão de terminal para carregar a variável. Opção 2: fornecer a chave de API explicitamente no código Você pode transmitir a chave de API explicitamente ao inicializar o cliente. Faça isso apenas se não for possível usar variáveis de ambiente.

Segurança e gerenciamento de secrets Trate sua chave da API Gemini como uma senha. Se comprometida, outras pessoas podem consumir a cota do seu projeto, gerar cobranças inesperadas e acessar recursos particulares. Regras de segurança críticas Mantenha as chaves confidenciais : nunca verifique as chaves de API em sistemas de controle de origem, como o Git. Nunca exponha chaves do lado do cliente em produção : não codifique chaves de API diretamente em apps da Web ou para dispositivos móveis. As chaves compiladas em código do lado do cliente podem ser extraídas pelos usuários. Para proteger apps do lado do cliente, execute um servidor proxy de back-end para fazer as chamadas de API reais. Práticas recomendadas de gerenciamento de secrets Variáveis de ambiente : leia chaves de variáveis de ambiente em vez de arquivos de configuração. Secret Manager : para produção, armazene suas chaves em um armazenamento de secrets seguro, como o Secret Manager do Google Cloud . Alertas de faturamento : configure alertas de faturamento no console do Google Cloud para receber notificações se houver um aumento no uso ou nos custos. Lista de verificação de resposta a vazamentos Se você suspeitar que sua chave de API foi vazada: Gere uma nova chave : crie uma chave substituta no Google AI Studio ou no Console do Cloud. Atualize o aplicativo : implante o código usando a nova chave. Desative ou exclua a chave comprometida : desative a chave vazada no Console do Cloud assim que a nova chave for verificada. Não exclua a chave antiga até que a nova esteja totalmente ativa para evitar tempo de inatividade do aplicativo. Auditoria de uso : verifique os registros de faturamento e o uso da API no console do Google Cloud para identificar atividades não autorizadas. Restringir e proteger suas chaves Adicionar restrições às chaves de API minimiza o dano potencial se uma chave for comprometida. Aplicar restrições de origem da solicitação As restrições de origem limitam quais endereços IP, sites ou aplicativos podem usar sua chave. Acesse a página "Credenciais" do console do Google Cloud . Selecione seu projeto e clique no nome da chave de API que você quer restringir. Em Restrições de aplicativo , selecione Endereços IP ou o tipo de restrição adequado para seu ambiente. Especifique os endereços ou intervalos de IP permitidos e clique em Salvar . Como proteger chaves de API padrão irrestritas Para continuar usando a API Gemini, proteja todas as chaves irrestritas. Método A: restringir a chave apenas à API Gemini (AI Studio) Se você usar a chave apenas para a API Gemini, proteja-a diretamente no AI Studio: Na página Chaves de API do Google AI Studio , localize as chaves marcadas com o rótulo Sem restrições . Passe o cursor sobre o marcador e clique em Adicionar restrições na caixa de diálogo. Selecione Restringir apenas à API Gemini . Clique em Restringir chave para confirmar. Método B: restringir a chave para outros serviços (console do Google Cloud) Se a chave for compartilhada com outras APIs do Google (não recomendado), restrinja-a no console do Cloud. Observação: as solicitações da API Gemini que usam essa chave vão falhar depois que essas restrições forem aplicadas. Acesse a página "Credenciais" do console do Google Cloud . Selecione o projeto e a chave de API. Em Restrições da API , use o menu suspenso Selecionar restrições da API para escolher as APIs que você quer que essa chave acesse. Não selecione a API Generative Language . Clique em Salvar . Crie uma chave separada e restrita no AI Studio para continuar usando a API Gemini. Chaves inativas bloqueadas A partir de 7 de maio de 2026, a API Gemini vai bloquear chaves de API irrestritas que estiverem inativas por um longo período. Essas chaves mostram uma tag Bloqueado no AI Studio. Você precisa gerar uma nova chave ou usar uma chave restrita para continuar. Migrar para uma chave de autenticação Siga estas etapas para criar uma nova chave de API de autenticação e atualizar seus aplicativos: Acesse a página Chaves de API do AI Studio . Verifique a coluna Tipo de chave para identificar as chaves listadas como Padrão . Clique em Criar chave de API para gerar uma nova chave. Todas as novas chaves criadas no AI Studio são criadas automaticamente como chaves de autenticação. Copie a nova chave de API de autenticação. Atualize o código do aplicativo, as variáveis de ambiente e as configurações de implantação para usar a nova chave de API de autenticação. Teste o aplicativo para confirmar se ele funciona corretamente com a nova chave. Depois da verificação, exclua ou revogue a chave de tráfego antiga para evitar uso indevido. O Google AI Studio impõe as seguintes limitações de gerenciamento de projetos e chaves: É possível criar no máximo 10 projetos por vez na página Projetos do Google AI Studio. As páginas Chaves de API e Projetos mostram um máximo de 100 chaves e 50 projetos. Somente as chaves de API irrestritas ou restritas especificamente à API Generative Language (API Gemini) são mostradas. Para gerenciamento avançado de projetos ou para modificar chaves com outras restrições, use a página de credenciais do console do Google Cloud . Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons , e as amostras de código são licenciadas de acordo com a Licença Apache 2.0 . Para mais detalhes, consulte as políticas do site do Google Developers . Java é uma marca registrada da Oracle e/ou afiliadas. Última atualização 2026-09-17 UTC.