Quick StartUsage and billing
Search docs...⌘K

Billing

Usage and billing

The Usage page helps you understand plan consumption, Extra Usage, and available balance during the current subscription cycle. It is an in-cycle risk view, not the final invoice.

What you see

In Dashboard Usage, you can review the main consumption sources for the current subscription cycle:

  • Plan Used: how much of the included plan allowance is used.
  • Extra Usage: usage that has exceeded, or may exceed, included plan allowance.
  • Available Balance: balance still available for Extra Usage after known overage risk.
  • AI by Hast / LiteLLM: usage related to AI model calls.
  • Email: email usage after the included email quota is exceeded.
  • Bandwidth: outbound bandwidth after the included bandwidth quota is exceeded.

The goal is to show risk early. It does not replace the final billing record.

Key concepts

Plan allowance
The active subscription defines monthly AI budget, email quota, bandwidth quota, agent limits, and feature access.

AI usage
Agent model calls produce AI usage. When live usage is available, the page uses it for the current cycle. When it is unavailable, related values are hidden instead of showing an optimistic balance.

Email and bandwidth
Email and Bandwidth come from usage events recorded in the current cycle. They are event-based records, not a live stream of every in-flight request.

Balance
Top-ups increase account balance. Balance can be used for Extra Usage and may also participate in renewal logic. The available balance shown on Usage subtracts known overage risk for the current cycle.

Extra Usage

When included AI budget is exhausted, Extra Usage can continue AI requests by consuming account balance. This helps avoid an immediate stop when the plan budget is used up.

Keep these details in mind:

  • Extra Usage consumes account balance.
  • Email and bandwidth overage can reserve part of the balance first.
  • If live AI usage is temporarily unavailable, the page hides some values or shows unavailable state instead of unreliable numbers.
  • If balance is insufficient, Extra Usage may be limited.

Renewal and balance

Each subscription cycle has a start and end time. Renewal can happen in a few ways:

  • Automatic renewal: the system attempts renewal at the cycle boundary.
  • Manual early renewal: you prepare the next cycle before the current one ends.
  • Paid next-cycle schedule: a paid renewal becomes active when the current cycle ends.

Early renewal usually does not extend the current cycle immediately. It prepares the next cycle, and the renewal task advances the subscription after the current cycle ends.

Debug unexpected numbers

If Usage or Billing does not look right, check in this order:

  1. Confirm the subscription is active.
  2. Check whether there is a paid next-cycle renewal that has not taken effect yet.
  3. Check whether live AI usage is available; when unavailable, the page hides some values.
  4. Check whether email or bandwidth overage exists in the current cycle.
  5. Check whether Extra Usage is enabled and whether account balance is sufficient.

If those checks look normal but the page is still inconsistent, capture the page, plan, agent ID, and approximate time before contacting support.

Hast Docs - Usage and billing