Budgets

Budgets let you set spending limits at multiple scopes and enforce them automatically. Modelux tracks per-request cost across every provider and applies your budget rules in real time.

Scopes

A budget applies to one of:

• Organization — total spend across all projects
• Project — spend on a specific project
• End-user — spend per end-user tag
• Tag — spend scoped by any custom tag key

Caps

Each budget has:

• Monthly cap — reset on the 1st of each month, or a custom reset schedule
• Soft cap — alert threshold (defaults to 80%)
• Hard cap — enforcement action when reached

Actions

When a hard cap is hit, Modelux can:

• Alert only — send an email / webhook; continue serving
• Auto-downgrade — automatically route to a cheaper model (configured per budget)
• Block — return 402 Payment Required with an upgrade prompt

Alerts

Every budget supports multiple alert thresholds with configurable actions. Alerts fire via:

• Email to designated recipients
• Webhook (Slack-compatible format supported)
• Dashboard banner

Forecasting

Modelux shows a projected end-of-month spend based on current rate, plus period-over-period comparisons so you can catch cost regressions quickly.