anoman
Concept

Quota & overage

Your monthly allowance, the caps that protect it, what happens when you hit one, and how to watch your usage.

Monthly allowance

One allowance, resets every month

Flat tiers (Starter, Pro) get a monthly weighted-token allowance. It resets by calendar month — on the 1st, your used count returns to zero regardless of when you subscribed. PAYG has no fixed allowance; it pays raw provider cost plus a small 0–5% volume markup.

Calendar-month reset. The allowance window is the calendar month, decoupled from your billing date — even on annual billing, the quota still resets monthly.

Per-class caps

Caps per model tier class

On top of the overall allowance, each customer has weekly and monthly token caps per model tier class (budget / mid / premium / ultra). A Starter can't reach Premium or Ultra classes, and a Pro can't exceed its class caps. Hitting a cap returns 402 token_quota_exceeded with the class and window that tripped.

HTTP/1.1 402 Payment Required
content-type: application/json

{
  "detail": {
    "error": "token_quota_exceeded",
    "model_tier_class": "premium",
    "window": "monthly"
  }
}

The model_tier_class field tells you which model class hit the cap; window is either weekly or monthly. Switch to a lower-cost model class or raise the cap with a token pack.

Overage vs. block

What happens when the allowance runs out

When a flat tier's allowance is exhausted, the outcome depends on a per-account overage toggle:

  • Overage enabled: further usage draws down your prepaid balance instead of being blocked.
  • Overage disabled: the request is blocked with 402 until the next reset or a top-up.
  • PAYG never blocks on quota — it has no fixed allowance and always bills raw cost + a 0–5% volume markup.

Burst guards

RPM / TPM are separate from quota

Rate limits are not the same thing as your token quota. RPM (requests/min) and TPM (tokens/min) are anti-flood burst guards that return 429 rate_limit_exceeded — a temporary throttle, not a spend cap. Your monthly token quota returns 402 token_quota_exceeded instead. Burst credits (token packs) can temporarily raise a class's token cap from prepaid balance.

See Rate Limits for per-tier RPM/TPM/inflight numbers, the response headers, and backoff patterns.

Check your usage

Watch weighted tokens live

The dashboard Usage page shows weighted tokens used vs. allowance and the reset date. Programmatically, call the subscription quota endpoint with your API key.

curl https://api.anoman.io/anoman/v1/subscription/quota \
  -H "Authorization: Bearer anm-sk-..."

Enterprise and PAYG return a limit of 0, meaning no fixed monthly cap applies.

Watch your quota

The Usage page shows exactly how many weighted tokens you have left and when they reset.

Open UsagePlans & billing