Início / Guias / Gemini CLI com endpoint personalizado e modelos gratuitos

Gemini CLI com endpoint personalizado e modelos gratuitos

O Gemini CLI é o agente de programação de código aberto do Google para o terminal. Ele pode enviar as suas requisições para uma URL base personalizada. Este guia aponta o Gemini CLI para o FreeLLMAPI, que serve a API nativa do Gemini em /v1beta. Assim, as suas requisições vão para o seu conjunto de camadas gratuitas, que pode incluir chaves gratuitas da API Gemini.

O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.

A mudança de 2026 no plano gratuito do Gemini CLI

Leia isto primeiro. O Google mudou o uso gratuito do Gemini CLI em 2026. A página de cotas do Gemini CLI diz: "Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026."

O anúncio do Google diz que o Gemini CLI continua disponível com chaves pagas da API Gemini e para clientes corporativos.

  • Login Google no plano gratuito: não é mais atendido pelo Gemini CLI para contas de consumidor.
  • Chave da API Gemini com URL base personalizada: a referência de configuração do Gemini CLI ainda documenta GOOGLE_GEMINI_BASE_URL. Com esta variável, o Gemini CLI envia as requisições para a URL que você definir, e não para o Google.
  • Chaves gratuitas da API Gemini: o Google AI Studio ainda lista uma camada gratuita para a API Gemini. O FreeLLMAPI pode usar essas chaves, junto com chaves de outros provedores.

Este guia usa o segundo método. O FreeLLMAPI responde às requisições e envia cada uma para um modelo gratuito do seu conjunto.

Etapa 1: instale o FreeLLMAPI e o Gemini CLI

Instalar os dois

curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cli

Abra http://localhost:3001. Adicione pelo menos duas chaves gratuitas de provedores na página Keys. Uma chave gratuita do Google AI Studio é uma boa primeira chave. Copie a sua chave unificada na mesma página.

Etapa 2: aponte o Gemini CLI para o gateway

Defina duas variáveis de ambiente e inicie o Gemini CLI. A URL base é a origem do servidor, sem /v1beta. O Gemini CLI adiciona o caminho da API por conta própria.

macOS ou Linux

export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
gemini

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
gemini

Quando o Gemini CLI pedir um método de autenticação, selecione Use Gemini API key. Para salvar a escolha, defina-a em ~/.gemini/settings.json:

~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
Importante: use GEMINI_API_KEY. Um issue do Gemini CLI relata que a versão 0.44.x falha com "Invalid auth method selected" quando GOOGLE_API_KEY é usada com GOOGLE_GEMINI_BASE_URL. Se GOOGLE_API_KEY estiver definida, remova-a com unset GOOGLE_API_KEY.

Etapa 3: mapeie os nomes de modelos do Gemini para modelos gratuitos

O Gemini CLI pede nomes de modelos do Gemini, por exemplo gemini-2.5-flash. O FreeLLMAPI não envia esses nomes diretamente ao Google. Ele os resolve pelo mapa de famílias do Gemini, na aba Keys, Agents. Mapeie cada família (Pro, Flash e Flash-Lite) para Auto ou para um modelo fixo do catálogo.

  • Com Auto, o roteador escolhe um modelo gratuito para cada requisição. Quando um provedor envia um erro 429, ele tenta o próximo.
  • IDs do catálogo também funcionam como nomes de modelos. Inicie o Gemini CLI com gemini -m <catalog-id>, ou defina GEMINI_MODEL.
  • O Gemini CLI é um agente com ferramentas. Mapeie as famílias para modelos com chamada de ferramentas e uma janela de contexto grande.

A primeira tabela mostra os modelos gratuitos do Gemini no catálogo de hoje. A segunda tabela mostra outros modelos gratuitos que você pode mapear para uma família do Gemini.

Modelos gratuitos da API Gemini com chamada de ferramentas (Google AI Studio)
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSimSim
Gemini Flash (latest alias)Google AI Studio-10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.5 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.8 LiveGoogle AI Studio-10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Gemini 3.5 Flash LiteGoogle AI Studio1M15 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim

