AI Budget
AI Budget
La vista AI Budget te permite establecer límites de gasto en tokens y dinero para prevenir costes API descontrolados. Los límites pueden aplicarse globalmente, por proveedor, por grupo Joomla / rol WordPress, o por usuario individual.
Conceptos
| Término | Significado |
|---|---|
| Token cap | Máximo de tokens (input + output) permitidos por periodo |
| USD cap | Gasto máximo en dólares por periodo |
| Periodo | daily, weekly, o monthly (rolling) |
| Scope | Global · Provider · Grupo/Rol · Usuario |
| Umbral alerta | % del cap al que se envía notificación email |
Los caps se evalúan en orden: Usuario → Grupo → Provider → Global. Gana el cap más restrictivo que aplique.
Lista de budget
Ve a JoomlaAI → AI Budget.
| Columna | Descripción |
|---|---|
| Nombre | Etiqueta humana (ej. "Cap mensual global", "Editores — límite diario") |
| Scope | Global / Provider / Grupo / Usuario |
| Periodo | Diario / Semanal / Mensual |
| Token cap | Máx tokens (vacío = ilimitado) |
| USD cap | Máx USD (vacío = ilimitado) |
| Usado | Tokens / USD consumidos en el periodo |
| % | Barra de consumo |
| Alertas | Estado 70% / 90% / 100% |
| Estado | Activo / Pausado |
Crear una regla budget
Pulsa Nuevo en la barra.
| Campo | Obligatorio | Descripción |
|---|---|---|
| Nombre | Sí | Etiqueta para esta regla |
| Scope | Sí | Global / Provider / Grupo / Usuario |
| Target | Si scope ≠ Global | Elige proveedor, grupo o usuario |
| Periodo | Sí | Diario / Semanal / Mensual |
| Token cap | No | Vacío = ilimitado |
| USD cap | No | Vacío = ilimitado |
| Alerta 70% | ON | Email al 70% consumido |
| Alerta 90% | ON | Email al 90% |
| Alerta 100% | ON | Email al alcanzar el cap |
| Acción 100% | block o warn | Bloquear o solo notificar |
| Estado | Sí | Activo / Pausado |
Notificaciones de alerta
Las emails de alerta van al email del administrador del sitio cuando se cruza un umbral.
Ejemplo asunto: [JoomlaAI] Budget alert — el grupo Editores ha usado el 90% del cap mensual de tokens
Para cambiar el destinatario, actualiza From email en Configuración → Mail (Joomla) o Ajustes → Email (WP).
Widget budget en tiempo real
El Dashboard muestra una tarjeta KPI Budget usado. Cuando una regla llega al 90% se pone ámbar; al 100% rojo.
La vista Health Check también muestra estado budget en la sección Budget.
Modo FREE_ONLY
Si no hay claves API configuradas, el sistema entra en modo FREE_ONLY: solo los proveedores locales (Ollama) están disponibles y el tracking se omite. Se muestra como banner informativo en Dashboard y Budget.
Referencia de precios de tokens
Los costes se calculan con las tarifas en PricingHelper. Tarifas aproximadas:
| Provider | Modelo | Input (por 1M tokens) | Output (por 1M tokens) |
|---|---|---|---|
| Claude | Haiku 4.5 | $0.80 | $4.00 |
| Claude | Sonnet 4 | $3.00 | $15.00 |
| Claude | Opus 4.1 | $15.00 | $75.00 |
| OpenAI | GPT-4o mini | $0.15 | $0.60 |
| OpenAI | GPT-4o | $2.50 | $10.00 |
| Gemini | Flash 2.0 | $0.075 | $0.30 |
| Groq | Llama 3.3 70B | $0.59 | $0.79 |
Tarifas aproximadas y sujetas a cambios. Verifica siempre en la página de precios del proveedor.
Permisos
| Capability | Acceso |
|---|---|
joomlaai.budget / wpai_manage_budget | Crear y editar reglas |
core.admin / manage_options | Eliminar reglas |
core.manage / wpai_dashboard | Ver budget (solo lectura) |
_Última actualización: 2026-05-19 · v2.5.3_
