Codex 429 Too Many Requests: límite de reintentos y soluciones

¿Qué significa «exceeded retry limit»?

Lee el mensaje como dos pistas: el cliente dejó de reintentar y la última respuesta HTTP fue 429. Es una interpretación diagnóstica del mensaje recibido, no una garantía oficial sobre el número de reintentos de cada cliente. El protocolo de App Server distingue los errores de intentos fallidos de la información sobre el estado HTTP del servicio al que se conecta.

Guarda los detalles del error anterior si están disponibles. El estado HTTP por sí solo no distingue una limitación de solicitudes de una restricción de cuota o facturación de la API. Reiniciar la misma tarea repetidamente puede generar más solicitudes sin resolver la causa.

1. Identifica qué servicio rechazó la solicitud

Comprueba la cuenta y el espacio de trabajo en el cliente; en la CLI, usa codex login status. La documentación de autenticación de Codex distingue el inicio de sesión con ChatGPT del acceso con una clave de API.

• Inicio de sesión con ChatGPT: consulta el panel de uso de Codex de la misma cuenta. Si has agotado una ventana de uso, sigue la guía sobre el límite alcanzado en Codex. El saldo de facturación de la API no es la cuota de tu suscripción.
• Clave de OpenAI API: revisa el error recibido y el uso y la facturación de la organización o proyecto de API correspondiente. No uses la hora de reinicio de ChatGPT para diagnosticar un límite de la API.
• Proveedor personalizado o pasarela: comprueba a qué proveedor llegó realmente la solicitud fallida. Sus límites y su facturación pueden ser distintos; los códigos de OpenAI API solo son aplicables cuando ese servicio los devuelve. Consulta su propia documentación y canal de soporte.

2. Distingue una limitación temporal de una cuota agotada

Cuando estén disponibles, revisa juntos error.code, error.type y el mensaje. No deduzcas una causa concreta de la ausencia de un campo. La referencia de errores de la API distingue estos casos:

• Limitación de solicitudes: la respuesta indica un límite de frecuencia, posiblemente con slow_down. Reduce las tareas simultáneas y las ráfagas de solicitudes antes de volver a intentarlo.
• Saldo de créditos: credit_balance_exhausted se refiere a créditos de la API. Revisa la facturación con el titular de la cuenta; esperar al reinicio de la suscripción de Codex no repone ese saldo.
• Restricción de gasto o uso: organization_spend_limit_exceeded, project_spend_limit_exceeded y organization_usage_limit_exceeded identifican restricciones diferentes. Comprueba con un administrador el período aplicable y la configuración de la cuenta antes de autorizar gastos adicionales.
• Tipo general de cuota: insufficient_quota puede ser menos específico que error.code. Lee el mensaje detallado en vez de tratarlo como un problema temporal de frecuencia de solicitudes.

Son ejemplos de OpenAI API, no una promesa de que la interfaz de Codex muestre todos los campos. Si solo aparece 429, mantén la causa sin determinar hasta que la información de la cuenta o un error más completo permita identificarla.

3. Reintenta solo cuando esperar pueda ayudar

Para una limitación temporal de la API, respeta Retry-After cuando esté presente. Si no lo está, OpenAI recomienda una espera exponencial con variación aleatoria: aumenta progresivamente la demora y añade un pequeño componente aleatorio. Cualquier bucle de reintentos que controles debe limitar tanto el número de intentos como el tiempo total. Si la espera exigida supera ese margen, aplaza la tarea en lugar de acortar la demora indicada por el servidor.

En una tarea interactiva de Codex, deja de enviar solicitudes repetidas, reduce el trabajo simultáneo y prueba una pequeña continuación una sola vez tras la espera indicada. No añadas un bucle manual de envíos frecuentes a los reintentos del cliente. Los errores de créditos o gasto no se solucionan con esperas progresivas; no existe una solución universal de «esperar cinco minutos».

Antes de continuar una tarea interrumpida, revisa los archivos, los resultados de los comandos y las acciones externas que ya se hayan completado. Reanuda desde un paso cuyo estado conozcas para evitar que el reintento duplique una operación.

Errores 401, 403, 500, 503 y flujos interrumpidos

Usa el mensaje real para decidir qué comprobar a continuación; estos fallos no siempre significan que debas esperar un reinicio de uso. Consulta la referencia de errores y la solución de problemas de Codex.

• 401: comprueba la autenticación, la cuenta seleccionada y la validez de las credenciales. Nunca pegues una clave en una publicación de soporte.
• 403: revisa la restricción de acceso, política o región indicada. Repetir solicitudes no concede permisos.
• 500 o 503: un error del servidor o una sobrecarga temporal puede justificar un reintento tras una espera y con límites. Si persiste, consulta la información del servicio del proveedor y comunica el fallo.
• Flujo desconectado o tiempo de espera agotado: la conexión terminó antes de que el cliente recibiera un resultado completo. Ese texto por sí solo no demuestra un problema de cuota ni que no se haya completado ningún trabajo. Revisa el estado original, los registros del cliente y la ruta de red; después, comprueba el progreso de la tarea antes de continuar.

Qué registrar si el error persiste

Conserva la fecha y hora con zona horaria, el cliente y su versión, el modelo, el método de inicio de sesión, el proveedor, el mensaje sin datos sensibles, el estado HTTP y el ID de solicitud si se facilita. Anota si también falla una sola solicitud pequeña, si otros clientes funcionan y qué comprobaciones de la cuenta realizaste. Elimina las claves de API, los encabezados de autorización, las cookies y el contenido privado de la tarea antes de compartir registros por el canal de soporte del proveedor.

Si las pruebas confirman que se agotó una ventana de la suscripción, sigue la guía sobre la hora de reinicio de Codex. El temporizador personal puede recordarte una hora de recuperación mostrada en tu cuenta; no elimina las limitaciones de solicitudes de la API ni confirma que se haya restablecido el acceso.