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 periodo determinado.
Una respuesta 429 puede indicar un límite temporal de solicitudes, un saldo de prepago agotado o un límite de gasto o de uso. Comprueba 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 como valor más genérico de error.type.
| Error o código | Qué significa | Qué hacer |
| Se ha alcanzado el límite de solicitudes o tokens | Las solicitudes superan uno de los límites de solicitudes aplicables. | Espacia las solicitudes y sigue las indicaciones sobre reintentos que se ofrecen a continuación. |
| credit_balance_exhausted | A la organización no le quedan Créditos de prepago. | Añade Créditos en tu configuración de facturación de la API. |
| organization_usage_limit_exceeded | La organización ha alcanzado el límite de uso que le ha asignado OpenAI. | Solicita que se apruebe un límite de uso más alto. |
| organization_spend_limit_exceeded | La organización ha alcanzado su límite de gasto obligatorio. | Aumenta o elimina el límite, o espera al restablecimiento mensual. |
| project_spend_limit_exceeded | El proyecto ha alcanzado su límite de gasto obligatorio. | Aumenta o elimina el límite del proyecto, o espera al restablecimiento mensual. |
Reintentar una solicitud que ha fallado por 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 obligatorios pueden tardar en aplicarse.
Para cambiar un límite de gasto, necesitas permiso para gestionar la configuración de la organización o del proyecto correspondiente. Si no tienes acceso, pídeselo a la persona que gestiona esa configuración.
Para comprar Créditos de prepago, consulta: configuración y gestión de la facturación de prepago de la API.
Para conocer los distintos controles de gasto, consulta la guía de límites de gasto de la API.
Comprueba los límites de solicitudes aplicables
Ve a la página de límites de tu organización para consultar 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 mismo límite.
Comprueba qué límite se indica en el error. Por ejemplo, las solicitudes por minuto y los tokens por minuto tienen límites independientes. Puedes alcanzar uno sin superar el 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 ver las 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 utiliza tu solicitud
Si perteneces a varias organizaciones, confirma que tus solicitudes utilizan la organización y el proyecto previstos.
Si tu clave de API utiliza una organización predeterminada, comprueba el ajuste de organización predeterminada. Cada organización puede tener condiciones de facturación y niveles de uso distintos.
Reduce los errores temporales por límites 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 a periodos más cortos que el intervalo indicado. Por ejemplo, un límite de 60 solicitudes por minuto también puede aplicarse a periodos de 1 segundo. Por tanto, una ráfaga breve puede provocar un error aunque tu uso medio parezca estar por debajo del límite por minuto.
Los prompts largos y unos máximos de tokens de salida innecesariamente altos también pueden contribuir a los errores por límites de tokens.
Espera antes de volver a intentarlo
En caso de errores temporales por límites de solicitudes:
Comprueba si hay una cabecera de respuesta Retry-After.
Si la cabecera contiene un tiempo de espera válido, espera al menos ese tiempo antes de volver a intentarlo.
Si la cabecera no está presente o no es válida, utiliza una espera exponencial con variación aleatoria: aumenta el tiempo de espera tras cada intento fallido y añade un pequeño retraso aleatorio.
Limita tanto el número de reintentos como el tiempo total dedicado a ellos.
Los SDK oficiales de OpenAI ya reintentan las solicitudes con errores por límites de solicitudes que admiten reintentos y respetan Retry-After cuando está presente. Ten en cuenta esos reintentos antes de añadir otro bucle de reintentos.
Las solicitudes fallidas cuentan para los límites por minuto. Reenviar continuamente la misma solicitud puede prolongar el problema.
Para ver indicaciones de implementación y ejemplos, 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 la longitud 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 sigue produciendo el resultado que necesitas.
Usa el parámetro de tokens de salida compatible con tu punto de acceso y tu modelo:
Chat Completions utiliza max_completion_tokens.
Responses utiliza 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 reserva 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. Por lo general, los niveles superiores ofrecen límites de solicitudes más altos. Consulta los requisitos de cada nivel en la guía de límites de solicitudes de la API.
Tu límite de uso mensual aprobado es independiente de los límites de solicitudes y tokens. Que aumente uno no significa que los demás hayan 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 has probado.
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 tras comprobar el límite indicado. No incluyas claves de API ni otros datos secretos de autenticación.