Billing and budget caps
What the workspace has actually spent, against the caps it set for itself.
The billing screen at Settings, Billing shows measured usage against the budget caps this workspace has configured. It is admin only.
This is a usage meter, not an invoice
The screen reports what the workspace used and what limits it set for itself. It states no price, produces no bill, and says nothing about what anybody is charged.
What it shows
Spend. Today, this month, and last month. Months are calendar months in UTC, so "this month" restarts on the first.
A projection for month end. A straight-line extrapolation from spend so far. It is directional, and it is flagged when it would land above the monthly cap.
A daily chart. Spend per day over a window, 30 days by default and up to 180. Every day in the window is present, including days with no spend, which report zero.
Top categories this month. The buckets the underlying ledger records against, covering language model calls, embeddings, reranking, speech synthesis, speech recognition and integration calls.
Top models this month. Per model, the number of calls and the spend, highest first.
Everything comes from a per-workspace cost ledger, so it is a record of what actually happened rather than a forecast.
Budget caps
Two caps exist: a daily one and a monthly one. They are set on workspace settings, and Adjust caps on the billing screen links there.
A cap that is not configured is not the same as a cap of zero. An unset cap means no cap is configured.
The billing screen reads the caps and shows spend against them, so an unset cap shows spend with nothing to measure it against.
Reading it through the API
Two operations back this screen:
GET /v1/workspace/billingfor the snapshot and the per-model breakdown.GET /v1/workspace/billing/timeseriesfor the daily series, the category breakdown and the month-end projection.
Both are admin only. See the API reference.