Credits
Where your AI credit balance comes from, how it is spent, and the three ways to add more.
Every AI action on your account, a chat reply, a generated image, a transcription, draws on one shared credit balance. This page covers where that balance comes from, how spending is tracked, and the three ways to add to it.
Where your balance comes from
Your membership plan's monthly allowance
Every paid membership tier bundles a number of AI credits a month, from 1,500 on Pro up to a per-tier allowance on the Enterprise tiers (Enterprise T3 is unlimited). The Free tier gets a daily drip instead of a lump sum: one credit every 24 hours, up to 30 in a period, so a brand-new account already has something to spend without a card on file.
An AI Workspace plan, on top of your membership
AI Workspace is a second, independent monthly subscription that adds its own credits and storage on top of whatever your membership already grants. Its ladder has a free tier and seven paid ones, each with more credits and storage than the one below. See AI Credits plans for the ladder.
A one-time credit pack
Bought once, charged once, never a subscription. See below.
A membership or AI Workspace allowance is minted into your balance when the invoice for that period is paid, not merely because you are subscribed to the plan. If a renewal has not been billed yet for the current period, the account heals itself: the next AI call re-derives the period's allowance from the plan you are on rather than leaving you short until the next invoice happens to fire.
Buy a one-time pack
Open the buy screen
From the credits ring or the credits pill wherever your balance is shown, open Add credits or upgrade.
Pick a pack
Three one-time packs are on offer: 250 credits for $10, 750 credits for $25 and 2,500 credits for $75,
priced in USD and converted to your billing currency. Add a
coupon code if you have one: validate_ai_credit_coupon prices the discount before anything is
charged, and the discounted total is what you see before you confirm.
Pay
Choose a saved card and confirm. purchase_ai_credits charges the card via Stripe and grants the
pack's credits the moment the charge succeeds; your balance updates immediately over the socket
connection, with no page reload needed.
A bought pack sits in its own top-up pool, separate from your plan's period allowance. The period allowance resets every billing period and does not roll over; a bought pack is kept until you spend it, however long that takes.
How spending is tracked
Every credit-spending call checks your balance and any credit rules on the account before doing any AI work, never after, so there is no overage to settle later. If the balance and the rules allow it, the work runs and the spend is recorded against the current period; if not, the call is refused before anything runs and nothing is spent on the refused attempt.
get_credit_usage_history returns a day-by-day breakdown, by account, by profile or by team member:
total spent, number of calls, the busiest day, and spend by model. get_credit_management returns
the full picture together: the rules in force, live usage per scope, the granted pool, and the model
catalog those rules can restrict.
Reading your own balance and usage history is available on every plan. Setting limits needs the Team plan or higher, and only the account owner can change them: a soft limit that warns and a hard limit that blocks, per profile and per team member, freezing a profile's or a member's spending, and a list of the AI models each profile may or may not use.
Three ways to get more credits
Every one of these opens from the same buy screen: Add credits or upgrade shows the pack picker alongside links to the membership and AI Workspace ladders, so whichever one fits is one click away.
Balances at a glance
Your balance is shown wherever the credit ring or credit pill appears: it drains as you spend,
stepping through amber toward red as it runs low, with a corner mark once it gets there. The same
figures are available at any time as used and max for the current period, plus a breakdown by
source (plan allowance, AI Workspace allowance, and any top-up packs still unspent) when your
account draws from more than one.
What happens when you run out
Once your balance is spent, the next AI call is refused before it runs. In the dashboard the reply stream stops with a prompt to add credits; in a longer job like generating a site, the buy screen opens in its place. Buying a pack or upgrading a plan lets you retry right away.