Guia da chave de API do Gemini

Chave de API do Gemini grátis: como obter e usar

Chave de API do Gemini grátis no Google AI Studio: veja o que o nível gratuito inclui e use o Gemini sem programar num app de chat no iPhone, Android ou web.

Oriveo TeamPublicado em Atualizado em 9 min de leitura
  • Para usar o Gemini com a sua própria chave e sem código, crie uma chave de API no Google AI Studio (aistudio.google.com/apikey) e cole-a num app de chat com BYOK como o Oriveo. As solicitações passam a ser cobradas — ou contadas nos limites do nível gratuito — no projeto do Google Cloud ao qual a chave pertence.
  • A API do Gemini tem nível gratuito para muitos modelos, incluindo a família Flash, mas o conteúdo do nível gratuito pode ser usado pelo Google para melhorar os produtos dele, e alguns modelos, como o Gemini 3.1 Pro Preview, são só pagos.
  • No nível pago, em 28 de setembro de 2026, o Gemini 3.8 Flash custava $0,75 por milhão de tokens de entrada e $3,75 por milhão de tokens de saída — bem menos de um centavo por mensagem típica de chat, em estimativa.
Oriveo no iPhone: a lista de conversas, com o custo estimado de cada uma à direita.

Como a API do Gemini difere do app Gemini

O Google entrega o Gemini de duas formas. O app Gemini, com o plano gratuito e os planos pagos Google AI, é um produto para consumidor. A API do Gemini é um produto para desenvolvedores: você cria uma chave de API, e um software — incluindo um app de chat que aceita a sua chave — envia solicitações aos modelos Gemini em seu nome.

A API é gerenciada no Google AI Studio e apoiada por um projeto do Google Cloud. A documentação do Google informa que toda chave de API do Gemini está associada a um projeto do Google Cloud, e que o projeto é onde ficam a cobrança, os colaboradores e as permissões. Os limites de taxa são aplicados por projeto, não por chave. O uso pago da API é ativado vinculando uma conta de cobrança do Cloud ao projeto, então não presuma que um plano Google AI de consumidor paga solicitações da API.

Passo 1: crie uma chave de API do Gemini

Criar uma chave leva um minuto e não exige cartão de crédito para o nível gratuito. Se você é novo no AI Studio, ele cria um projeto padrão do Google Cloud e uma chave de API depois que você aceita os termos de serviço.

  • Acesse aistudio.google.com/apikey e entre com a sua conta Google.
  • Aceite os termos de serviço se pedirem; usuários novos recebem um projeto padrão e uma chave automaticamente.
  • Crie uma chave de API, ou copie a que foi criada, e anote a qual projeto ela pertence.
  • Guarde a chave em lugar seguro, como um gerenciador de senhas. Chaves do Gemini em geral começam com "AIza".

Passo 2: decida entre o nível gratuito e o pago

Essa é a decisão que mais importa com o Gemini, porque os dois níveis diferem em mais que preço. A página de preços lista, para cada modelo, se o nível gratuito é "Free of charge" ou "Not available", e também diz como o seu conteúdo é tratado em cada nível.

No nível gratuito, a página de preços do Google diz que o conteúdo é usado para melhorar os produtos dele; no nível pago, diz que o conteúdo não é usado para melhorar os produtos. Se você pretende colar algo pessoal ou confidencial, essa diferença é um motivo para vincular a cobrança mesmo se o seu uso coubesse nos limites gratuitos.

Os limites de taxa também diferem. Um projeto sem cobrança fica no nível gratuito. Vincular uma conta de cobrança ativa o move para o Tier 1, e níveis mais altos vêm do gasto acumulado com o tempo. Os limites variam por modelo, e o Google avisa que são exibidos no AI Studio e se atualizam automaticamente quando o seu nível muda.

Passo 2: decida entre o nível gratuito e o pago
Nível gratuitoNível pago (cobrança vinculada)
Custo por tokenNenhum, para modelos marcados como "Free of charge"Preços públicos por token
Modelos disponíveisMuitos, incluindo Flash; alguns previews Pro não disponíveisTodos os modelos listados
Uso do conteúdo, pela página de preços do GoogleUsado para melhorar os produtos do GoogleNão usado para melhorar os produtos do Google
Limites de taxaLimites do nível gratuito, por projetoTier 1 e acima, por projeto

Quanto custa o Gemini no nível pago

A tabela mostra os preços públicos do nível pago do Google para três modelos atuais em 28 de setembro de 2026, para prompts de até 200.000 tokens, com um custo estimado para uma mensagem típica de 2.000 tokens de entrada e 600 de saída. Repare no preço com data do Gemini 3.8 Flash: o Google listava $0,75 de entrada e $3,75 de saída até 31 de dezembro de 2026, e $1,50 de entrada e $7,50 de saída a partir de 1º de janeiro de 2027.

Para o Gemini 3.8 Flash, a conta é 2.000 × $0,75 / 1.000.000 + 600 × $3,75 / 1.000.000 = $0,00375 — menos de meio centavo. Conversas longas custam mais por mensagem porque os turnos anteriores são reenviados como entrada, e a fatura do Google é o valor final.

Quanto custa o Gemini no nível pago
ModeloEntrada (USD / 1M tokens)Saída (USD / 1M tokens)Nível gratuitoCusto estimado por mensagem típica
Gemini 2.5 Flash-Lite0,100,40Free of chargecerca de $0,0004
Gemini 3.8 Flash0,75 (1,50 a partir de 1º de janeiro de 2027)3,75 (7,50 a partir de 1º de janeiro de 2027)Free of chargecerca de $0,004
Gemini 3.1 Pro Preview2,0012,00Not availablecerca de $0,011

