Skip to main content
An Astro AI token spending cap sets a monthly limit, in US dollars, on your Organization’s Astro AI token spend. When your spend reaches the cap, Astro blocks new AI requests for the whole Organization until the cap resets.

​
What counts toward the cap

The cap measures your total Astro AI token spend. This total is the sum of both billable line items:
  • Model Chargeback
  • Intelligence fee
Requests that use your own model provider (bring your own model) don’t create Astro AI token spend, so they don’t count toward the cap. The cap resets at 00:00 UTC on the first day of each month.

​
Prerequisites

  • The Organization Owner or Organization Billing Admin role.
  • AI features enabled for your Organization. See Toggle AI features for your Organization. If AI features are disabled, the setting shows N/A.

​
Set the cap

  1. In the Astro UI, click Organization Settings, then click Billing.
  2. In the Policies section, find Astro AI token spending cap.
  3. Enter a monthly limit in US dollars and save your changes.
The Policies section shows the status of the cap: OK while spend is under the cap, or IN_ALARM after spend reaches it.

​
What happens when the cap is reached

When the cap status changes to IN_ALARM, Astro rejects new AI requests from every user in your Organization until the cap resets. This applies to every surface that uses Astro AI, including: Blocked requests fail with a usage limit error. To restore access before the monthly reset, increase or remove the cap.
The cap is a soft limit. Requests that are already running when the cap is reached can finish, so your total spend can go slightly above the cap.
Astro doesn’t send a warning or email before the cap is reached. Check the cap status on the Billing page to monitor it.