Al hacer scripts de automatización, bots o integrar flujos de trabajo, lo más desesperante no es escribir código, sino que de repente aparezcan API key invalid, 401, 403 o timeouts de red. No te preocupes: en este artículo, siguiendo el orden en que yo mismo me fui estrellando, te dejo una lista “que si la revisas tal cual, lo localizas”, válida para ChatGPT, Claude y Gemini.
Primero mira el tipo de error; no empieces reinstalando
Mucha gente trata todos los problemas como “la clave está mal” y al final pierde el tiempo.
- 401: clave inválida, no se envió, formato mal escrito, el proyecto no está habilitado
- 403: permisos insuficientes, restricciones por región/controles de riesgo, bloqueo por políticas de cuota
- 429: limitación por rate limit o se agotó la cuota
- Timeout/ENOTFOUND: problema de red/DNS/proxy; no tiene que ver con la clave
Causas frecuentes de “API key invalid”
Tomando como referencia experiencias de depuración de plugins donde se mencionan “errores de clave API” y trampas de configuración de dependencias, resumo las más comunes en estas:
- Se copiaron espacios o saltos de línea de más: especialmente en variables de entorno; un espacio al final basta para hacerte dudar de la vida
- Se usó la key de la plataforma equivocada: las keys de OpenAI, Anthropic y Google no son intercambiables; no metas la key de Gemini en la configuración de Claude
- Encabezados de la petición mal escritos: prefijo en Authorization, mayúsculas/minúsculas del nombre del header, olvidar “Bearer”
- El proyecto no tiene facturación/permisos habilitados: la key es real, pero si la cuenta no tiene habilitado el permiso del API correspondiente, también te la rechazará
Acceso restringido 403: revisa sobre todo la región y la salida
El 403 es lo más fastidioso porque a menudo no te dice “exactamente qué no está bien”. Según mi experiencia, primero revisa la IP de salida y las reglas del proxy, y luego los permisos de la cuenta.
