Set a budget & ceiling
Create a spending budget, then apply it with a ceiling.
A budget defines how much can be spent and over what period of time. On its own, it doesn’t limit spending. To enforce a budget, you need to create a spend ceiling and apply it to an organization, workspace, or API key.
For the model behind scopes and periods, see Budgets.
Create a budget
From the dashboard, open Organization and select Spend & Budgets.
Click Add budget.
Follow the steps in the setup wizard:
Name: Give it a name (optional)
Amount: USD limit, or leave blank for no limit
Period: Daily, Weekly, or Monthly
Click Add budget.
The budget resets automatically at the start of each period, in UTC.
Apply a spend ceiling
A spend ceiling links a specific identity to a budget, defining what each budget actually limits. Every ceiling that applies to a request must be respected. For example, if both an organization-wide ceiling and a workspace ceiling apply, the request must stay within both limits. To create a ceiling:
In Spend & Budgets, click Add ceiling.
Follow the steps in the setup wizard:
Capping: Choose whether the ceiling applies to the entire organization or to a specific workspace.
Provider instance: Select a specific provider to limit spending for that provider only, or leave this blank to apply the ceiling across all providers.
Budget: Select the budget you want this ceiling to use.
Name: Optionally, give the ceiling a name to make it easier to identify.
Click Add ceiling to save it
Requests matching the ceiling count toward its budget. When the budget is exhausted, Otari blocks new matching requests until the next reset.
Confirm enforcement
Check the budget's status in Spend & Budgets. Green indicates less than 80% use. Yellow indicates 80–100% use. Red means the budget is exhausted.
Last updated
Was this helpful?