Mostrando 8 de 14 modelos gratuitos correspondentes. Ver todos os modelos.

Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.

Outros modelos gratuitos para o Gemini CLI: chamada de ferramentas e contexto de 128K ou mais
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
SimNão
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
SimSim
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSimNão
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSimSim
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSimSim
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimSim
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/dia
Shared rate limit
SimNão
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/dia
70,000 tokens/min
~6M
SimSim

Mostrando 8 de 104 modelos gratuitos correspondentes. Ver todos os modelos.

Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.

Limites do plano gratuito do Gemini

A página de limites de taxa do Google diz que os limites se aplicam por projeto, e não por chave de API. Mais chaves em um mesmo projeto não dão mais cota. O Google também diz que os limites não são garantidos e que você pode ver os seus limites atuais no Google AI Studio. Modelos em preview têm limites menores.

Uma chave gratuita do Gemini Flash permite poucas requisições por dia. Uma tarefa do Gemini CLI pode enviar muitas requisições. Adicione chaves de outros provedores, para que o roteador continue quando a cota do Gemini acabar. A superfície nativa aceita generateContent, streamGenerateContent com ?alt=sse, countTokens e a lista de modelos.

O FreeLLMAPI aceita a chave no cabeçalho x-goog-api-key, como token Bearer ou no parâmetro de consulta ?key= do Gemini. Prefira o cabeçalho, porque uma chave em URL pode vazar para o histórico do shell e para os logs de proxy.

Solução de problemas

ProblemaCausaSolução
O Gemini CLI abre um login GoogleO tipo de autenticação não está definido como chave da API GeminiSelecione Use Gemini API key, ou defina security.auth.selectedType
"Invalid auth method selected"GOOGLE_API_KEY é usada com uma URL base personalizadaUse GEMINI_API_KEY e remova GOOGLE_API_KEY com unset
As requisições vão para o Google, não para o gatewayGOOGLE_GEMINI_BASE_URL não está definida neste shellExporte a variável e inicie gemini de novo
404 nas chamadas de modeloA URL base inclui /v1betaUse somente a origem http://localhost:3001
Chamadas de ferramentas falhamA família do Gemini aponta para um modelo com chamada de ferramentas fracaMapeie a família para um modelo das tabelas acima
"All models rate-limited after N attempts" (mensagem em inglês)Todas as chaves estão no limiteAdicione chaves de mais provedores, ou espere os períodos de espera
Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produção.

Perguntas frequentes

O Gemini CLI ainda é gratuito?

O Google encerrou o uso gratuito do Gemini CLI com login Google para usuários sem plano pago e usuários do Google One, em 18 de junho de 2026. A CLI ainda aceita uma URL base personalizada, então pode rodar em um gateway gratuito como o FreeLLMAPI.

Como uso o Gemini CLI com um endpoint personalizado?

Defina GOOGLE_GEMINI_BASE_URL como a origem do endpoint e GEMINI_API_KEY como a chave dele, depois selecione Use Gemini API key. O endpoint precisa falar a API nativa do Gemini em /v1beta.

O Gemini CLI pode usar modelos que não são do Gemini?

Sim, por meio do FreeLLMAPI. O gateway mapeia os nomes das famílias Gemini Pro, Flash e Flash-Lite para Auto ou para qualquer modelo do catálogo, por exemplo um modelo Qwen ou GLM.

Quais são os limites do plano gratuito da API Gemini?

O Google define os limites por projeto, e não por chave, e mostra os valores atuais no Google AI Studio. A tabela desta página mostra os modelos gratuitos do Gemini de hoje e os limites deles, a partir do catálogo do FreeLLMAPI.

Por que recebo 'Invalid auth method selected'?

Um issue do Gemini CLI relata este erro na versão 0.44.x quando GOOGLE_API_KEY é usada com GOOGLE_GEMINI_BASE_URL. Use GEMINI_API_KEY e remova GOOGLE_API_KEY com unset.

Guias relacionados

Fontes

Todos os guias · Ver todos os modelos gratuitos