Inicio / Guías / Gemini CLI con un endpoint personalizado y modelos gratuitos

Gemini CLI con un endpoint personalizado y modelos gratuitos

Gemini CLI es el agente de programación de código abierto de Google para la terminal. Puede enviar sus solicitudes a una URL base personalizada. Esta guía apunta Gemini CLI a FreeLLMAPI, que sirve la API nativa de Gemini en /v1beta. Así, sus solicitudes van a su conjunto de proveedores gratuitos, que puede incluir claves gratuitas de la API de Gemini.

El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.

El cambio de 2026 en el nivel gratuito de Gemini CLI

Lea esto primero. Google cambió el uso gratuito de Gemini CLI en 2026. La página de cuotas de Gemini CLI dice: "Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026."

El anuncio de Google indica que Gemini CLI sigue disponible con claves de pago de la API de Gemini y para clientes empresariales.

  • Inicio de sesión con Google en el nivel gratuito: ya no lo sirve Gemini CLI para cuentas de consumidor.
  • Clave de la API de Gemini con una URL base personalizada: la referencia de configuración de Gemini CLI sigue documentando GOOGLE_GEMINI_BASE_URL. Con esta variable, Gemini CLI envía sus solicitudes a la URL que usted define, no a Google.
  • Claves gratuitas de la API de Gemini: Google AI Studio sigue ofreciendo un nivel gratuito para la API de Gemini. FreeLLMAPI puede usar esas claves, junto con claves de otros proveedores.

Esta guía usa el segundo método. FreeLLMAPI responde a las solicitudes y envía cada una a un modelo gratuito de su conjunto.

Paso 1: Instalar FreeLLMAPI y Gemini CLI

Instalar los dos

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

Abra http://localhost:3001. Añada al menos dos claves de proveedores gratuitos en la página Keys. Una clave gratuita de Google AI Studio es una buena primera clave. Copie su clave unificada desde la misma página.

Paso 2: Apuntar Gemini CLI a la pasarela

Defina dos variables de entorno e inicie Gemini CLI. La URL base es el origen del servidor, sin /v1beta. Gemini CLI añade la ruta de la API por sí solo.

macOS o 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

Cuando Gemini CLI pida un método de autenticación, seleccione Use Gemini API key. Para guardar la elección, defínala en ~/.gemini/settings.json:

~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
Importante: use GEMINI_API_KEY. Un problema de Gemini CLI indica que la versión 0.44.x falla con "Invalid auth method selected" cuando se usa GOOGLE_API_KEY con GOOGLE_GEMINI_BASE_URL. Si GOOGLE_API_KEY está definida, elimínela con unset GOOGLE_API_KEY.

Paso 3: Asignar los nombres de modelo de Gemini a modelos gratuitos

Gemini CLI pide nombres de modelos de Gemini, por ejemplo gemini-2.5-flash. FreeLLMAPI no envía estos nombres directamente a Google. Los resuelve con el mapa de familias de Gemini en la pestaña Keys, Agents. Asigne cada familia (Pro, Flash y Flash-Lite) a Auto o a un modelo fijo del catálogo.

  • Con Auto, el enrutador selecciona un modelo gratuito para cada solicitud. Cuando un proveedor envía un error 429, prueba el siguiente.
  • Los IDs del catálogo también funcionan como nombres de modelo. Inicie Gemini CLI con gemini -m <catalog-id>, o defina GEMINI_MODEL.
  • Gemini CLI es un agente con herramientas. Asigne las familias a modelos con llamadas a herramientas y una ventana de contexto grande.

La primera tabla muestra los modelos gratuitos de Gemini que hay hoy en el catálogo. La segunda tabla muestra otros modelos gratuitos que puede asignar a una familia de Gemini.

Modelos gratuitos de la API de Gemini con llamadas a herramientas (Google AI Studio)
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSíSí
Gemini Flash (latest alias)Google AI Studio-10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.7 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.6 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.5 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.8 LiveGoogle AI Studio-10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.5 Flash LiteGoogle AI Studio1M15 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí

Se muestran 8 de 14 modelos gratuitos que coinciden. Ver todos los modelos.

Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.

