El nivel gratuito de la API de Gemini todavía existe en octubre de 2026, pero es más limitado de lo que solía ser. Puedes llamar a Gemini 3.8 Flash, 3.6 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite, Gemma 4 y varios modelos de audio y de embeddings por $0, sin cuenta de facturación. Gemini 4 Argon, los modelos de imagen y los modelos de video son solo de pago. Google ya no publica cifras de RPM y RPD por modelo en su documentación, y solo se te factura después de vincular una cuenta de facturación y prepagar al menos $5.
Todos los datos a continuación provienen de la página de precios, la página de límites de velocidad, la guía de facturación y los términos de la API de Gemini de Google, consultadas el 22 de octubre de 2026. ¿Todavía necesitas una clave? Nuestra guía para obtener una clave de API de Gemini gratuita cubre ese paso.
¿La API de Gemini es gratuita?
Sí, en parte. El nivel gratuito de la API de Gemini ofrece a todos los proyectos de Google AI Studio tokens de entrada y salida gratuitos en modelos seleccionados, sin tarjeta y sin cuenta de facturación. Google lo describe como "Acceso limitado a ciertos modelos". A cambio, Google puede usar tus prompts y respuestas para mejorar sus productos, y tus límites de velocidad son más bajos que en los niveles de pago.
Tres reglas lo definen:
- Lo gratuito es por modelo. La columna Nivel gratuito de cada modelo indica "Sin cargo" o "No disponible".
- Los límites son por proyecto. Se aplican "por proyecto, no por clave de API", así que cinco claves en un proyecto no te dan cinco veces la cuota.
- La facturación lo desactiva. Un proyecto vinculado a una cuenta de facturación está en un nivel de pago, y cada token se mide.
Qué modelos están en el nivel gratuito de la API de Gemini
Esta es la columna Nivel gratuito para solicitudes Estándar el 22 de octubre de 2026, con los precios de pago por 1M de tokens.
| Modelo | ID del modelo | Nivel gratuito | Entrada / salida de pago |
|---|---|---|---|
| Gemini 4 Argon | gemini-4-argon |
No disponible | $2 / $10 hasta el 30 de nov. de 2026, luego $4 / $20 |
| Gemini 3.8 Flash | gemini-3.8-flash |
Sin cargo | $0.75 / $3.75 hasta el 31 de dic. de 2026, luego $1.50 / $7.50 |
| Gemini 3.6 Flash | gemini-3.6-flash |
Sin cargo | $0.75 / $3.75 hasta el 31 de dic. de 2026 |
| Gemini 3.5 Flash-Lite | gemini-3.5-flash-lite |
Sin cargo | $0.30 / $2.50 |
| Gemini 3.1 Flash-Lite | gemini-3.1-flash-lite |
Sin cargo | $0.25 / $1.50 |
| Gemini 3.1 Pro Preview | gemini-3.1-pro-preview |
No disponible | $2 / $12 (prompts de hasta 200K) |
| Gemma 4 | gemma-4-31b-it, gemma-4-26b-a4b-it |
Sin cargo | Sin nivel de pago |
| Nano Banana 2.1 y Pro | gemini-nano-banana-2.1, gemini-3-pro-image |
No disponible | Solo de pago |
| Gemini Omni Flash (video) | gemini-omni-1.1-flash |
No disponible | Solo de pago |
El audio sale mejor parado: Gemini 3.8 Live, 3.8 Flash TTS, 3.5 Transcribe y Gemini Embedding 2 incluyen entrada y salida gratuitas.
Argon tiene su propia nota en la página de precios: "Gemini 4 Argon no está disponible en el nivel gratuito". Nuestro desglose de precios de Gemini 4 Argon cubre sus tarifas de pago y el cambio de precio del 1 de diciembre.
Ojo también con los modelos 2.5. La página de modelos dice que Google está "limitando el acceso a los modelos 2.5 a los usuarios que los han usado activamente en el pasado". Gemini 2.5 Pro y 2.5 Flash siguen mostrando "Sin cargo", pero puede que un proyecto nuevo no llegue a ellos. Google dirige el trabajo nuevo a 3.5 Flash-Lite o 3.8 Flash.
Límites del nivel gratuito de la API de Gemini: lo que Google publica ahora
Google publica las reglas, no los números. La página de límites de velocidad ya no incluye una tabla de RPM, TPM y RPD por modelo. Te remite a la vista de límites de velocidad en Google AI Studio, que muestra los límites activos de tu propio proyecto.
Lo que sí indica la página:
- Tres dimensiones: solicitudes por minuto (RPM), tokens de entrada por minuto (TPM) y solicitudes por día (RPD). Algunos modelos añaden tokens por día o imágenes por minuto.
- Basta con superar un límite: "Si tu límite de RPM es 20, hacer 21 solicitudes en un minuto dará como resultado un error, incluso si no has superado tu TPM u otros límites."
- Reinicio diario: las cuotas de RPD se restablecen a la medianoche, hora del Pacífico.
- Las versiones preliminares son más estrictas: "Los límites de velocidad son más restrictivos para los modelos experimentales y preliminares."
- Sin garantía: "Los límites de velocidad especificados no están garantizados y la capacidad real puede variar."
Los modelos gratuitos también omiten algunas funciones:
| Función | Nivel gratuito | Nivel de pago |
|---|---|---|
| Grounding con la Búsqueda de Google | No disponible (algunos modelos indican que "se puede probar en Google AI Studio") | 5,000 solicitudes/mes gratis en los modelos Gemini 3+, luego $14 por 1,000 |
| API de lotes y Flex | No disponible | La mitad del precio Estándar en 3.8 Flash |
| Almacenamiento en caché de contexto | Gratis en 3.8 Flash y 3.6 Flash; no en 3.5 o 3.1 Flash-Lite | Medido, más almacenamiento por hora |
Comprueba tus números reales en AI Studio antes de diseñar una política de reintentos. Cuando alcanzas un techo, la API responde 429 RESOURCE_EXHAUSTED; nuestra guía sobre usar Gemini 3.8 Flash gratis muestra el retroceso para los modelos Flash.
Lo que te cuesta el nivel gratuito: tus datos
El nivel gratuito es gratis en dólares, no en datos. Los términos consideran la "cuota no pagada en la API de Gemini" como un Servicio no pagado, y para ellos Google "utiliza el contenido que envías a los Servicios y cualquier respuesta generada para proporcionar, mejorar y desarrollar productos de Google". Añaden: "revisores humanos pueden leer, anotar y procesar tu entrada y salida de la API".
Así que mantén los registros de clientes, los secretos y cualquier cosa bajo NDA fuera de una clave del nivel gratuito.
Se aplican dos reglas regionales en el Espacio Económico Europeo, Suiza y el Reino Unido:
- Los términos de datos del servicio de pago cubren todo allí, "incluidos Google AI Studio y la cuota no pagada en la API de Gemini".
- "Solo puedes usar los Servicios de pago al poner Clientes de API a disposición de los usuarios" en esas regiones. Una clave gratuita sirve para tus propias pruebas, no para un producto que atienda a esos usuarios.
Cuándo se te factura en la API de Gemini
Solo se te factura después de actualizar un proyecto. Un proyecto del nivel gratuito no tiene cuenta de facturación, así que nada en él se convierte en un cargo. La guía de facturación describe el camino:
- Configura la facturación en AI Studio. En la página de Proyectos o de claves de API, haz clic en "Configurar facturación" en el proyecto que quieras actualizar.
- Prepaga al menos $5. Los usuarios nuevos usan Prepago de forma predeterminada: compras créditos (mínimo $5, máximo $5,000) y el uso se descuenta casi en tiempo real. A algunas cuentas se les ofrece Postpago en su lugar.
- Llegas al Nivel 1. Una cuenta de facturación activa te sitúa en el Nivel 1, normalmente de inmediato, con un tope mensual de $250 y un límite de gasto de $10 por cada 10 minutos móviles.
- Subes de nivel según el gasto. El Nivel 2 requiere $100 pagados más 3 días desde tu primer pago (tope de $2,000). El Nivel 3 requiere $1,000 más 30 días (tope de $20,000 a $100,000+). El gasto en cualquier servicio de Google Cloud cuenta.
Lo que suele sorprender a la gente:
- El crédito de $300 de Google Cloud no cubre Gemini. "A partir de marzo de 2026, los costos de uso de la API de Gemini están específicamente excluidos del programa de prueba gratuita de $300 de Google Cloud".
- Los créditos caducan. Los créditos de prepago no usados caducan después de 12 meses y no son reembolsables, salvo cuando cambias a Postpago.
- Con $0, todo se detiene. "Todas las claves de API en todos los proyectos vinculados a esa cuenta de facturación dejarán de funcionar simultáneamente", con HTTP 402 hasta que recargues.
- Los excesos se cuelan. La facturación tiene un retraso de unos 10 minutos, así que los trabajos por lotes y los agentes "pueden seguir consumiendo créditos más allá de tu saldo".
- Las solicitudes fallidas son gratis pero cuentan. Un 400 o un 500 no se cobra, "sin embargo, la solicitud seguirá contando para tu cuota".
Una configuración limpia son dos proyectos: uno gratuito para experimentos y uno de pago con un límite de gasto del proyecto para el tráfico real.
Haz tu primera llamada gratuita a la API de Gemini
Con una clave de un proyecto del nivel gratuito, esta llamada REST a Gemini 3.8 Flash cuesta $0:
export GEMINI_API_KEY="your-free-tier-key"
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{"contents": [{"parts": [{"text": "Explain HTTP 429 in one sentence."}]}]}'
Un 200 con texto en candidates[0].content.parts[0].text significa que el nivel gratuito te atendió. No esperes que la misma clave responda para gemini-4-argon: Argon necesita un proyecto de pago. Mantén la clave en una variable de entorno, nunca en un commit.
Deja que tu agente de programación lo pruebe con Apidog CLI
Olvídate de comprobar los IDs de modelo y los límites a mano. Con Apidog CLI, Claude Code, Codex, Cursor u OpenCode pueden escribir un caso de prueba para el endpoint de Gemini, ejecutarlo con tu clave gratuita e informar de cualquier 429.
Configúralo una vez:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
Luego dale a tu agente un prompt:
In Apidog project <projectId>, create an environment "gemini-free" with base URL
https://generativelanguage.googleapis.com. Add a test case for
POST /v1beta/models/gemini-3.8-flash:generateContent with header
x-goog-api-key = {{GEMINI_API_KEY}} that asserts status 200 and non-empty
candidates[0].content.parts[0].text. Run it 5 times, 1 second apart, and
tell me if any run returned 429.
El agente lee el esquema de la carga útil, valida su JSON y luego crea y ejecuta el caso:
apidog environment create gemini-free --project <projectId> --base-url https://generativelanguage.googleapis.com
apidog cli-schema get test-case-create
apidog test-case category --project <projectId>
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
--env-var "GEMINI_API_KEY=$GEMINI_API_KEY" -n 5 --delay-request 1000 -r cli,json
Mantén -n pequeño: cada iteración cuenta para tus RPM y RPD. La misma línea apidog run con -r junit se integra en CI; nuestro tutorial de Apidog CLI en Claude Code muestra el ciclo completo. El plan gratuito de Apidog admite hasta 4 usuarios, así que un equipo pequeño puede compartir el proyecto.
Preguntas frecuentes
¿El nivel gratuito de la API de Gemini es gratis para siempre? Google no promete una fecha de finalización. La página de precios indica "Sin cargo" por modelo hoy, y no todos los modelos lo tienen: Argon y los modelos de imagen son solo de pago. Vuelve a consultar la página antes de planificar en función de ella.
¿El nivel gratuito de la API de Gemini necesita tarjeta de crédito? No. Su único requisito es "un proyecto activo o una prueba gratuita". Añades una tarjeta cuando configuras la facturación y prepagas al menos $5.
¿Cuáles son los límites del nivel gratuito de la API de Gemini por modelo? Google dejó de publicarlos en la documentación. Tus RPM, TPM y RPD activos por modelo están en la página de límites de velocidad de tu proyecto en AI Studio, y el RPD se restablece a la medianoche, hora del Pacífico.
¿Puedo usar Gemini 4 Argon gratis a través de la API? No. "Gemini 4 Argon no está disponible en el nivel gratuito". Nuestra guía de acceso gratuito a Gemini 4 Argon cubre las rutas fuera de la API.
¿El crédito de $300 de Google Cloud pagará las llamadas a la API de Gemini? No para las cuentas abiertas después del 2 de marzo de 2026. El uso de la API de Gemini está excluido de la prueba gratuita de $300, aunque el crédito sigue funcionando en otros productos de Google Cloud.
¿Cómo vuelvo al nivel gratuito después de actualizar? Desvincula el proyecto de su cuenta de facturación. Vuelve al nivel gratuito y a su conjunto de modelos del nivel gratuito.