The four parts of billing
Plans
Free, Pro, Max, and Enterprise. Your plan sets your monthly credit allowance and your limits.
Credits
The unit ModuleX bills in. Credits meter managed runs, tool calls, model usage, and knowledge retrieval.
Wallet
A prepaid balance that covers usage beyond your plan allowance, with manual top-ups and auto top-up.
Usage gate
The check that runs before each piece of managed work, so you are never billed for work that could not be admitted.
How it works in one paragraph
Managed usage is priced in credits, where **100 credits cost 0.01). Each plan gives your organization a monthly credit allowance. As you use ModuleX, that allowance is drawn down. If you are on a paid plan and you turn on overage, work that goes beyond the allowance is paid for from your prepaid wallet. Before any managed run, tool call, model call, or knowledge retrieval starts, the usage gate confirms you have budget — so you are never charged for work that was not admitted.Credits at a glance
A credit is the single unit ModuleX bills in for managed usage. It maps to money at a fixed rate, so a credit balance is easy to reason about.100 credits = $1.00
Credits convert to dollars at a fixed rate of $0.01 per credit, the same rate for your plan allowance and your wallet.
One run = one credit
A single workflow run or one Assistant turn costs one credit, separate from any model or tool usage inside it.
Usage is metered
Model usage is metered by tokens, tool calls have a base cost, and each knowledge retrieval or document ingest costs a credit.
Plans and your allowance
Your plan decides your monthly credit allowance and your limits. The credit allowances below are the values ModuleX runs against.At the 50 of managed usage and Max’s 20,000 credits is worth $200. The Free allowance is a one-time grant to get you started, not a recurring monthly reset.
Managed vs bring-your-own-key (BYOK)
ModuleX gives you two ways to use models, tools, and knowledge. The difference is who runs the work and who bills for it.Managed usage
ModuleX provisions the model, tool, or vector store for you. This usage is metered in credits against your plan allowance and wallet. It is the default when you do not connect your own provider.
Bring your own key (BYOK)
You connect your own provider account. That usage is billed directly by the provider with no ModuleX credits charged — ModuleX records it for analytics only.
A simple way to remember it: if ModuleX runs it, it costs credits; if your own key runs it, it does not. You can mix the two — for example, use a ModuleX-managed model in one workflow and your own OpenAI or Anthropic key in another. Connecting your own providers is covered in LLM providers and Knowledge providers.
The wallet: covering work beyond your allowance
When your monthly allowance is used up, a paid organization can keep working by spending down a prepaid wallet.1
Turn on overage
On a paid plan, an owner or admin enables overage for the organization. Until it is on, work stops once the allowance is empty rather than spending the wallet.
2
Top up the wallet
Add a prepaid balance. A 0.01-per-credit rate as your plan.
3
Let auto top-up keep it funded (optional)
Auto top-up can refill the wallet automatically when the balance gets low, so usage is not interrupted.
Overage and the wallet are paid-plan features. The wallet only comes into play after your plan allowance is exhausted — your monthly credits are always spent first. The exact top-up limits, the auto top-up defaults, and how a balance is reconciled are in Wallet & top-ups.
The usage gate: checked before work begins
Every piece of managed work passes through a usage gate before it starts. The gate confirms your organization can pay for the work — checking your plan allowance, your wallet, and your limits — and only then does the work run. This is why you are never billed for work that could not be admitted. The gate applies to ModuleX’s managed-usage surfaces:Running workflows
Each managed workflow run is checked and metered before it executes.
The AI Composer
Turning plain English into a workflow runs through the gate per turn.
The Assistant
Each Assistant turn is admitted and metered before the agent acts.
Managed knowledge
Retrieval and document ingest on ModuleX-managed knowledge are metered.
Where billing lives
Billing belongs to the organization, not to an individual. The plan, the credit allowance, and the wallet are shared by everyone in the organization, and every run is metered against the organization it runs in. Managing the plan and the wallet is reserved for owners and admins — see Organizations, roles & membership.Keep going
Plans & pricing
Compare Free, Pro, Max, and Enterprise — allowances, limits, and pricing.
Credits & metering
Exactly what a credit is and what consumes credits.
Usage gating & limits
The gate and its 402, 403, and 429 responses, in detail.
Wallet & top-ups
The prepaid wallet, manual top-ups, and auto top-up.
Credits & the billing model
The concept behind it all — how managed usage is metered and where the gate applies.
Trials & dunning
Free trials, grace periods, and what happens if a payment fails.