// DOCUMENTAÇÃO
Manual de Configuração da API Gemini
Este manual apresenta o processo completo de configuração inicial da API Gemini, desde a criação do projeto no Google AI Studio até a geração e o gerenciamento das chaves de API utilizadas pelas aplicações. O objetivo é servir como guia de consulta para futuras implementações, padronizando o processo de configuração e reduzindo o tempo de implantação de novos projetos.
Sumário
- Introdução
- Escolha do modelo de IA
- Acessando a documentação da API Gemini
- Painel de gerenciamento das chaves de API
- Criando uma nova chave de API
- Configuração do faturamento da API Gemini (Conta Pré-paga)
- Resumo – Consulta Rápida
- Lembretes
Introdução
Este documento foi desenvolvido com o objetivo de auxiliar os clientes da CoreDot na criação e configuração de uma chave de API Gemini, etapa necessária para a parametrização e utilização de seus sites e aplicações que fazem uso de inteligência artificial.
Além de servir como guia para os clientes, este material também pode ser útil para outros desenvolvedores, empresas e usuários que desejem compreender o processo de criação de projetos, geração de credenciais e configuração inicial da API Gemini.
Ao longo desta documentação serão apresentados os procedimentos necessários para configurar o ambiente de forma segura e padronizada, bem como algumas decisões técnicas adotadas durante o desenvolvimento dos projetos da CoreDot. O objetivo é simplificar o processo de implantação, reduzir dúvidas recorrentes e fornecer uma referência para futuras implementações e manutenções.
Escolha do modelo de IA
No início deste projeto, foi realizada uma análise dos modelos disponíveis da API Gemini, considerando fatores como estabilidade, qualidade das respostas, facilidade de integração e custo-benefício.
Após diversos testes, optou-se pela utilização do Gemini 2.5 Flash, que apresentou resultados consistentes para as necessidades da aplicação e se mostrou estável durante o desenvolvimento. Embora, desde então, novos modelos tenham sido disponibilizados pela Google, decidiu-se manter o Gemini 2.5 Flash nesta versão do projeto.
A decisão de permanecer com o Gemini 2.5 Flash foi baseada na estabilidade do projeto. Embora a área de inteligência artificial evolua rapidamente e novos modelos sejam lançados com frequência, o modelo atualmente utilizado já foi amplamente testado durante o desenvolvimento, entregando resultados consistentes e atendendo plenamente aos requisitos da aplicação. Por esse motivo, optou-se por priorizar uma base validada em vez de realizar uma migração apenas pela disponibilidade de versões mais recentes.
Em projetos de software, nem sempre a tecnologia mais recente é a melhor escolha. Quando uma solução já entrega os resultados esperados, manter uma base estável reduz riscos e garante maior previsibilidade durante a evolução da aplicação.
Isso não significa que novos modelos serão ignorados. Pelo contrário, a evolução da API Gemini continuará sendo acompanhada continuamente. À medida que novas versões demonstrarem, de forma consistente, desempenho igual ou superior ao modelo atualmente utilizado, sua adoção será avaliada e poderá ser incorporada em futuras versões do projeto — bem como nova documentação será feita, caso seja necessário.
Acessando a documentação da API Gemini
O primeiro passo é acessar a documentação oficial da API Gemini, disponibilizada pela Google. Nela estão reunidas as informações sobre os modelos disponíveis, guias de integração, referências da API e o acesso à área de gerenciamento das chaves de API.
A documentação pode ser acessada pelo endereço: Documentação oficial da API Gemini
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Observação: recomenda-se sempre utilizar a documentação oficial, pois a Google atualiza frequentemente a interface, os modelos disponíveis e as funcionalidades da API.
Próximo passo
Com a documentação da API Gemini aberta e o login realizado, clique no botão Conferir a chave de API, localizado no canto superior direito da página.
Ao selecionar essa opção, você será direcionado para a área de gerenciamento da API Gemini, onde será possível criar projetos, gerar novas chaves de API e administrar as credenciais utilizadas pelas aplicações.
Observação: é necessário estar autenticado em uma conta Google para acessar essa área.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Ação: no menu superior direito, clique em Conferir a chave de API.
Painel de gerenciamento das chaves de API
Após clicar em Conferir a chave de API, você será redirecionado para o painel de gerenciamento do Google AI Studio.
Nesta área é possível administrar todas as credenciais utilizadas pelos projetos, além de acompanhar informações como o projeto ao qual cada chave pertence, a data de criação, o nível de faturamento e o acesso rápido às métricas de utilização.
Caso seja a primeira utilização da conta, esta tela poderá estar vazia. Caso contrário, serão exibidas as chaves de API já existentes.
Observação: uma única conta Google pode possuir diversos projetos e diversas chaves de API. Recomenda-se manter uma organização por projeto ou cliente, facilitando o gerenciamento e o monitoramento do consumo de cada aplicação.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Segurança: por padrão, o Google AI Studio oculta parte da chave de API na listagem. Essa medida ajuda a evitar a exposição acidental da credencial durante apresentações, capturas de tela ou compartilhamento de documentação (no caso desta documentação, ela foi removida).
Conhecendo a tela
Na tela Chaves de API é possível visualizar:
- Chave: identifica cada credencial criada.
- Projeto: informa a qual projeto a chave pertence.
- Criado: data de criação da chave.
- Nível de faturamento: informa se o projeto utiliza o plano gratuito ou o faturamento por consumo (Pay as You Go).
- Menu lateral: permite acessar rapidamente os projetos, monitorar o uso da API, consultar os Rate Limits, acompanhar gastos e gerenciar o faturamento.
- Criar chave de API: inicia o processo de criação de uma nova credencial.
Criando uma nova chave de API
Após acessar o painel de gerenciamento, clique no botão Criar chave de API, localizado no canto superior direito da tela.
Essa opção inicia o processo de criação de uma nova credencial, que será utilizada pela aplicação para autenticar as requisições enviadas à API Gemini.
Ação: clique em Criar chave de API.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Selecionando ou criando um projeto
Ao clicar em Criar chave de API, será exibida uma janela para informar o nome da chave e selecionar o projeto ao qual ela ficará vinculada.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
No campo Escolha um projeto importado, são apresentadas três possibilidades:
- Importar projeto: permite utilizar um projeto já existente do Google Cloud.
- Criar projeto: cria um novo projeto diretamente pelo Google AI Studio.
- Projetos existentes: lista os projetos que já foram criados anteriormente na conta.
Recomendação: para novos clientes, recomenda-se selecionar a opção Criar projeto. Dessa forma, cada cliente possuirá um projeto independente, facilitando o gerenciamento das credenciais, o acompanhamento do consumo da API e a administração do faturamento.
Criando um novo projeto
No campo Escolha um projeto importado, clique na opção Criar projeto. Essa opção permite criar um novo projeto diretamente pelo Google AI Studio, sem a necessidade de acessar previamente o Google Cloud Console.
Ação: clique em Criar projeto.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Ao selecionar, será exibida uma janela para informar o nome do novo projeto. Escolha um nome que facilite sua identificação, principalmente caso existam vários projetos na mesma conta Google.
Neste exemplo, foi utilizado o nome: GeminiAPI
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Após informar o nome desejado, clique em Criar projeto. Ao concluir a criação, o Google AI Studio retornará automaticamente à tela de criação da chave, já selecionando o projeto recém-criado.
Criando a chave de API
Com o projeto criado, o próximo passo é informar um nome para a chave de API. Esse nome serve apenas para facilitar sua identificação dentro do Google AI Studio e pode ser definido livremente.
Neste manual, será utilizado o nome: ChaveExemplo
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Observação: o nome da chave não interfere no funcionamento da aplicação. Ele existe apenas para facilitar a organização das credenciais, especialmente quando um mesmo projeto possuir mais de uma chave de API.
Exemplos de nomenclatura
- Produção
- Desenvolvimento
- Site Principal
- Aplicação Mobile
- ChaveExemplo (utilizado neste manual)
Após informar o nome desejado, confirme se o projeto correto está selecionado e clique em Criar chave.
Curiosidade: um mesmo projeto pode possuir diversas chaves de API. Isso permite, por exemplo, utilizar chaves diferentes para os ambientes de desenvolvimento, homologação e produção, mantendo o consumo e as permissões organizados dentro do mesmo projeto.
Chave criada com sucesso
Após clicar em Criar chave, o Google AI Studio exibirá a tela com os detalhes da nova credencial.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Nessa tela são apresentadas as principais informações da chave criada (algumas informações foram omitidas por questões de segurança), incluindo:
- Chave de API: credencial que será utilizada pela aplicação para autenticar as requisições à API Gemini.
- Nome: nome definido para facilitar a identificação da chave.
- Nome do projeto: projeto ao qual a chave está vinculada.
- Número do projeto: identificador único do projeto no Google Cloud.
Neste momento, a chave já está pronta para ser utilizada pela aplicação.
Importante: copie a chave de API e armazene-a em um local seguro. Ela será utilizada na configuração da aplicação e não deve ser compartilhada publicamente.
Botões disponíveis
- Copiar chave: copia a chave de API para a área de transferência.
- Copiar cURL de início rápido: copia um exemplo de requisição para testes rápidos na API Gemini.
- Excluir chave: remove permanentemente a credencial criada.
Boas práticas de segurança
- Nunca publique sua chave de API em repositórios públicos (GitHub, GitLab, etc.).
- Evite compartilhar a chave em capturas de tela, vídeos ou documentações.
- Armazene a credencial em variáveis de ambiente (
.env) ou em serviços de gerenciamento de segredos. - Caso suspeite que a chave tenha sido exposta, exclua-a imediatamente e gere uma nova.
Próximos passos
Após concluir a criação da chave de API, encaminhe a credencial ao desenvolvedor responsável pela integração da aplicação.
A partir dessa etapa, caberá ao desenvolvedor configurar a utilização da API, definir o modelo de inteligência artificial mais adequado para o projeto e realizar a implementação da aplicação.
Configuração do faturamento da API Gemini (Conta Pré-paga)
Após a criação da chave de API, ela passará a ser exibida no painel de gerenciamento do Google AI Studio. É nessa tela que ficarão listadas todas as chaves cadastradas na conta, juntamente com o projeto ao qual pertencem, a data de criação e o nível de faturamento de cada projeto.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Caso seja necessário ampliar os Rate Limits ou utilizar recursos que exigem faturamento, clique em Configurar faturamento, localizado na coluna Nível de faturamento.
Observação: o faturamento é configurado por projeto, e não por chave de API. Assim, todas as chaves vinculadas ao mesmo projeto compartilharão a mesma configuração de faturamento.
Ação: na linha correspondente ao projeto desejado, clique em Configurar faturamento.
Iniciando a configuração do faturamento
Ao clicar em Configurar faturamento, o Google AI Studio exibirá uma tela informando que o faturamento da API Gemini é realizado por meio do Google Cloud Billing.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Isso significa que o Google AI Studio utiliza a infraestrutura de faturamento do Google Cloud Platform para controlar os pagamentos, limites de uso e cobranças da API.
Nesta etapa, verifique se o país informado está correto e clique em Concordar e continuar para prosseguir com a configuração.
Observação: caso ainda não exista uma conta de faturamento configurada para a conta Google utilizada, ela será criada durante as próximas etapas.
Ação: após conferir as informações apresentadas, clique em Concordar e continuar.
Após iniciar a configuração do faturamento, o Google solicitará que o projeto seja vinculado a uma Conta de Faturamento (Billing Account). Caso sua conta Google já possua uma conta de faturamento criada, os dados já serão buscados automaticamente.
Nesta tela também são apresentadas algumas informações sobre os benefícios do faturamento, como o aumento dos Rate Limits, a disponibilidade de recursos adicionais e, quando aplicável, créditos promocionais oferecidos pelo Google Cloud.
Se esta for sua primeira configuração de faturamento no Google Cloud, será necessário clicar em Adicionar nova conta de faturamento para realizar o cadastro.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Observação: a Conta de Faturamento é compartilhada entre os projetos da mesma conta Google. Isso significa que, após criada, ela poderá ser reutilizada em novos projetos, não sendo necessário cadastrá-la novamente.
Ação: caso ainda não possua uma conta de faturamento, clique em Adicionar nova conta de faturamento.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Após conferir ou preencher os dados, clique em Enviar para concluir a configuração da conta de faturamento.
Adquirindo créditos para utilização da API
Após concluir o cadastro da conta de faturamento, o Google solicitará a aquisição de créditos para ativação da conta Pré-paga (Cloud Prepay).
Nesta etapa, será necessário informar o valor da primeira recarga. Atualmente, o Google estabelece um valor mínimo de R$ 60,00 para o pré-pagamento, podendo esse limite ser alterado futuramente pela própria plataforma.
Também será apresentada a opção Recarga automática. Ao habilitá-la, será possível definir um valor mínimo de saldo (por exemplo, R$ 1,00) para que o Google realize automaticamente uma nova recarga, além de informar o valor que será adicionado a cada reposição.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Recomendação: para aplicações em produção, recomenda-se habilitar a Recarga automática e definir um limite baixo para o acionamento (como R$ 1,00). Dessa forma, a aplicação continuará funcionando mesmo quando o saldo de créditos estiver próximo do fim, evitando interrupções no serviço.
Após definir o valor da primeira recarga e configurar a recarga automática, clique em Continuar para prosseguir com o pagamento.
Importante: o modelo Cloud Prepay funciona por meio de créditos antecipados. Todo consumo da API Gemini será descontado desse saldo, e novas recargas serão realizadas automaticamente apenas se a opção Recarga automática estiver habilitada.
Observação: mesmo com a Recarga automática habilitada, recomenda-se acompanhar periodicamente o consumo da API por meio do Google AI Studio. Isso permite identificar aumentos inesperados na utilização, manter um melhor controle dos custos e planejar futuras recargas.
Consultando o saldo de créditos
Após concluir a configuração do faturamento, é possível consultar o saldo de créditos da API Gemini a qualquer momento. Para isso, no menu lateral do Google AI Studio, clique em Faturamento.
Captura de tela do site oficial GEMINI API feita no dia 31/07/2026
Nesta tela serão exibidas informações como:
- Saldo atual de créditos disponível;
- Conta de faturamento vinculada;
- Projetos associados à conta;
- Status da recarga automática;
- Histórico de recargas realizadas.
Dessa forma, é possível acompanhar facilmente quanto ainda resta de crédito disponível para utilização da API.
Importante: os créditos adquiridos para a conta Cloud Prepay não são reembolsáveis, salvo nos casos previstos pela política do Google. Além disso, possuem validade de um ano a partir da data da compra. Recomenda-se acompanhar periodicamente o saldo para evitar a expiração de créditos não utilizados.
→ Para monitorar detalhadamente o consumo da API, interpretar os Rate Limits e acompanhar a utilização dos modelos de IA, consulte também a documentação Monitoramento de Uso da API Gemini.
O modelo de faturamento apresentado durante a configuração pode variar conforme a conta Google e as políticas vigentes da Google. Algumas contas serão configuradas no modelo Pré-pago (Prepay), exigindo a compra de créditos iniciais, enquanto outras poderão utilizar o modelo Pós-pago (Pay as You Go). A própria interface do Google AI Studio informará qual modalidade está disponível para a conta utilizada.
Resumo – Consulta Rápida
- Acesse a documentação oficial da API Gemini e faça login com sua conta Google.
- Clique em Conferir a chave de API.
- No Google AI Studio, clique em Criar chave de API.
- Clique em Criar projeto e informe um nome para o novo projeto.
- Informe um nome para a chave de API e clique em Criar chave.
- Copie a chave de API gerada e armazene-a em um local seguro.
- Retorne ao painel de chaves e clique em Configurar faturamento.
- Caso já possua uma Conta de Faturamento, selecione-a. Caso contrário, clique em Adicionar nova conta de faturamento e realize o cadastro.
- Confirme ou preencha os dados de pagamento solicitados.
- Adquira os créditos iniciais da conta Cloud Prepay (mínimo atual de R$ 60,00).
- Ative a Recarga automática, configure o limite para acionamento (ex.: R$ 1,00) e defina o valor da recarga automática.
- Conclua o pagamento e aguarde a ativação da conta de faturamento.
- Sempre que desejar consultar o saldo disponível, acesse o menu lateral Faturamento.
- Encaminhe a chave de API ao desenvolvedor responsável ou configure-a na aplicação.
Lembretes
- Nunca compartilhe sua chave de API publicamente.
- Os créditos da modalidade Cloud Prepay não são reembolsáveis (salvo exceções previstas pelo Google) e possuem validade de 1 ano.
- Recomenda-se manter a Recarga automática habilitada para evitar interrupções na aplicação.
- Para acompanhar o consumo da API, consulte também a documentação Monitoramento de Uso da API Gemini.
Versão 1.0 • Julho de 2026 — Laura Lopes | CoreDot