Passo 3: adicione a chave no Oriveo

O Oriveo é um app de chat multimodelo para iPhone, Android e web que usa as suas próprias chaves. O Google Gemini é um dos seus 15 provedores oficiais, na seção de provedores diretos. Os rótulos abaixo são os que o app mostra em português.

Ao continuar, o Oriveo confere a chave perguntando ao Google a que modelos ela tem acesso, e sincroniza essa lista. Se o Google rejeitar a chave, o app avisa na hora, então dá para corrigir antes de conversar.

Passo 3: adicione a chave no Oriveo
PassoiPhoneAndroidWeb
Abrir a lista de provedoresAba ProvedoresAba ProvedoresProvedores na barra lateral
Iniciar a configuraçãoAdicionar provedorAdicionar provedorAdicionar provedor
Escolher o provedorGoogle Gemini, em Provedores diretos de IAGoogle Gemini, em Provedores diretos de IAGoogle Gemini, em Acesso direto a provedores oficiais de AI
Colar a chaveCampo API Key em "Conectar Google Gemini"Campo Chave da API em "Conectar Google Gemini"Campo da chave; "Obtenha sua chave em Gemini" leva ao AI Studio
ConfirmarContinuarContinuarContinuar

Passo 4: escolha um modelo e converse

Depois de conectar, os modelos Gemini aparecem no seletor de modelos. Os modelos Flash são rápidos e baratos e cobrem a maior parte do chat do dia a dia; os modelos Pro são para raciocínios mais difíceis e análises longas. Se a sua chave está no nível gratuito, fique nos modelos que a página de preços marca como gratuitos, porque os modelos só pagos retornam erro sem cobrança vinculada.

Dá para trocar para outro modelo no meio da conversa, inclusive um modelo de outro provedor conectado, e seguir na mesma conversa. Cada mensagem mostra um custo estimado pelo preço publicado do Google; no nível gratuito, lembre que a cobrança real dos modelos gratuitos é zero e o limite é o de taxa.

Erros comuns e o que significam

Os erros do Gemini costumam ser específicos o bastante para apontar a causa.

  • "API key not valid" (a chave de API não é válida): a chave foi copiada incompleta, apagada ou restrita. Copie de novo no AI Studio ou crie outra.
  • Limite de taxa ou recurso esgotado: você bateu no limite por minuto ou por dia do projeto para aquele modelo. Espere, troque de modelo, ou vincule a cobrança para limites maiores.
  • Modelo não disponível no seu nível: alguns modelos são só pagos. Vincule a cobrança ao projeto ou escolha um modelo gratuito.
  • Várias chaves batendo nos limites juntos: os limites são por projeto, então chaves no mesmo projeto os compartilham.

Como manter a sua chave segura

Uma chave do Gemini pode gastar dinheiro depois que a cobrança é vinculada, e pode consumir a sua cota gratuita até antes disso. O Oriveo guarda as chaves dos provedores no seu aparelho ou no seu navegador, em vez de como registros de conta. Os apps de iPhone e Android enviam as solicitações direto ao Google; o app web envia as solicitações por um repasse em tempo real no servidor do Oriveo: a chave é usada só naquela solicitação e não é salva como registro da conta, e as conversas BYOK não são guardadas como logs de chat. O Oriveo não cobra acréscimo sobre os preços do Google.

Use um projeto ou chave dedicados para o app de chat, revise o uso no AI Studio e no console do Cloud, e apague qualquer chave que tenha sido exposta.

Perguntas frequentes

A API do Gemini é gratuita?
Em parte. Muitos modelos do Gemini têm um nível gratuito dentro dos limites de taxa, mas alguns modelos, como o Gemini 3.1 Pro Preview, são só pagos. A página de preços do Google também diz que o conteúdo do nível gratuito é usado para melhorar os produtos, enquanto o do nível pago não é.
Onde consigo uma chave de API do Gemini?
No Google AI Studio, em aistudio.google.com/apikey. Usuários novos recebem um projeto padrão do Google Cloud e uma chave depois de aceitar os termos. Toda chave pertence a um projeto do Cloud, que concentra cobrança e limites de taxa.
A minha assinatura Google AI Pro cobre o uso da API do Gemini?
Não presuma que sim. Os planos Google AI de consumidor cobrem o app Gemini, enquanto o uso pago da API do Gemini é ativado vinculando uma conta de cobrança do Cloud ao projeto da sua chave. Confira a cobrança do projeto no AI Studio.
Quanto custa o Gemini com a minha própria chave?
No nível pago, em 28 de setembro de 2026, o Gemini 3.8 Flash custava $0,75 por milhão de tokens de entrada e $3,75 por milhão de tokens de saída até 31 de dezembro de 2026, ou cerca de $0,004 por mensagem típica de chat, em estimativa.
Posso usar uma chave de API do Gemini no iPhone e no Android?
Sim. No Oriveo, abra Provedores, toque em Adicionar provedor, escolha Google Gemini, cole a chave e continue. Os apps nativos enviam as solicitações direto ao Google, e a mesma chave também funciona no app web.

Leituras relacionadas

Use o Gemini com a sua própria chave

Adicione a sua chave Gemini ao Oriveo no iPhone, no Android ou na web, alterne entre o Gemini e mais de 700 outros modelos e veja um custo estimado em cada mensagem.