Usa las alertas de gasto para monitorear los costos mensuales de la API. Si quieres detener el tráfico cuando el gasto registrado alcance el monto configurado, aplica un límite estricto de gasto a tu organización o a un proyecto específico.
Los límites estrictos de gasto pueden interrumpir el tráfico de producción.
Cuando el gasto registrado alcanza un límite estricto aplicable, la API devuelve
un error 429 para las solicitudes afectadas, con el código
organization_spend_limit_exceeded o project_spend_limit_exceeded.
El límite tarda en aplicarse, por lo que el gasto registrado puede superar
ligeramente el monto configurado.
Elige cómo controlar el gasto
Las alertas de gasto y los límites estrictos de gasto tienen efectos distintos.
| Control | Qué sucede al alcanzar el monto configurado | Cuándo usarlo |
|---|---|---|
| Alerta de gasto | Se envía una notificación y el tráfico de la API continúa | Cuando quieras monitorear el gasto sin interrumpir el tráfico |
| Límite estricto de gasto | La API devuelve un error 429 para las solicitudes afectadas |
Cuando quieras aplicar un tope mensual a la organización o a un proyecto |
Las alertas de gasto no imponen un tope. Siguen activas cuando agregas un límite estricto de gasto, así que puedes usarlas para recibir una notificación antes de que el límite 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, según corresponda. 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 devuelva un error 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 devuelva un error cuando el proyecto alcance el límite, activa Aplicar un límite estricto.
- Selecciona Guardar.
Cómo funcionan los límites estrictos
A una misma solicitud se le pueden aplicar tanto el límite estricto de la organización como el del proyecto.
- El límite estricto de una organización se aplica al tráfico de la API de todos sus proyectos.
- El límite estricto de un proyecto se aplica solo al tráfico de la API que se factura a ese proyecto.
- Cuando se alcanza el límite estricto de la organización, la API devuelve un error
429con el códigoorganization_spend_limit_exceeded. - Cuando se alcanza el límite estricto del proyecto, la API devuelve un error
429con el códigoproject_spend_limit_exceeded. - Si aumentas o eliminas el límite alcanzado, el tráfico puede reanudarse una vez que se propague el cambio. De lo contrario, el límite se restablece al comenzar el siguiente ciclo mensual.
El límite tarda en aplicarse. La Plataforma API puede procesar una pequeña cantidad de tráfico 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. Configura alertas con 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 de facturación o al saldo de créditos, sigue estos pasos.
- Revisa
error.codepara determinar si se alcanzó el límite de gasto de la organización, el límite de gasto del proyecto o el límite de uso asignado por OpenAI, o si la organización agotó sus créditos prepagados. - Si el código es
organization_spend_limit_exceededoproject_spend_limit_exceeded, compara el uso actual con tus límites de gasto. Si necesitas reanudar el tráfico antes de que el límite se restablezca el próximo mes, aumenta o elimina el límite alcanzado. - Si el código es
organization_usage_limit_exceeded, solicita un límite de uso aprobado más alto. - Si el código es
credit_balance_exhausted, agrega créditos. - Si el error indica que se alcanzó un límite de solicitudes o de tokens por unidad de tiempo, sigue la guía sobre límites de solicitudes.