Error 429 de API de IA: límites de solicitudes, créditos y topes de gasto
Un 429 es una respuesta de límite de solicitudes, no una prueba de interrupción del proveedor. Lee el código de error, el mensaje y las cabeceras de reintento del proveedor antes de reintentar.
Respuesta rápida
Un 429 es una respuesta de límite de solicitudes, no una prueba de interrupción del proveedor. Lee el código de error, el mensaje y las cabeceras de reintento del proveedor antes de reintentar.
Lo que documenta cada proveedor
OpenAI distingue límites de frecuencia de solicitudes, créditos agotados y límites de organización o proyecto. Examina error.code; reintentar un límite de facturación o uso no restablece el acceso.
Claude usa rate_limit_error para límites de solicitudes y algunos topes de gasto. Una respuesta por tope de gasto del nivel de uso no incluye cabecera retry-after. El crecimiento rápido del tráfico también puede activar límites de solicitudes.
Gemini incluye 429 RESOURCE_EXHAUSTED entre los errores que pueden justificar espera exponencial. Examina los detalles del error antes de tratar un límite como transitorio.
Respuesta recomendada de la aplicación
Reduce la concurrencia de solicitudes ante un límite transitorio, respeta el retraso de reintento proporcionado y establece máximos de intentos y tiempo total. Considera los reintentos ya realizados por tu SDK. La ausencia de una cabecera de reintento no identifica por sí sola la causa.
Conserva un cuerpo de error sin información sensible y el ID de solicitud. Comprueba en privado la configuración de tu cuenta cuando el error indique un límite de créditos o gasto; no publiques credenciales. Compara el alcance del estado API pertinente con la evidencia de tu solicitud.
Páginas de servicios relacionados
Cada entrada muestra su propia cobertura de recopilación. Un servicio enlazado no se recopila necesariamente de forma automática.
La fecha de revisión editorial corresponde a esta guía. Las horas de recopilación de informes actuales aparecen en las páginas de servicio.