⚡ नवीन — Kimi K3 आता लाइव: तुमची Moonshot की जोडा →
दस्तऐवज

Cap spend by team, not by seats

← कुकबुक

Set monthly ₹ budgets at every level — org, team, workspace, member and key — plus per-provider caps, so runaway usage stops itself instead of surprising you.

Hierarchical budgets (budgets, not seats)खर्चमध्यम10 min

BharatRouter meters real ₹, not seats — so you govern spend with budgets, not licence counts. Every level of the hierarchy carries an optional monthly cap in rupees; when a scope crosses its cap, further requests on it are refused rather than silently billed.

You'll use: hierarchical monthly budgets, managed on the dashboard and readable via the /me/budgets API. Reference: Teams & budgets.

The budget hierarchy

Caps nest from the whole org down to a single API key. A request must fit under every cap above it, so the tightest applicable budget wins.

ScopeWhat it capsTypical use
OrgTotal monthly spend across everythingThe hard ceiling for the company
TeamA department / product lineGive Payments ₹2L, Support ₹50k
WorkspaceA project inside a teamRing-fence a pilot
MemberOne person's usageA default budget for every joiner
API keyA single key (human or agent)Cap a CI bot or a shared service

Cap a specific provider or model

Beyond the level caps, a scoped budget limits spend on one provider or model inside a workspace — e.g. "no more than ₹5,000/month on a premium global model, unlimited on the cheap India route". A route at or over its scoped cap is skipped by the router, so traffic degrades to a cheaper model instead of failing.

Get warned before the wall

  • Threshold alerts fire as a scope approaches its cap (50/80/100%), so a budget owner hears about it before requests start bouncing.
  • When a cap is hit, the request returns a clear budget error — your app can queue, downgrade, or ask for a top-up instead of erroring blind.
  • Budgets apply identically to humans and agents: a runaway agent loop stops at its key's cap, protecting the whole org ceiling above it.

Budgets are a governance control, not a payment method — see Billing for how spend is invoiced, and Usage to break down where the ₹ actually went.

आणखी रेसिपी कुकबुक मध्ये पाहा, किंवा संपूर्णAPI reference पाहा.