Este es el 429 que el backoff no puede solucionar. insufficient_quota significa que tu cuenta no tiene crédito disponible para gastar: la solicitud se rechazó antes de que se ejecutara ningún modelo y seguirá rechazándose hasta que cambie la facturación. Aquí tienes cómo confirmar en qué estado de facturación estás y solucionarlo en minutos.
El error
{
"error": {
"message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota"
}
}Causas y soluciones de un vistazo
| Causa | Solución |
|---|---|
| El saldo de crédito prepagado es de $0 | La API es prepago: compra créditos (o activa la recarga automática) en Settings → Billing. Guardar una tarjeta por sí solo no añade nada hasta que se compran créditos. |
| Los créditos de la prueba gratuita han caducado o se han gastado | Las asignaciones de prueba caducan (normalmente después de 3 meses) aunque no se hayan utilizado. La solución es la misma: añade un método de pago y compra créditos. |
| Se ha alcanzado el límite presupuestario mensual | Un presupuesto que hayas establecido en Limits bloquea las solicitudes durante el resto del mes una vez alcanzado. Auméntalo o espera a que comience el mes siguiente. |
| La clave pertenece a un proyecto u organización sin presupuesto | Las claves sk-proj- gastan del presupuesto de su proyecto; un proyecto puede tener su propio límite (más bajo) que la organización. Comprueba el proyecto de la clave en el panel, no solo el total de la organización. |
Confirma que es una cuestión de cuota, no de límite de velocidad
Lee error.type. rate_limit_exceeded se resuelve por sí solo en un minuto y merece backoff; insufficient_quota nunca se resuelve por sí solo y reintentarlo solo genera ruido. Si no estás seguro, un reintento después de 60 segundos lo confirma: si sigue siendo 429 con el mismo mensaje, es facturación.
Comprueba el saldo de crédito del que realmente gasta la clave
En platform.openai.com → Settings → Billing, consulta el saldo de crédito. Si es cero o negativo, compra créditos. Después comprueba Settings → Limits para ver el límite presupuestario mensual y, en el caso de las claves sk-proj-, los límites de uso del proyecto propietario. Los tres pueden producir este error de forma independiente.
Detén la recurrencia, no solo el incidente
Activa la recarga automática con un umbral razonable para que un fin de semana con mucha actividad no deje fuera de servicio la producción, y configura la alerta presupuestaria (no solo el límite estricto) para enterarte de que se acercan los límites antes de que las solicitudes empiecen a fallar.
Si llamas a través de Kunavo
Kunavo utiliza el mismo modelo prepago, por lo que la comparación honesta se refiere al alcance del monedero, no al mecanismo: un único saldo de Kunavo cubre GPT y Claude conjuntamente, con precios por token, y las solicitudes fallidas nunca se facturan. Cuando el monedero de Kunavo se agota, recibes un 402 con el código insufficient_quota (deliberadamente el mismo código, para que el manejo de errores del SDK de OpenAI sea reutilizable); recargarlo lo soluciona al instante, sin límites mensuales que desbloquear. ¿Estás presupuestando la solución? Las tarifas actuales de GPT por token, junto con la lista oficial de OpenAI, están en la lista de precios de la API de GPT.
Preguntas frecuentes
He añadido una tarjeta de crédito. ¿Por qué sigo recibiendo insufficient_quota?
Porque la API utiliza créditos prepagados, no la tarjeta directamente. Añadir una tarjeta solo permite comprar; todavía tienes que comprar créditos o activar la recarga automática. El error desaparece en uno o dos minutos después de que el saldo pase a ser positivo.
¿insufficient_quota se soluciona alguna vez por sí solo?
Solo en un caso: un límite presupuestario mensual, que se restablece al comenzar el mes siguiente. Los casos de saldo cero y prueba caducada persisten hasta que compres créditos. En cualquier caso, los bucles de reintento no ayudan: la solicitud se rechaza antes de que se ejecute ningún modelo.
¿Las solicitudes 429 fallidas cuestan algo?
No: OpenAI las rechaza antes de la inferencia y, en Kunavo, las solicitudes fallidas tampoco se facturan nunca. El coste es el tiempo de inactividad, por lo que la recarga automática junto con una alerta presupuestaria es mejor que un límite estricto por sí solo.
Guías relacionadas
- Límites de velocidad de la API de OpenAI: cuál alcanzas, cómo leerlo y el reintento que lo soluciona
- Precios de la API de OpenAI GPT 2026 — costes de GPT-6, GPT-5.6 y GPT-5.5, ejemplos y acceso más barato
Encontrarás más detalles sobre el significado de los errores en referencia de errores; obtener una clave lleva un minuto mediante registro y la guía de autenticación.