Un agente que genera descripciones de productos puede funcionar bien durante semanas y disparar el gasto el día que entra en un bucle o recibe tráfico inesperado. Si tu app usa Vercel AI Gateway, puedes ponerle un presupuesto a la clave que utiliza ese flujo. La decisión importante es qué credencial hace las peticiones: un presupuesto por API key no cubre automáticamente el tráfico autenticado con OIDC de un despliegue de Vercel ni el gasto de una clave propia de otro proveedor.

Esta es una guía práctica sobre una función existente, no un lanzamiento del 24 de octubre. La documentación oficial de AI Gateway Budgets explica los ámbitos, los comandos, el estado HTTP 402 y los límites. No creé una clave ni gasté créditos en la cuenta de Joseph: los ejemplos de $10 y de consumo son ilustrativos. Puedes configurarlo en tu propio proyecto después de comprobar el tipo de autenticación y el costo aceptable.

Primero elige el ámbito correcto

Vercel aplica presupuestos a equipo, proyecto, API key y usuario. Una petición debe pasar todos los presupuestos que le correspondan. Para una app pequeña que llama a AI Gateway con una API key propia, el límite de esa clave permite aislar el experimento del resto del equipo. Si el despliegue usa tokens OIDC, revisa un presupuesto de proyecto. Si quieres un techo agregado para todo, revisa el de equipo. El presupuesto de usuario depende de la atribución de gasto de sus claves, no de toda petición hecha por el equipo.

Hay dos confusiones frecuentes. Una clave sin presupuesto puede seguir sin límite propio aunque el panel muestre otras claves limitadas. Y las llamadas con BYOK, es decir, tu clave del proveedor externo, no se contabilizan en los presupuestos de AI Gateway. El gasto de ese proveedor requiere controles en su cuenta. Vercel también aclara que un presupuesto limita uso, pero no compra créditos ni sustituye un método de pago.

Crea una clave con un tope de prueba

En el panel de AI Gateway abre API Keys, crea una clave y activa un presupuesto. Elige una cifra que de verdad puedas gastar; Vercel documenta un mínimo de $1. Selecciona daily, weekly, monthly o none. none significa acumulativo: no se reinicia. Los periodos con reinicio usan UTC: el mensual comienza el primer día del mes en UTC.

Si prefieres la CLI, este es el comando documentado para una clave de experimento con $10 mensuales:

vercel ai-gateway api-keys create --name content-lab --budget 10 --refresh-period monthly

Como alternativa al comando anterior, puedes usar un tope acumulativo y una fecha de caducidad para que la clave de prueba tampoco viva indefinidamente:

vercel ai-gateway api-keys create --name content-lab-30d --budget 10 --refresh-period none --expiration 30d

Guarda el valor de la clave en un gestor de secretos: Vercel lo muestra al crearla y no permite recuperarlo después. Conecta esa clave solo al flujo que quieres limitar. Si tu app sigue usando otra credencial, el presupuesto nuevo no protegerá ese tráfico. No probé los comandos contra una cuenta de Vercel; los contrasté con su documentación vigente.

Qué ocurre al llegar al límite

El control no es un corte contable exacto. Vercel comprueba el presupuesto al empezar cada petición. En el ejemplo del diagrama, una clave lleva $9.70 de un tope de $10; una petición de $0.50 todavía empieza y termina, dejando $10.20. La siguiente petición recibe HTTP 402 con el tipo quota_for_entity_exceeded. Es un tope suave: la factura puede superar ligeramente la cifra indicada.

Prepara tu app para ese 402: pausa la generación, informa de que se agotó el presupuesto y ofrece reintentar cuando se reinicie o un administrador lo amplíe. No reintentes en bucle, porque el límite seguirá vigente. Si tu automatización publica contenido, deja el trabajo pendiente en cola con su ID; no lo marques como publicado por haber iniciado la petición. Otros 402 no deben confundirse automáticamente con este caso: inspecciona también error.type.

Cómo comprobar que el control sirve

En API Keys verifica que la clave de tu flujo muestra el límite y el periodo elegidos, y después consulta el gasto de esa clave. Revisa con qué credencial sale una llamada de prueba; si usa OIDC o BYOK, el presupuesto de la API key no es el control adecuado. Vercel advierte que un presupuesto recién creado puede tardar uno o dos minutos en empezar a contabilizar, y que los cambios pueden tardar más en propagarse a claves activas. Espera antes de concluir que falló.

Para un agente que corre varias veces al día, empezaría con una clave separada, un presupuesto pequeño y alertas; luego miraría el gasto por tarea. Si el flujo es crítico, diseña una degradación cuando aparezca 402. El presupuesto es una barrera útil frente a un consumo descontrolado, pero no sustituye la medición de costos, los límites de concurrencia ni los controles del proveedor cuando uses BYOK.