Spending controls
How spending caps and automatic top-ups behave.
For AI agents: https://bytekit.com/llms.txt — every docs page is available as markdown by appending .md
ByteKit has two distinct spending controls: a credit-overage cap and automatic top-ups of your USD balance.
Credit-overage spending cap
No standard plan is overage-enabled: Starter, Growth and Scale stop at the included credit allowance with 402 quota_exceeded, so this cap never applies to them. It applies only to a custom plan arranged with ByteKit that carries an overage agreement.
For a credit-metered request on such a plan, ByteKit compares the calculated overage cost with the account's max_overage_spend_cents. When the request would cross that limit, the API returns HTTP 402 with spending_cap_reached.
The current billing page does not expose a self-service control for this account-level overage cap. Contact support if it must be changed.
Automatic top-ups
The billing page lets an account administrator enable or disable auto-top-up and configure:
- the remaining value, in dollars, below which a top-up is triggered (at least $1);
- the dollar amount each top-up adds to your USD balance ($5 to $1,000); and
- a monthly cap on automatic top-up spending, from $1 to $1,000.
All three are required when auto-top-up is enabled, and the account must have a Stripe customer. Remaining value is your plan's remaining allowance plus your USD balance, priced at your plan's current top-up rate for the resource the request uses (bandwidth or search credits). When it falls below the configured threshold, ByteKit queues a top-up — unless that purchase would take this month's automatic top-up spending past the cap, in which case it is skipped until the next month. An account that has never stored a cap is uncapped, and the API reports its cap as null.
Your USD balance never expires, so there is no expiry to configure. See Top-ups for how the balance is spent and for the rollover rules that apply to plan allowance.