Descripción general
El uso de la API está sujeto a límites de solicitudes. Estos límites restringen las solicitudes, los tokens u otros tipos de uso durante un período determinado.
Una respuesta 429 puede indicar un límite de solicitudes temporal, un saldo prepago agotado o un límite de gasto o de uso. Revisa los detalles del error antes de volver a intentarlo o cambiar tu configuración de facturación.
Identifica la causa
Lee el mensaje de error y el valor de error.code, si se proporciona. Los errores relacionados con la facturación también pueden usar insufficient_quota, un valor más general de error.type.
| Error o código | Qué significa | Qué hacer |
| Se alcanzó el límite de solicitudes o de tokens | Las solicitudes superan un límite de solicitudes aplicable. | Espacia las solicitudes y sigue las recomendaciones de reintentos que se indican más abajo. |
| credit_balance_exhausted | La organización no tiene créditos prepagos restantes. | Agrega créditos en tu configuración de facturación de la API. |
| organization_usage_limit_exceeded | La organización alcanzó el límite de uso asignado por OpenAI. | Solicita la aprobación de un límite de uso más alto. |
| organization_spend_limit_exceeded | La organización alcanzó su límite de gasto de cumplimiento obligatorio. | Aumenta o elimina el límite, o espera al restablecimiento mensual. |
| project_spend_limit_exceeded | El proyecto alcanzó su límite de gasto de cumplimiento obligatorio. | Aumenta o elimina el límite del proyecto, o espera al restablecimiento mensual. |
Reintentar una solicitud con un error de facturación, gasto o cuota no restablece el acceso. Primero resuelve el problema con el saldo o el límite indicado. Los cambios en los límites de gasto de cumplimiento obligatorio pueden tardar en aplicarse.
Para cambiar un límite de gasto, necesitas permiso para administrar la configuración de la organización o del proyecto correspondiente. Si no tienes acceso, pídele ayuda a la persona que administra esa configuración.
Para comprar créditos prepagos, consulta: configurar y administrar la facturación prepaga de la API.
Para conocer los distintos controles de gasto, consulta la guía de límites de gasto de la API.
Consulta los límites de solicitudes aplicables
Ve a la página de límites de tu organización para revisar su nivel de uso y sus límites actuales.
Los límites de solicitudes pueden aplicarse tanto a la organización como al proyecto. No son cuotas individuales por usuario. Los límites también varían según el modelo, y algunas familias de modelos comparten un límite.
Revisa qué límite indica el error. Por ejemplo, las solicitudes por minuto y los tokens por minuto tienen límites independientes. Puedes alcanzar uno y seguir por debajo del otro.
Consulta los límites de la API de generación de imágenes
Los límites de solicitudes de la API de generación de imágenes dependen del modelo y de tu nivel de uso. Selecciona tu modelo en la página de modelos para ver sus límites.
Para obtener instrucciones de configuración, consulta la guía de generación de imágenes para desarrolladores. Para obtener más información sobre los niveles de uso, consulta la guía de límites de solicitudes de la API.
Confirma la organización que usa tu solicitud
Si perteneces a varias organizaciones, confirma que tus solicitudes usen la organización y el proyecto correctos.
Si tu clave de API usa una organización predeterminada, revisa tu configuración de organización predeterminada. Las organizaciones pueden tener distintas condiciones de facturación y niveles de uso.
Reduce los errores temporales de límite de solicitudes
Espacia las solicitudes y evita las ráfagas
Distribuye las solicitudes a lo largo del tiempo en lugar de enviar muchas a la vez.
Los límites de solicitudes pueden aplicarse en períodos más cortos que el intervalo mostrado. Por ejemplo, un límite de 60 solicitudes por minuto también puede aplicarse en períodos de 1 segundo. Por eso, una ráfaga breve puede provocar un error aunque tu uso promedio parezca estar por debajo del límite por minuto.
Los prompts largos y los máximos de tokens de salida innecesariamente altos también pueden contribuir a los errores de límite de tokens.
Espera antes de volver a intentarlo
Para errores temporales de límite de solicitudes:
Comprueba si la respuesta incluye un encabezado Retry-After.
Si el encabezado contiene un tiempo de espera válido, espera al menos ese tiempo antes de volver a intentarlo.
Si el encabezado no está presente o no es válido, usa una espera exponencial con variación aleatoria: aumenta el tiempo de espera después de cada intento fallido y agrega una pequeña demora aleatoria.
Limita tanto la cantidad de reintentos como el tiempo total dedicado a ellos.
Los SDK oficiales de OpenAI ya reintentan las solicitudes con errores de límite de solicitudes que lo permiten y respetan Retry-After cuando está presente. Ten en cuenta esos reintentos antes de agregar otro bucle de reintentos.
Las solicitudes fallidas cuentan para los límites por minuto. Reenviar continuamente la misma solicitud puede prolongar el problema.
Para obtener orientación y ejemplos de implementación, consulta la guía de límites de solicitudes de la API. Revisa cualquier biblioteca de reintentos de terceros antes de usarla en tu aplicación.
Revisa el tamaño del prompt y de la salida
Elimina de tus prompts las instrucciones innecesarias, el contexto repetido y los ejemplos. Prueba el prompt revisado para confirmar que siga produciendo el resultado que necesitas.
Usa el parámetro de tokens de salida compatible con tu punto de acceso y tu modelo:
Chat Completions usa max_completion_tokens.
Responses usa max_output_tokens.
Evita establecer un máximo mucho mayor de lo que necesita la solicitud. Estos parámetros incluyen tanto los tokens de razonamiento como la salida visible, así que deja margen para ambos cuando uses un modelo de razonamiento.
Revisa tu nivel de uso
Si los errores persisten después de reducir las ráfagas y revisar el uso de tokens, consulta tu página de límites para ver las opciones disponibles para aumentar tus límites.
El nivel de uso de pago de tu organización sube automáticamente a medida que el total de sus compras de créditos alcanza los umbrales de Build, Launch y Grow. Los niveles superiores generalmente ofrecen límites de solicitudes más altos. Consulta la guía de límites de solicitudes de la API para conocer los requisitos de cada nivel.
Tu límite de uso mensual aprobado es independiente de los límites de solicitudes y de tokens. Aumentar uno no confirma que el otro haya cambiado.
Si el problema persiste
Antes de solicitar ayuda
Ten a mano el mensaje de error exacto, cualquier código de error, los ID de las solicitudes afectadas, la hora del error con tu zona horaria y el límite correspondiente que aparece en tu cuenta. Anota los pasos que ya intentaste.
Ponte en contacto con el soporte de OpenAI
Ponte en contacto con el soporte de OpenAI a través del Centro de ayuda si no puedes resolver el problema después de revisar el límite indicado. No incluyas claves de API ni otros datos secretos de autenticación.