/balance in the workspace or CLI.
Plans
Each plan includes everything in the plans above it. A team workspace without a plan gets its 20 free credits once, not every month. See pricing for current offers, and manage your plan, top-ups, and auto-recharge in Billing.
What uses credits
Every browser task is charged a 0.1-credit floor when you submit it, so you need available credits to start. When the task finishes, it is charged any usage above the floor, whether it succeeded or not. Only an
ERROR or EXHAUSTED task keeps the floor and nothing more.
A browser submission can be rejected because of an account limit even when the overall balance is positive. Browser trial limits and in-flight caps are separate from your credit allowance.
AI Gateway calls
Calls to the AI Gateway, including the AI features in apps you build on pre.dev, are charged from each call’s metered usage at the model’s credit price. The price per model is listed onGET /v1/models: each row carries a predev object with credits_per_m_input and credits_per_m_output and, where the model has them, prices such as credits_per_m_cache_read, credits_per_m_cache_write, credits_per_image, and credits_per_request. Read those numbers rather than deriving prices yourself.
Worked example: a model whose row lists credits_per_m_input: 20 and credits_per_m_output: 100 costs 0.2 credits for 10,000 input tokens plus 0.2 credits for 2,000 output tokens, so a call of that size settles at about 0.4 credits.
- Plugin costs, such as web search, are part of the call’s charge.
- With
modelsfallbacks, you pay the price of the model that answered. - Streams settle when they end. If your client disconnects mid-stream, the call is charged for what the model generated.
- Video jobs are charged when a status poll reports completion, and submitting one needs at least 10 credits available. See images and video.
- Catalog reads are free.
x-predev-credits-charged and the balance in x-predev-credits-remaining. GET /v1/usage breaks the last 1 to 90 days down by model and path.
Free allowance. A Free workspace can spend 5 credits on gateway calls in total, whatever its credit balance. After that, every call returns 402 with code subscription_required until the workspace subscribes.
Out of credits. A workspace without enough credits for a call gets 402 with code insufficient_credits before anything is sent to the model, so nothing is generated or charged. Turn on auto-recharge in billing to keep a live app running when the balance would otherwise reach zero. See AI Gateway errors.
Limits
Check usage and recover
/balanceshows the account balance.- The credits pill next to the composer shows what the current project has used. Select it for Credits on this project: a newest-first ledger of turns with the phase, model, tokens, and credits for each.
/usagein the CLI shows the same breakdown in the terminal.- In the CLI,
/topupand/upgradeopen billing.
API and MCP access
The Architect API and the MCP server are included with the Premium, Pro, Team, and Enterprise plans. Plus accounts, and team workspaces without an active plan, can connect and generate 3 specifications as a trial; after that, generation returns403. Free accounts cannot authenticate to the Architect API or MCP.
Browser Agents REST and the AI Gateway accept every account, including Free. See authentication for how each interface checks keys and errors and retries for access errors.
