Usa las alertas de gasto para monitorear los costos mensuales de la API. Para detener el tráfico cuando el gasto registrado alcance un monto configurado, aplica un límite estricto de gasto a tu organización o a un proyecto individual.
Los límites estrictos de gasto pueden interrumpir el tráfico de producción. Cuando el gasto registrado alcanza
un límite estricto aplicable, las solicitudes afectadas a la API devuelven un error 429 con el código
organization_spend_limit_exceeded o project_spend_limit_exceeded.
La aplicación del límite no es instantánea, por lo que el gasto registrado puede superar ligeramente el
monto configurado.
Elige un control de gasto
Las alertas de gasto y los límites estrictos de gasto tienen efectos diferentes:
| Control | Qué sucede al alcanzar el monto configurado | Úsalo cuando quieras |
|---|---|---|
| Alerta de gasto | Envía una notificación; el tráfico de la API continúa | Monitorear el gasto sin interrumpir el tráfico |
| Límite estricto de gasto | Las solicitudes afectadas a la API devuelven un error 429 | Aplicar un tope mensual a una organización o un proyecto |
Las alertas de gasto no imponen un tope. Permanecen activas cuando agregas un límite estricto de gasto, por lo que puedes usarlas para recibir notificaciones antes de que un límite estricto interrumpa el tráfico.
OpenAI también asigna a tu organización un límite de uso mensual aprobado según su nivel de uso. Este límite de uso aprobado por OpenAI es independiente de los límites de gasto que configures.
Configura un límite de gasto
Necesitas permiso para administrar la configuración de la organización o del proyecto correspondiente. Para obtener más información, consulta los permisos de la Plataforma API.
- Ve a Límites de la organización.
- En Gasto, selecciona Editar límite de gasto.
- Ingresa el Límite mensual de gasto.
- Para que la API responda con errores cuando la organización alcance el límite, activa Aplicar un límite estricto.
- Selecciona Guardar.
- Ve a Configuración del proyecto.
- Selecciona Límites.
- En Gasto, selecciona Editar límite de gasto.
- Ingresa el Límite mensual de gasto.
- Para que la API responda con errores cuando el proyecto alcance el límite, activa Aplicar un límite estricto.
- Selecciona Guardar.
Comprende cómo funcionan los límites estrictos
Los límites estrictos de la organización y del proyecto pueden aplicarse a una misma solicitud:
- Un límite estricto de la organización se aplica al tráfico de la API de todos los proyectos de la organización.
- Un límite estricto del proyecto se aplica únicamente al tráfico de la API facturado a ese proyecto.
- Al alcanzar un límite estricto de la organización, se devuelve un error
429con el códigoorganization_spend_limit_exceeded. - Al alcanzar un límite estricto del proyecto, se devuelve un error
429con el códigoproject_spend_limit_exceeded. - Aumentar o eliminar el límite alcanzado permite que el tráfico se reanude una vez que se propague la actualización. De lo contrario, el límite se restablece en el siguiente ciclo mensual.
La aplicación del límite no es instantánea. La Plataforma API puede procesar una pequeña cantidad de uso adicional mientras se propaga el estado del límite, por lo que el gasto registrado puede superar ligeramente el monto configurado.
Alertas de gasto
Usa las alertas de gasto para recibir notificaciones antes de que el gasto alcance un límite estricto. Agrega alertas en umbrales que te den tiempo para ajustar el uso, aumentar el límite o investigar el tráfico inesperado.
Restablece el tráfico de la API
Si las solicitudes fallan debido a un límite relacionado con la facturación o al saldo de créditos:
- Revisa
error.codepara identificar si la solicitud alcanzó un límite de gasto de la organización, un límite de gasto del proyecto o un límite de uso asignado por OpenAI, o si la organización agotó sus créditos prepagados. - En el caso de
organization_spend_limit_exceededoproject_spend_limit_exceeded, compara el uso actual con tus límites de gasto. Aumenta o elimina el límite alcanzado si el tráfico debe reanudarse antes del restablecimiento mensual. - En el caso de
organization_usage_limit_exceeded, solicita un límite de uso aprobado más alto. - En el caso de
credit_balance_exhausted, agrega créditos. - Si el error indica un límite de solicitudes o de tokens por unidad de tiempo, sigue la guía sobre límites de solicitudes.