<!-- source: https://modelux.ai/docs/concepts/budgets -->

> Spend caps, alerts, and auto-downgrade.

# 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.
