Brainstormer uses a credit-based billing system. Your organization has a credit wallet that is debited each time your agents do work that involves an AI provider — such as responding to a message, searching a knowledge base, or synthesizing speech.Documentation Index
Fetch the complete documentation index at: https://docs.brainstormer.io/llms.txt
Use this file to discover all available pages before exploring further.
What credits are
Credits are the unit of value in Brainstormer. When you add funds to your organization, those funds are converted into credits and held in your wallet. Every billable action deducts a small number of credits from that balance. This approach means you pay for what you use, with full visibility into exactly where your credits went.What consumes credits
| Activity | Description |
|---|---|
| Agent chat completions | Every message your agent sends uses tokens from the underlying AI model. Credits are charged based on token consumption. |
| Knowledge base searches | Querying a knowledge base retrieves and embeds content using an embedding model. Each search deducts a small amount. |
| Document indexing | Uploading and processing documents into a knowledge base uses embedding and vector storage operations. |
| Voice synthesis | When an agent responds with a synthesized voice, the text-to-speech operation is metered per character or session. |
| File processing | Uploading files to a conversation for analysis incurs a small storage and retrieval cost. |
Credit consumption depends heavily on the AI model you choose for your agent. Larger, more capable models (such as GPT-4o or Claude 3 Opus) cost significantly more per token than smaller models. You can see the model configured for each agent in Agents → [Agent name] → Basic Info.
The Credits page
Go to Credits in the sidebar to see your organization’s billing summary. The page shows three key numbers at a glance:- Credit balance — credits currently available to spend
- Current plan — your active subscription plan and its status
- Credits used — total credits consumed since account creation, with a progress bar against total purchased
Transaction history
Every credit movement — whether a purchase, a plan allocation, or a usage deduction — is recorded in the Transaction History ledger below the summary cards. Each row shows:- Date — when the transaction occurred
- Type — what caused it (plan credits, credit purchase, usage, refund, etc.)
- Provider — the AI provider involved, if applicable
- Credits — the amount added (green) or deducted (red)
- USD — the dollar value of the transaction
- Balance — your wallet balance immediately after the transaction
Topping up credits
To add credits to your organization’s wallet, go to Credits and follow the top-up flow. Purchased credits are added immediately and recorded as a Credit Purchase entry in the ledger.Usage analytics
For a breakdown of credit consumption by agent, time period, or model, go to Analytics in the sidebar. The Analytics page shows:- Real-time metrics for your organization
- Usage trends over custom date ranges (today, 7 days, 30 days, 90 days, or a custom window)
- Per-agent and per-model breakdowns
- Filterable, exportable reports
Why did my balance decrease when I didn't start a conversation?
Why did my balance decrease when I didn't start a conversation?
Background operations can consume credits too. When you upload a document to a knowledge base, Brainstormer processes and indexes it using an embedding model — this deducts a small number of credits even if no one has chatted yet. Check the Transaction History on the Credits page: the Type column will show the operation that caused the deduction, and the Provider column will show which service was involved.
How do I see a breakdown by agent?
How do I see a breakdown by agent?
Go to Analytics and use the Filters panel to select a specific agent from the Bot dropdown. The usage charts and overview metrics will update to show only that agent’s activity. You can also set a date range to narrow the time window.
What happens when my balance reaches zero?
What happens when my balance reaches zero?
When your credit balance is depleted, agent interactions that require an AI provider call will fail until you top up. Knowledge base searches, voice synthesis, and file processing are all affected. Top up your wallet from the Credits page to restore service.
Do credits expire?
Do credits expire?
Credits you purchase do not expire. Plan credits allocated at the start of a billing cycle follow your plan’s terms. Check your plan details on the Credits page under Current Plan.
Can I see which model is costing the most?
Can I see which model is costing the most?
Yes. The Analytics page includes a model-level breakdown. Use the Filters panel to focus on a specific model, or view the full usage chart to compare model costs side by side across your organization.