Al escribir código para integrar ChatGPT, Claude o Gemini, lo más desesperante no es que el modelo no sea inteligente, sino que directamente te ignore: 401, 403 y 429 aparecen por turnos. Este conjunto de comprobaciones es el que más uso yo; básicamente logra bajar el “la API no funciona” de lo esotérico a lo real.
Primer tipo de error: 401 clave inválida o firma incorrecta
Si ves invalid_api_key o Unauthorized, no te vengas abajo: en el 80% de los casos es porque al copiar pegaste espacios de más, te faltó el prefijo, o metiste una Key de entorno de pruebas en producción.
- Confirma que la Key proviene de la plataforma correcta: no mezcles OpenAI, Anthropic y Google
- Revisa las cabeceras de la solicitud: ¿está bien escrito el formato Bearer?
- Prueba con una solicitud mínima para validar, no empieces metiendo un montón de parámetros
Segundo tipo de error: 429 limitación de tasa o se acabó la cuota
El 429 parece un problema de red, pero en realidad se parece más a “lo estás usando demasiado fuerte”.
- Controla la concurrencia y aplica reintentos con backoff exponencial
- Verifica la facturación y las cuotas; en Gemini y Claude no te equivoques de proyecto/organización
- Si el texto es largo, divídelo si puedes; en prompts usa el principio KISS: más simple suele ser más estable
Tercer tipo de error: 403 bloqueo por región o por control de riesgo
Muchas veces un 403 no es que no tengas permisos, sino que la plataforma te considera “sospechoso”. La intranet de empresa, IPs de centro de datos o cambiar de nodo con frecuencia lo disparan fácilmente.
