Plan y costos
Plan contratado
Ejecutar una tarea exige tener Kadu en el plan de la organización con Kobana (activo, en prueba o con pago atrasado). El contrato se lee de la facturación de Kobana una vez al día, en el inicio de sesión y cuando el equipo de Kobana actualiza la organización.
Sin plan, solo se bloquea el lanzamiento, en todos los caminos: consola, API,
endpoint de lanzamiento y programaciones. El registro, la lectura, las
configuraciones y la cancelación siguen disponibles. La consola muestra la
barra Contratar el sistema, y la API responde 403 ENTITLEMENT_REQUIRED.
Una programación que deja de correr por falta de plan emite el evento
organization.entitlement_required hacia tus webhooks.
Créditos
Además del plan, la organización puede tener créditos en reales (1 crédito = R$ 1):
- Franquicia del plan: si el plan incluye créditos mensuales, el uso del mes (ejecuciones y conversaciones en Slack, al precio) queda cubierto hasta la franquicia. El mes es el de la zona horaria de la organización.
- Saldo: los créditos comprados en la facturación de Kobana entran al saldo de la organización cuando se paga la factura. El equipo de Kobana también puede registrar ajustes.
Quién paga cada uso se decide antes de que empiece:
| Situación | Quién paga |
|---|---|
| Cortesía vigente | la cortesía |
| Plan sin franquicia de créditos | el plan (el precio va a la factura) |
| Plan con franquicia, dentro de la franquicia del mes | el plan |
| Franquicia agotada, o sin plan, con saldo positivo | el saldo (se debita el precio del uso) |
| Nada de eso | el uso se rechaza (403 ENTITLEMENT_REQUIRED, motivo credits_exhausted o no_plan) |
El saldo solo se usa cuando la franquicia se acaba: es una reserva. El débito ocurre cuando se calcula el precio del uso; el saldo puede quedar negativo si el último uso cuesta más de lo que quedaba. Al llegar al 80 % y al 100 % de la franquicia, los dueños de la organización reciben un correo.
Niveles (tiers)
Cada tarea tiene un nivel (Tier 1, Tier 2…), elegido en el repositorio
con el campo task.model (model: tier-3). El nivel define tres cosas:
| El nivel define | Para qué |
|---|---|
| Precio | cuánto cuesta la ejecución para la organización, en reales por millón de tokens (entrada, salida y caché) |
| Ejecutor | el programa que corre el agente (Claude Code o Goose) |
| Modelo de IA | el modelo que usa el ejecutor |
Los niveles más altos usan modelos más capaces y cuestan más por token. Una organización puede tener un precio negociado por nivel con Kobana.
Costo y precio de una ejecución
Cada ejecución registra los tokens consumidos (entrada, salida, lectura y escritura de caché) y dos valores:
| Valor | Moneda | Qué es |
|---|---|---|
Costo (cost_usd) | USD | lo que la ejecución consumió del proveedor de IA |
Precio (price_brl) | BRL | tokens × precio del nivel; el valor cobrado a la organización |
El precio usa la cotización PTAX de venta del día hábil anterior a la ejecución
(usd_brl_rate). La pestaña Costo de la ejecución y las pantallas de
Analytics muestran estos números.
Conversaciones en Slack
Cada mensaje que responde el bot de Slack también se mide: tokens, costo y precio, calculados igual que en una ejecución. Las conversaciones tienen un solo nivel, definido por Kobana para el bot, que también acepta precio negociado. Las conversaciones entran en el mismo consumo del mes, en la franquicia de créditos, en el tope mensual y en Analytics, con el origen Conversaciones en Slack. Cada conversación tiene un límite de gasto; al alcanzarlo, el bot pide empezar otro hilo.
Tope mensual
Kobana puede definir un tope mensual de costo para la organización, en USD.
El mes es el de la zona horaria de la organización: el tope se reabre a la
medianoche del día 1 en esa zona. El costo de las conversaciones en Slack suma
en el mismo tope. Una vez alcanzado, los nuevos lanzamientos y las nuevas
conversaciones se rechazan hasta que cambie el mes (cost_limit_reached en la
API) y tus webhooks reciben organization.cost_limit_reached. El tope vale
incluso con el plan activo.