Gemini API: errores de restricciones regionales, nivel gratuito y permisos de la clave de API
MarkdownCómo distinguir 403 Access Restricted, 400 FAILED_PRECONDITION y 403 PERMISSION_DENIED por el texto del error y las condiciones aplicables.
Leer el artículo completo
Pero no todos los errores de Gemini tienen que ver con tu región. Uno se refiere al nivel gratuito y otro a la propia clave de API. Y para programar, Gemini me parece un poco corto, aunque le he dado una segunda oportunidad más de una vez.
Te explicaré cómo identificar lo ocurrido a partir del mensaje de error y qué usar en lugar de Gemini. Vamos allá.
Para obtener información sobre el uso del servicio, consulta la documentación de Ailoot.
Punto clave
403 Access Restricted significa que se han incumplido las condiciones de acceso. 400 FAILED_PRECONDITION significa que el nivel gratuito no está disponible en el país. 403 PERMISSION_DENIED con un mensaje sobre los permisos de la clave significa que se está usando una clave incorrecta. Para programar, usa Claude Code; si no te funciona, prueba Codex y, después, Qwen o DeepSeek.
¿Cómo comprobar las regiones compatibles con Gemini?
Google mantiene una página aparte con la lista de lugares donde funcionan Gemini API y Google AI Studio:
The Gemini API and Google AI Studio are available in the following countries and territories. If you're not in one of these countries or territories, try the Gemini API in Gemini Enterprise Agent Platform
Traducción: «Gemini API y Google AI Studio están disponibles en los siguientes países y territorios. Si no estás en uno de ellos, prueba Gemini API en Gemini Enterprise Agent Platform».
La lista contiene 230 entradas, desde Albania hasta las islas Åland. Gemini Enterprise Agent Platform es una plataforma de Google Cloud.
Si te redirigen a esta página en lugar de AI Studio, Google indica 3 motivos: tu región, ser menor de 18 años y no tener la edad verificada en tu cuenta de Google.
403 Access Restricted: ¿qué tiene que ver tu región?
Google lo describe así:
If you see a 403 Access Restricted error, you are using Google AI Studio in a way that does not follow the Terms of Service. One common reason is you are not located in a supported region.
Traducción: «Si ves un error 403 Access Restricted, estás usando Google AI Studio de una forma que incumple las condiciones del servicio. Un motivo frecuente es que no te encuentres en una región compatible».
Tu región es una de las 4 comprobaciones. Las otras 3 son:
- la solicitud debe superar las comprobaciones de seguridad automatizadas;
- debes aceptar las condiciones del servicio de Google y las condiciones adicionales para la IA generativa;
- el proyecto de Google Cloud no debe estar marcado por infracciones.
400 FAILED_PRECONDITION y el nivel gratuito
Este error tiene que ver con el dinero. Este es el mensaje que aparece en la tabla de errores de Gemini API:
Gemini API free tier is not available in your country. Please enable billing on your project in Google AI Studio.
Traducción: «El nivel gratuito de Gemini API no está disponible en tu país. Activa la facturación de tu proyecto en Google AI Studio».
Google recomienda activar un plan de pago en AI Studio. Pero esto solo funciona en los países que aparecen en la lista.
403 PERMISSION_DENIED: lee el mensaje
El número es el mismo, pero el mensaje de la tabla de errores es distinto:
Your API key doesn't have the required permissions.
Traducción: «Tu clave de API no tiene los permisos necesarios».
Según Google, los motivos son que hayas elegido una clave incorrecta o que estés accediendo a un modelo ajustado sin la autorización necesaria. Comprueba que la clave sea la correcta y que tenga acceso.
Pero en AI Studio, el mismo PERMISSION_DENIED también aparece durante la comprobación de la región. Google lo explica en la página sobre las 4 comprobaciones. Así que lee el mensaje. Si menciona los permisos de la clave, compruébala. Si menciona tu región, la clave no tiene nada que ver.
¿Merece la pena seguir usando Gemini?
Para programar, no lo creo. Tengo Gemini en el plan de nivel más alto, pero no desarrollo programas con él. Lo uso para vídeos y fotos. Pasé un mes trabajando con Google Antigravity, el programa de Google para trabajar con código, y aun así volví a VS Code.
Da igual que Gemini pueda tener 1 millón de tokens en la cabeza: es un poco menos inteligente que ChatGPT. Antigravity no es malo y me gusta, pero, por desgracia, la calidad sigue siendo mucho peor. Si no hay nada más disponible, sirve: tener algo es mejor que no tener nada.
Gemini es bueno para investigar a fondo un tema en Internet. Al fin y al cabo, es Google: se traga todos los sitios web y todos los sitios web lo dejan entrar. Por eso hago este tipo de investigación con Gemini en lugar de Claude: Claude es caro y consumirá muchos tokens. Pero ten en cuenta que Gemini escribe mucho y con todo detalle, y no sabe extraer la idea principal.
Qué usar en lugar de Gemini
Este es mi orden. Claude Code, porque sencillamente es más inteligente. ¿Por qué elegir un modelo menos inteligente si tienes disponible el más inteligente? Si no consigues que funcione, usa ChatGPT Codex: es más fácil obtener acceso y hay menos bloqueos. Si tampoco funciona, hay modelos chinos.
El vídeo compara otros modelos para vibe coding:
Incluye Codex, Gemini, Qwen, Cursor, Lovable, Bolt y v0, y explica la elección de Claude Code en el ejemplo de trabajo descrito.
Qwen. Qwen es un modelo chino. Está alrededor de un 10 % por detrás de Opus, el modelo más potente de Claude; es bastante bueno, pero lento. Yo también lo uso, sobre todo para comprobar si el código tiene errores. Expliqué cómo configurarlo en un artículo aparte.
DeepSeek. Es una plataforma china. Pero no puede gestionar una tarea que dure varias horas: lo probé y se rompe por el camino. Expliqué en qué se diferencia de ChatGPT en un artículo aparte.
Expliqué qué modelo elegir para cada tarea y evitar pagar de más en un artículo aparte.
Si Gemini forma parte de tu producto
Incorpora un modelo de respaldo desde el principio. En el caso descrito, se usó la API oficial de ChatGPT y bloquearon la cuenta: el servicio había procesado un texto de un usuario que contenía comentarios ofensivos. El usuario ni siquiera vio el bloqueo, porque el servicio cambió a un modelo chino al recibir una respuesta de rechazo.
Puedes leer en un artículo aparte un análisis similar del error regional de Claude Code.
Si Gemini y Claude no están disponibles en tu región, compara las alternativas disponibles para tu tarea.
Fuentes
- Google: regiones disponibles para Gemini API y Google AI Studio - una lista de 230 países y territorios, 3 motivos por los que se te puede redirigir a esa página y Gemini Enterprise Agent Platform para los países que no aparecen en la lista.
- Google: solución de problemas de Google AI Studio - el error 403 Access Restricted y 4 comprobaciones de acceso durante las cuales puede aparecer PERMISSION_DENIED.
- Google: errores de API - 400 FAILED_PRECONDITION para el nivel gratuito y 403 PERMISSION_DENIED por los permisos de la clave.
Conoce Ailoot.
Más detalles
Preguntas sobre la seguridad y el acceso a herramientas de IA
¿Todo error 403 de Gemini significa que mi país no está admitido?
No. Lee el mensaje completo. AI Studio comprueba región, edad y condiciones de la cuenta; un PERMISSION_DENIED referido a permisos de clave exige, en cambio, revisar la clave seleccionada y su acceso.
¿Qué compruebo si el nivel gratuito devuelve FAILED_PRECONDITION?
Comprueba si el nivel gratuito de Gemini API está disponible para tu país y proyecto. No confundas esa restricción con una clave incorrecta; el artículo enlaza las páginas de regiones y diagnóstico de Google para ese error concreto.