Start typing to search the documentation.

Console navigation

Budgets

Budgets cap how much a workspace spends each month. Owners and admins set them from the Budget limits panel on the Members and Keys pages.

Budget levels

BudgetApplies toWhere to set it
WorkspaceCombined spend of everyone in the workspaceMembers or Keys › Monthly workspace budget
Default userEach member without a custom limitMembers › Monthly default user budget
Custom userOne memberMembers table or member page
Default service accountEach service account without a custom limitKeys › Monthly default service account budget
Custom service accountOne service accountService account page

A request must fit under both the workspace budget and the person’s own budget. Without any budget, spend is unlimited.

Workspace budget

The workspace budget blocks requests for everyone once the workspace reaches it.

  1. Open Members or Keys.
  2. In Budget limits, click Monthly workspace budget.
  3. Enter a Workspace limit in USD and click Save.

Member budgets

The default user budget applies to every member who has no custom limit. Set it under Monthly default user budget.

Give one member a custom limit from either place:

  • Click the Limit cell in their Members row and enter an amount.
  • Open the member and click Set User Budget under Monthly Budget.

Custom limits are highlighted in the Members table. Clear a custom limit to return the member to the default; the member page then shows Using Default.

Service account budgets

Service accounts work the same way. Set Monthly default service account budget on the Keys page, or open a service account and click Set Service Account Budget.

Amounts and resets

  • Amounts are in US dollars with up to two decimal places.
  • Budgets reset on the 1st of each month at 00:00 UTC.
  • A $0 budget blocks all spend that counts toward budgets.

What counts

SpendCounts toward budgets
Paid Console modelsYes
Models on your own providers with a price setYes, at the configured price
Web searchYes
Free modelsNo
Go usage within the planNo
Go extra usage paid from creditsYes

When a budget is reached

New requests fail with HTTP 429 until the budget resets or an admin raises it. The response does not say which budget was reached.

Upstream request failed: Account budget exceeded

Budgets are checked when a request starts. Requests already in progress finish, so spend can end slightly above the limit.

Track spend

Each member sees their own budget on Overview: the amount left, the amount spent, and the reset date.

Owners and admins of workspaces with more than one member also see Usage. It breaks down cost by day, model, and person, and the Export usage button downloads daily totals for the last 7, 30, or 90 days as CSV.

Automate budgets

Use the Budgets API to read every member’s budget and set custom limits from your own tools.