Qué mide
- Solo modelos BYOK. El gasto se mide sobre los modelos que configuraste en Bring Your Own Key — las claves que pagas directamente a tu proveedor. Los modelos que Kodus ejecuta por su cuenta no cuentan.
- Valorado a las tarifas actuales, por modelo. Los tokens de cada modelo se valoran a la tarifa actual de ese modelo. No hay snapshot — si el precio de un modelo cambia (actualización del catálogo o edición manual), el uso de ese modelo en lo que va de mes se recalcula con la nueva tarifa. Cambiar de modelo no revalora el modelo que usabas antes.
- Por mes natural (UTC). La ventana va del día 1 del mes al día 1 del siguiente. El uso se reinicia a $0 automáticamente al comenzar cada mes — no hay nada que reiniciar a mano.
Para que la cifra refleje solo a Kodus, recomendamos que la clave de API que le das a Kodus se use exclusivamente con Kodus. Si esa misma clave también alimenta otras herramientas, el uso en tu proveedor — y cualquier estimación basada en él — mezcla ambos.
Cómo configurarlo
El límite está en la pantalla de BYOK, debajo de tus modelos Main y Fallback.1
Abre los ajustes de BYOK
Ve a app.kodus.io/organization/byok y desplázate hasta Monthly spend limit. (La sección aparece cuando tienes al menos un modelo BYOK configurado.)
2
Revisa los precios de los modelos
Cada modelo configurado muestra su precio por token — input, output, cache read, cache write — como $ / 1M tokens. Una etiqueta Catalog significa que Kodus encontró el precio automáticamente; una etiqueta Manual significa que lo introdujiste tú.
3
Corrige cualquier modelo sin precio
Un modelo con la etiqueta No price no pudo valorarse automáticamente (modelo personalizado o no catalogado). Introduce sus precios por token desde la página de precios de tu proveedor. No puedes habilitar el límite hasta que todos los modelos tengan precio — no se puede medir el gasto de un modelo que Kodus no sabe valorar.
4
Fija el límite mensual y habilítalo
Introduce tu tope en US$, activa Enable spend alerts y haz clic en Save spend limit.
Precios de modelo
Precio de catálogo vs. manual
Precio de catálogo vs. manual
Kodus busca cada modelo en un catálogo público de precios y rellena lo que encuentra (Catalog). Si el catálogo está mal o no tiene el modelo, introduce las tarifas por token correctas — la etiqueta cambia a Manual y se usan tus valores.
Volver de un precio manual al de catálogo
Volver de un precio manual al de catálogo
En un modelo que hayas sobrescrito, haz clic en Revert to catalog price. Los campos vuelven a los valores del catálogo y la etiqueta vuelve a Catalog. A partir de ahí, ese modelo vuelve a seguir el precio vivo del catálogo (sin snapshot congelado).
Por qué un modelo puede mostrar 'No price'
Por qué un modelo puede mostrar 'No price'
Los endpoints personalizados, los modelos self-hosted o los modelos que el catálogo no ha indexado no tienen precio automático. Introduce las tarifas manualmente para poder medirlos. Hasta entonces, el límite no puede habilitarse.
Alertas
Una vez habilitado, Kodus revisa tu gasto acumulado del mes aproximadamente una vez por hora y notifica a los Owners de tu organización por email y en el centro de notificaciones de la app a medida que cruzas cada umbral:
Cada umbral se dispara como máximo una vez al mes, así que no recibirás avisos repetidos del mismo nivel. El contador se limpia automáticamente al empezar el nuevo mes.
Las revisiones siguen ejecutándose con normalidad todo el tiempo — al 50%, al 100% y más allá. Las alertas son lo único que ocurre.
Precisión
El gasto es una estimación. Se deriva de los tokens que usaron tus revisiones y de los precios por token mostrados en la pantalla de BYOK — no cuadrará al céntimo con la factura de tu proveedor.Mantén los precios exactos
Contrasta los precios del catálogo con la página de precios de tu proveedor y corrige los que estén desviados. Los planes de suscripción o tarifa plana especialmente no cuadran con el precio por token del catálogo.
Usa la clave solo con Kodus
Una clave dedicada significa que el uso que Kodus ve es el uso que Kodus causó — nada más infla la cifra.
Preguntas frecuentes
¿Alcanzar el límite detiene mis revisiones?
¿Alcanzar el límite detiene mis revisiones?
No. Es solo notificación. Para detener el gasto, configura un límite duro en el panel de facturación de tu proveedor de modelos.
¿Qué cuenta para el gasto?
¿Qué cuenta para el gasto?
Solo el uso de tokens en tus modelos BYOK, valorado a las tarifas actuales mostradas en la pantalla de BYOK. Los modelos alojados por Kodus no cuentan.
¿Cuándo se reinicia el gasto?
¿Cuándo se reinicia el gasto?
El día 1 de cada mes natural (UTC). El gasto del mes vuelve a $0 y todas las alertas de umbral se rearman automáticamente.
Cambié de modelo a mitad de mes, ¿mi gasto da un salto?
Cambié de modelo a mitad de mes, ¿mi gasto da un salto?
No. El gasto se mide por modelo: los tokens de cada modelo se valoran a la tarifa de ese modelo. Si gastaste $50 en el modelo A y luego cambias al modelo B, el uso del modelo A se queda en $50 — cambiar a B nunca revalora los tokens de A a la tarifa de B. Tu total simplemente crece con lo que el modelo B consuma a partir de entonces.Lo único que revalora el uso ya incurrido es un cambio en el precio de ese mismo modelo — cuando el catálogo de precios actualiza la tarifa de un modelo, o editas su precio manual en la pantalla de BYOK, el uso de ese modelo en lo que va de mes se recalcula con la nueva tarifa (no hay snapshot congelado).
¿Por qué no puedo habilitar el límite?
¿Por qué no puedo habilitar el límite?
Todos los modelos configurados deben tener precio (de catálogo o manual) y el límite mensual debe ser mayor que $0. Corrige cualquier modelo con No price, fija una cantidad positiva y guarda.
¿Quién recibe las alertas?
¿Quién recibe las alertas?
Los Owners de tu organización, en el centro de notificaciones de la app. Ajusta el enrutamiento en Spend Limit dentro de los ajustes de notificaciones.