Guide

Burst credits

Out of monthly allowance for a model tier class? Buy a burst token pack to keep going — without upgrading your whole plan.

What they are

Token packs, not rate multipliers

Changed in v9.8: Burst credits are no longer an RPM/RPD multiplier. They are token packs that raise your weighted-token cap for a model tier class. RPM/TPM are separate anti-flood guards.

When you've consumed your monthly weighted-token allowance for a model tier class (budget / mid / premium / ultra), buy a burst token pack to temporarily raise your cap for that class — so you can keep going without upgrading your plan. The pack is Redis-ephemeral and deducted from your prepaid balance.

For the flood guards (RPM/TPM/inflight) see Rate limits; for how the token allowance itself works see Quota & overage. Only flat tiers (Starter/Pro) need bursts — Enterprise and PAYG have no fixed quota.

Activate

Buy a burst pack

Call POST /anoman/v1/burst/activate with the model_tier_class to top up, the pack_tokens (how much headroom), and the duration_hours. It additively bumps your weekly/monthly cap for that class for the duration and returns the cost + remaining balance.

# Buy a burst token pack for a model tier class. Additively raises your
# weekly/monthly cap for that class for the duration. Deducted from prepaid balance.
curl https://api.anoman.io/anoman/v1/burst/activate \
  -H "Authorization: Bearer anm-sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model_tier_class": "premium",
    "pack_tokens": 5000000,
    "duration_hours": 24
  }'

# → 200
# {
#   "active": true,
#   "model_tier_class": "premium",
#   "weekly_bump": 5000000,
#   "monthly_bump": 5000000,
#   "cost_usd": 90.0,
#   "balance_after": "410.00",
#   "duration_hours": 24,
#   "seconds_remaining": 86400
# }

Manage

Status, pricing, cancel

Check the active burst with /burst/status, see which packs your tier can buy with /burst/pricing, and cancel early with /burst/deactivate (no refund on the unused portion).

# Current active burst for the key
curl https://api.anoman.io/anoman/v1/burst/status \
  -H "Authorization: Bearer anm-sk-..."

# Packs available for your tier (which classes, sizes, prices)
curl https://api.anoman.io/anoman/v1/burst/pricing \
  -H "Authorization: Bearer anm-sk-..."

# Cancel an active burst (no refund on the unused portion)
curl -X DELETE https://api.anoman.io/anoman/v1/burst/deactivate \
  -H "Authorization: Bearer anm-sk-..."

Class access

A pack must be for a class you can reach

A burst pack only adds headroom to a model tier class your plan already accesses. Buying a class you can't reach returns 400 class_not_accessible.

HTTP/1.1 400 Bad Request
content-type: application/json

{
  "error": {
    "type": "invalid_request_error",
    "code": "class_not_accessible",
    "message": "Your plan cannot access the 'ultra' model tier class."
  }
}
# A burst pack only adds headroom to a class your plan already reaches.
# Reach a new class by upgrading your plan, not by buying a burst.

To reach a new model tier class, upgrade your plan — a burst pack raises the cap of a class you already have, it never unlocks a new one.

Activate a burst

Buy and manage burst token packs from the Rate Limits page in your dashboard.

Open Rate Limits Back to docs