Descripción general
Un error de facturación o cuota de la API puede indicar que has alcanzado un límite de uso aprobado o un límite de gasto configurado, o que has agotado tus Créditos prepagados. Comprueba el error antes de cambiar los ajustes.
Identificar el error
Comprueba 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 ha alcanzado el límite de uso asignado por OpenAI. | Revisa el límite aprobado y las opciones para aumentarlo. |
| organization_spend_limit_exceeded | Tu organización ha alcanzado un límite estricto de gasto configurado. | Revisa los controles de gasto de la organización. |
| project_spend_limit_exceeded | Tu proyecto ha alcanzado un límite estricto de gasto configurado. | Revisa los controles de gasto de ese proyecto. |
| credit_balance_exhausted | Tu organización se ha quedado sin Créditos prepagados. | Añade Créditos a tu saldo de la API. |
Reintentar estas solicitudes no restablecerá el acceso si no solucionas 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.
Revisar tu límite de uso aprobado
Ve a la página Límites de tu organización para consultar el límite mensual de uso aprobado y el nivel de uso actuales.
A medida que aumenta el gasto en la API, OpenAI asigna automáticamente niveles de uso superiores a tu organización. Esto suele aumentar 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 dar por hecho que todas las cuentas tienen la misma asignación mensual.
Para obtener información sobre los niveles, consulta la guía de límites de solicitudes de la API.
Comprobar los controles de gasto configurados
Las alertas de gasto envían notificaciones sin detener el tráfico de la API. Los límites estrictos de gasto pueden detener las solicitudes afectadas cuando el gasto registrado alcanza el importe 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 aprobado por OpenAI.
Si el error se debe a un límite estricto, alguien con permiso para gestionar los ajustes correspondientes puede aumentarlo o eliminarlo si el gasto debe continuar. De lo contrario, se restablecerá 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 importe configurado.
Para consultar los ajustes y las instrucciones, consulta la guía de límites de gasto de la API.
Comprobar tu saldo de prepago
Si has agotado tus Créditos prepagados, ve al portal de facturación de la API y selecciona Comprar Créditos o Añadir 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 de prepago.
Comprobar si el error se debe a un 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 de prepago.
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 solicitar ayuda
Ten preparados el mensaje y el código de error, la hora a la que se produjo 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.
Contactar con el 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 con el 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, consulta: Contactar con Soporte.