Descripción general
Un error de facturación o cuota de la API puede indicar que alcanzaste un límite de uso aprobado, un límite de gasto configurado o que agotaste tus créditos prepagados. Revisa el error antes de cambiar la configuración.
Identifica el error
Revisa error.code en la respuesta de la API. Un error relacionado con la facturación puede seguir usando el valor más general insufficient_quota en error.type.
| Código de error | Qué significa | Siguiente paso |
| organization_usage_limit_exceeded | Tu organización alcanzó el límite de uso asignado por OpenAI. | Revisa tu límite aprobado y las opciones para aumentarlo. |
| organization_spend_limit_exceeded | Tu organización alcanzó el límite máximo de gasto configurado. | Revisa los controles de gasto de la organización. |
| project_spend_limit_exceeded | Tu proyecto alcanzó el límite máximo de gasto configurado. | Revisa los controles de gasto de ese proyecto. |
| credit_balance_exhausted | Tu organización ya no tiene créditos prepagados. | Agrega créditos a tu saldo de la API. |
Volver a intentar estas operaciones no restablecerá el acceso hasta que soluciones el problema con los créditos o límites correspondientes. Para obtener más información, consulta la guía de códigos de error de la API.
Revisa tu límite de uso aprobado
Ve a la página Límites de tu organización para consultar su límite de uso mensual aprobado y nivel de uso actuales.
A medida que aumenta tu gasto en la API, OpenAI traslada automáticamente a tu organización a niveles de uso superiores. Por lo general, esto aumenta los límites de solicitudes en la mayoría de los modelos. Consulta los límites que se muestran para tu organización en lugar de suponer que todas las cuentas tienen la misma asignación mensual.
Para obtener detalles sobre los niveles, consulta la guía de límites de solicitudes de la API.
Revisa los controles de gasto configurados
Las alertas de gasto envían notificaciones sin detener el tráfico de la API. Los límites máximos de gasto pueden detener las solicitudes afectadas cuando el gasto registrado alcanza el monto configurado.
Pueden aplicarse tanto los límites de la organización como los del proyecto. El límite de una organización abarca sus proyectos; el límite de un proyecto abarca el tráfico facturado a ese proyecto. Estos controles son independientes del límite de uso que OpenAI aprobó para ti.
Si un límite máximo causó el error, alguien con permiso para administrar la configuración correspondiente puede aumentarlo o eliminarlo si se debe seguir gastando. De lo contrario, se restablece con el siguiente ciclo mensual. Los cambios y su aplicación no son instantáneos, por lo que el gasto registrado puede superar ligeramente el monto configurado.
Para consultar la configuración y las instrucciones, revisa la guía de límites de gasto de la API.
Revisa tu saldo prepagado
Si agotaste tus créditos prepagados, ve al portal de facturación de la API y selecciona Comprar créditos o Agregar al saldo de créditos, según la opción que aparezca, para comprar más. El saldo actualizado puede tardar unos minutos en aparecer.
Para obtener instrucciones de configuración y recarga, consulta Configurar la facturación prepagada.
Comprueba si se trata de un error de límite de solicitudes
Los límites de solicitudes y tokens controlan la rapidez con la que puedes usar la API. Son distintos de los límites de uso mensuales, los controles de gasto y tu saldo prepagado.
Para solucionar errores de límites de solicitudes o tokens, consulta Solucionar errores de límites de solicitudes de la API.
Si el problema continúa
Antes de escalar el problema
Ten a la mano el mensaje y el código del error, la hora en que ocurrió junto con tu zona horaria y los ID de solicitud pertinentes. Elimina la información confidencial de las capturas de pantalla o del código que compartas.
Contacta al equipo de Soporte de OpenAI
Si tus necesidades superan los límites disponibles para tu organización, tienes un caso de uso particular o el error continúa después de solucionar la causa, contacta al equipo de Soporte de OpenAI mediante el widget de chat del Centro de ayuda.
Para consultar las instrucciones de contacto y la información que debes incluir, revisa Contactar a Soporte.
