¿También te ha pasado este momento desesperante? Integras ChatGPT o Claude en un cliente de terceros y, nada más enviar una frase, te suelta un 401/403; y del lado de Gemini, aunque hayas copiado la Key, igual dice que no es válida. Tranquilo: la mayoría de las veces no es que “no estés autorizado a usarlo”, sino que algún detalle pequeño te está fastidiando.
1 Identifica bien qué tipo de error es
401 casi siempre es porque la Key está mal escrita o no se está enviando; 403 suele ser más por permisos, región o porque el proyecto no está habilitado; 429 es cuota agotada o limitación por rate limit. Primero guarda una captura del código de error: luego te ahorrará la mitad del tiempo al depurar.
2 Problemas con la Key en sí: lo más común y lo más absurdo
- Al copiar se te coló un espacio o un salto de línea (especialmente si lo copias desde un documento)
- Confundiste una “Key visible” con la “Key real” (en algunas plataformas solo se muestra una vez)
- Usaste el entorno equivocado: metiste una Key de pruebas en producción
Pequeña queja: muchos “errores de clave API” en realidad son un espacio invisible; a simple vista no se ve, pero el programa no te lo perdona.
3 Permisos e interruptores sin activar: crees que está habilitado, pero no
En Gemini, lo típico es no haber habilitado la API en el proyecto correspondiente; en ChatGPT también hay que confirmar el proyecto de API y el estado de facturación. En Claude, si te conectas a través de una capa de herramientas, recuerda revisar si la herramienta ha mapeado correctamente los permisos.
4 Proxy y región causando un falso fallo
Si la misma Key no funciona en la red de la empresa pero sí con el hotspot del móvil, casi seguro es un problema del enlace de red. Descarta proxy, DNS, gateway corporativo y esos factores antes de echarle la culpa al producto.