Otros modelos gratuitos para Gemini CLI: llamadas a herramientas y contexto de 128K o más
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
GLM 5.3UnoRouter1M1 solicitudes/min
1 req/min per model
SíNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 solicitudes/min
40 RPM
SíSí
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSíNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSíSí
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSíSí
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 solicitudes/min
50 solicitudes/día
50 req/day account-wide (1,000 after a $10 purchase)
SíSí
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 solicitudes/min
50 solicitudes/día
Shared rate limit
SíNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 solicitudes/min
250 solicitudes/día
70,000 tokens/min
~6M
SíSí

Se muestran 8 de 104 modelos gratuitos que coinciden. Ver todos los modelos.

Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.

Límites del nivel gratuito de Gemini

La página de límites de velocidad de Google indica que los límites se aplican por proyecto, no por clave de API. Más claves en un mismo proyecto no dan más cuota. Google también indica que los límites no están garantizados y que puede ver sus límites actuales en Google AI Studio. Los modelos en vista previa tienen límites más bajos.

Una clave gratuita de Gemini Flash permite pocas solicitudes al día. Una tarea de Gemini CLI puede enviar muchas solicitudes. Añada claves de otros proveedores, para que el enrutador pueda continuar cuando se agote la cuota de Gemini. La superficie nativa admite generateContent, streamGenerateContent con ?alt=sse, countTokens y la lista de modelos.

FreeLLMAPI acepta la clave en la cabecera x-goog-api-key, como token Bearer o en el parámetro de consulta ?key= de Gemini. Prefiera una cabecera, porque una clave en una URL puede quedar en el historial de la shell y en los registros del proxy.

Solución de problemas

ProblemaCausaSolución
Gemini CLI abre un inicio de sesión de GoogleEl tipo de autenticación no está definido como Gemini API keySeleccione Use Gemini API key, o defina security.auth.selectedType
"Invalid auth method selected"Se usa GOOGLE_API_KEY con una URL base personalizadaUse GEMINI_API_KEY y elimine GOOGLE_API_KEY
Las solicitudes van a Google, no a la pasarelaGOOGLE_GEMINI_BASE_URL no está definida en esta shellExporte la variable y después inicie gemini de nuevo
404 en las llamadas al modeloLa URL base incluye /v1betaUse solo el origen http://localhost:3001
Fallan las llamadas a herramientasLa familia de Gemini se asigna a un modelo con llamadas a herramientas débilesAsigne la familia a un modelo de las tablas anteriores
Mensaje "All models rate-limited after N attempts"Todas las claves están en su límiteAñada claves de más proveedores, o espere a que terminen los tiempos de espera
Use cada uno de estos modelos con una sola clave. FreeLLMAPI es un enrutador de código abierto y autoalojado. Reúne todos estos niveles gratuitos detrás de un único endpoint compatible con OpenAI y cambia de proveedor cuando uno alcanza su límite. Explore el catálogo o ir en vivo.

Preguntas frecuentes

¿Sigue siendo gratuito Gemini CLI?

Google terminó el uso gratuito de Gemini CLI con inicio de sesión de Google para usuarios sin pago y de Google One el 18 de junio de 2026. La CLI sigue admitiendo una URL base personalizada, así que puede funcionar con una pasarela gratuita como FreeLLMAPI.

¿Cómo uso Gemini CLI con un endpoint personalizado?

Defina GOOGLE_GEMINI_BASE_URL con el origen del endpoint y GEMINI_API_KEY con su clave, y después seleccione Use Gemini API key. El endpoint debe hablar la API nativa de Gemini en /v1beta.

¿Puede Gemini CLI usar modelos que no son de Gemini?

Sí, a través de FreeLLMAPI. La pasarela asigna los nombres de familia Gemini Pro, Flash y Flash-Lite a Auto o a cualquier modelo del catálogo, por ejemplo un modelo Qwen o GLM.

¿Cuáles son los límites del nivel gratuito de la API de Gemini?

Google fija los límites por proyecto, no por clave, y muestra los valores actuales en Google AI Studio. La tabla de esta página muestra los modelos gratuitos de Gemini de hoy y sus límites, según el catálogo de FreeLLMAPI.

¿Por qué aparece "Invalid auth method selected"?

Un problema de Gemini CLI informa de este error en la versión 0.44.x cuando se usa GOOGLE_API_KEY con GOOGLE_GEMINI_BASE_URL. Use GEMINI_API_KEY y elimine GOOGLE_API_KEY.

Guías relacionadas

Fuentes

Todas las guías · Ver todos los modelos gratuitos