This feature is available for team accounts only. Personal accounts or accounts not part of a team can see the menu but cannot access budget management. You can convert your personal account to a team account or join an existing team via the Team Settings page.
Permissions
- Team Owner, Admin, and Billing roles can view and modify budgets for all team members and their API Keys.
- Developer and Basic roles can only view their own budget type and limits (including their API Keys). They cannot make changes.
Member Budgets and API Key Budgets
You can control spending at two levels:- Member budget: A ceiling on everything a member spends across all services (LLM API, GPU instances, sandbox, etc.)
- API Key budget: A separate spending cap for that Key’s LLM API usage only. GPU instances, sandbox, and other services are not counted against Key budgets, but do count toward the member budget.
- A Key’s budget is exhausted → that Key is paused; the member’s other Keys and GPU services are unaffected.
- The member’s budget is exhausted → all services under that member are paused. For GPU instances and other time-billed products, no new resources can be created; existing resources continue until the end of their billing cycle.
Budget Types
Both member budgets and API Key budgets support the same three types and can be configured independently:| Type | Description | Reset Behavior |
|---|---|---|
| Unlimited | No spending cap. Usage is still recorded for reporting. | None |
| Fixed Budget | A one-time total limit. Services pause when exhausted. | Does not reset. Admin must manually increase the limit to resume. |
| Monthly Budget | A per-month limit. Services pause when exhausted. | Resets automatically at 00:00 UTC on the 1st of each month. Unused balance does not carry over. |
- Member: Monthly $500 + Key: Monthly $100 → Standard two-tier control
- Member: Unlimited + Key: Monthly $50 → Trust the member overall, but cap a public-facing Key
- Member: Monthly $500 + Key: Fixed Budget $200 → Key is for a project with a defined total budget
”Not Set” vs. “Unlimited”
- Not Set: No budget has been configured for this member / Key yet. Admins should set this to avoid a management blind spot.
- Unlimited: The admin has intentionally chosen no limit. Review periodically.
Switching Budget Types
When changing a budget type, the system applies the following rules to existing usage and reset cycles:| Switch Direction | Used Amount | Reset Behavior |
|---|---|---|
| Unlimited → Fixed Budget | Starts from $0. No prior usage carried over. | No reset. |
| Fixed Budget → Monthly Budget | Historical usage is retained and displayed. New monthly tracking begins from the moment of the switch. | First monthly reset on the 1st of next month. |
| Monthly Budget → Fixed Budget | Current used amount is retained. Monthly reset stops. | No further resets. |
| Any → Unlimited | Budget configuration is cleared. | Unrestricted immediately. |
Monthly Budget Details
Automatic Reset
Monthly budgets reset at 00:00 UTC on the 1st of each month: used amount is zeroed out and the full limit is restored. Unused balance does not roll over to the next month.Adjusting Monthly Limits
Admins can update the monthly limit at any time. Changes take effect immediately. Remaining balance = new limit − amount already used this month. Common scenarios:- Increase limit: Available balance increases immediately. If services were paused, they resume right away.
- Decrease limit: Available balance decreases. If the new limit is below the amount already used, services pause immediately and resume once the limit is raised again.
- Fixed Budget — adding more quota: Increase the budget limit directly. Manual reset of used amount is not supported.
Setting Member Budgets
-
Go to the Budgets page. Find the target member in the list, or use the search box.
-
Click Edit, select a budget type, and enter the limit amount.
- New members default to Unlimited. This can be changed at any time.
- Fixed Budget and Monthly Budget types require a specific amount.
-
Click Refresh to load the latest budget and usage data.
Setting API Key Budgets
Primary entry: Go to the Budgets page and click View API Keys on a member row. A panel opens showing all Keys under that member, where you can view and edit their budgets. Secondary entry: Go to LLM API → API Keys. Budget status labels are shown in the Key list. Click a Key’s details to be redirected to the Budgets page for configuration. API Key budgets support the same three types as member budgets (Unlimited / Fixed Budget / Monthly Budget) and are configured in the same way.API Key budgets only apply to LLM API usage. GPU instances, sandbox, and other services are not subject to Key budget limits, but their costs still count toward the member’s total budget.
When an API Key is deleted, its budget configuration is automatically archived. Historical usage records are retained and remain accessible.
Budget Limit Reached
When a budget is exhausted, both the dashboard and API responses indicate which budget level was reached:- Member budget exhausted: “Your member budget has reached its limit ($200 / $200). All services are paused. Please contact your admin to adjust.”
- API Key budget exhausted: “API Key your-key-name has reached its budget limit ($50 / $50). Other Keys are not affected.”
- Both limits reached at the same time: The Key-level message is shown first, with the member budget status included as additional context.