Credits
What credits are, what spends them, and when they come back.
On this page
Credits are the unit Modulify meters AI work in. Everything the model does on your behalf draws them down, and nothing else does.
Credits belong to a workspace
The balance sits on the workspace, not on your account. Everyone with access to a workspace draws from the same pool, and the work a teammate runs shows up as your balance falling.
If you belong to two workspaces you have two balances. Switching workspaces switches which one you are spending.
Only the workspace owner can buy more or change the plan. Anyone else who runs out sees the balance and the plan page, with the buttons disabled.
An extra workspace needs its own paid plan
The workspace you were given when you signed up gets its plan's credits on Free. A workspace you create yourself does not: on the Free plan it is allowed zero credits and its sites are locked. Put it on a paid plan and both come back.
What a balance is made of
Two pools add up to the number you see.
Subscription credits are the monthly allowance from your plan. They are the number the progress bar measures.
Top up credits are packs you bought outright. They sit alongside the allowance and are not touched by the monthly reset.
The plan and credits window breaks both out under the bar, as Subscription credits 62 / 100 and Top up credits 200, alongside Next reset.
Spending drains top up credits first, and only falls through to the subscription allowance once the top up pool is empty.
What spends credits
| Work | What it costs |
|---|---|
| A chat turn that builds or edits | Metered on the tokens the turn actually used |
| Generating or editing an image | 1 credit per image, 2 at 4K |
Images are added on top of the turn that asked for them, so a message that writes a section and generates two pictures is charged for both.
A chat turn has no flat price. A one-line copy change and a full page build run on the same rate and land on very different numbers, and you can read the real figure for any finished message from its Info row. See Models and effort.
What does not spend credits
Reading files, browsing your project, previewing, publishing and hosting are all free. So is everything the dashboard does: searching, moving projects between folders, inviting members, connecting a domain.
Running out of credits stops you building. It does not take your published site down.
Your plan changes the rate
The same work costs a different number of credits depending on the plan the workspace is on.
| Plan | Credit rate |
|---|---|
| Free | $0.25 per credit |
| Starter | $0.25 per credit |
| Pro | $0.50 per credit |
| Enterprise | $0.25 per credit |
A Pro credit is worth twice a Starter credit, and costs twice as much. Identical work bills half as many credits on Pro as it does on Starter. That is why Starter and Pro both show 100 included credits at $25 and $50: the credit counts match, the work they buy does not.
When credits come back
On a paid plan the subscription allowance resets at the start of each calendar month, and the balance card names the date: Resets on Sep 1, 2026. Modulify emails the workspace owner when it happens.
The reset refills the allowance. It does not clear top up credits, which carry on until they are spent.
On the Free plan credits do not reset. The 35 credits are granted once. The balance card says so, reading Credits reset monthly on paid plans. To get a recurring allowance you either move to a paid plan or buy a credit pack.
Overspending carries over
A turn is charged after it runs, so a long generation can finish slightly past zero. The overshoot is not forgiven and not double-charged: it carries into the next month as usage already spent, so the first reset after an overspend starts you below the full allowance by exactly the amount you went over.
Running out
When the balance reaches zero, the credits bar above the chat box swaps its counter for an Upgrade or Top Up button, and sending a message opens that flow instead of building. Messages already queued stop rather than being dropped, and the queue reads Paused because the workspace is out of credits.
Creating a new site from a prompt is refused the same way, with You have run out of AI credits, top up to generate a new site.
If you are not the owner, the top up button is disabled with the tooltip Only the workspace owner can add credits.
From an AI client over MCP
get_workspace_credits returns the reconciled balance and get_workspace_credit_usage shows the recent spend day by day, which is how an assistant can answer where your credits went rather than only how many are left. Both need workspaces:read, ticked by default.
Buying credits is not available over MCP, because it charges a card.
See MCP tools.
Next
- Buy credits walks through a top up.
- Plans compares the included allowances.
- Models and effort explains what makes one turn cost more than another.