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-cliAbra 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>
geminiWindows PowerShell
$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
geminiCuando 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"
}
}
}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 definaGEMINI_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.
| Modelo | Gratis en | Contexto | Límites gratuitos (mejor oferta) | Herramientas | Visión |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sí | 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 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.8 Live | Google AI Studio | - | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 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.
| Modelo | Gratis en | Contexto | Límites gratuitos (mejor oferta) | Herramientas | Visión |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 solicitudes/min 1 req/min per model | Sí | No |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 solicitudes/min 40 RPM | Sí | Sí |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sí | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 solicitudes/min 50 solicitudes/día 50 req/day account-wide (1,000 after a $10 purchase) | Sí | Sí |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 solicitudes/min 50 solicitudes/día Shared rate limit | Sí | No |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 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
| Problema | Causa | Solución |
|---|---|---|
| Gemini CLI abre un inicio de sesión de Google | El tipo de autenticación no está definido como Gemini API key | Seleccione Use Gemini API key, o defina security.auth.selectedType |
| "Invalid auth method selected" | Se usa GOOGLE_API_KEY con una URL base personalizada | Use GEMINI_API_KEY y elimine GOOGLE_API_KEY |
| Las solicitudes van a Google, no a la pasarela | GOOGLE_GEMINI_BASE_URL no está definida en esta shell | Exporte la variable y después inicie gemini de nuevo |
404 en las llamadas al modelo | La URL base incluye /v1beta | Use solo el origen http://localhost:3001 |
| Fallan las llamadas a herramientas | La familia de Gemini se asigna a un modelo con llamadas a herramientas débiles | Asigne 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ímite | Añada claves de más proveedores, o espere a que terminen los tiempos de espera |
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
- free gemini api
- Cuota de la API de Gemini superada (429 RESOURCE_EXHAUSTED)
- Cómo usar Claude Code gratis
- Use Codex CLI con modelos gratuitos
- Mejores API gratuitas de modelos para programar
Fuentes
- Gemini CLI docs: configuration reference (revisado 20 November 2026)
- Gemini CLI docs: authentication (revisado 20 November 2026)
- Gemini CLI docs: quota and pricing (revisado 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (revisado 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (revisado 20 November 2026)
- Google AI Studio: rate limits (revisado 20 November 2026)
- FreeLLMAPI docs: native Gemini API (revisado 20 November 2026)