Credits and throttling
Credits are the unit Custodos uses to measure model usage. This page explains where credits come from, what uses them and what happens when they are used up for the month.
Last checked on 28 September 2026
On this page
What a credit is
Every request to a model uses credits. How many depends on the model and on the amount of text it processes: your message, the chat so far, attached files and the reply. One credit equals one cent in your workspace's billing currency.
Credits are not an extra price. They are included in your seats, and Custodos invoices nothing beyond the allowance. When the budget is used up, you keep working on a cheaper model instead of running up costs. The throttling section below describes this.
Where credits come from
Every seat brings a fixed number of credits each month, a bigger seat more than a smaller one. Normally a seat's credits are the personal monthly budget of the person who sits in it. Admins cannot raise this budget separately: more budget comes with a bigger seat, see Plans and seats.
Unused credits do not pass to colleagues and expire at the end of the billing month. On the billing day a new month starts with a full budget.
If your workspace holds a Pack balance, it does not expire. Someone who has used up their monthly budget draws on that balance first, before throttling applies.
What uses credits
Credits are used wherever a model works or an external service is queried. The model picker shows an estimate per reply for every model. The actual amount is only known once the reply is complete.
| Activity | What drives usage |
|---|---|
| Chat replies | The model, the length of the chat, attached files and the length of the reply. Models that think before answering use more than the length of the reply suggests. |
| Web search | Every search costs extra on top of the reply. Deep Search triggers several searches. |
| Generating images | Every generated image. |
| Documents in the Company Brain | Processing new documents counts towards usage. |
| Company Brain in the chat | The passages from the Brain that are passed to the model. Retrieval set to Automatic passes only relevant passages and so saves credits. |
When the monthly budget is nearly used up
Once you have used 90% of your personal monthly budget, a note appears below the message field: Your monthly budget is nearly used up. It resets on …. The date appears in place of the dots.
This is the only advance notice. Custodos does not send an e-mail about it. If the workspace holds a pack balance, the note does not appear, because you will continue on that balance.
Members do not see a running count of their budget. Admins find the figures per person on the Usage page.
Throttling: keep working instead of stopping
When the budget is used up, Custodos does not lock the chat. You keep working on a low-cost model until the budget resets on the billing day. The note in the chat names that model. Until then the model picker is locked and shows Model locked while the monthly credits are used up.
Throttling applies to one person when their monthly budget is used up, and to everyone when the credits of the whole workspace are used up.
| Situation | Note in the chat | Affects |
|---|---|---|
| Personal monthly budget used up | Your personal monthly budget is used up. You keep working on … until it resets. | this person only |
| Workspace credits used up | Monthly credits are used up. Everyone keeps working on … until the credits reset. | everyone in the workspace |
What is paused during throttling
The economy model keeps answering your messages. Everything that would cause extra cost pauses until the reset:
- Switching the model.
- Web search.
- Generating images.
- Access to connected cloud accounts and to Outlook in the chat.
- The model's own search in the Company Brain. Relevant passages from the selected Brains are still passed along.
- The help in the Create tab when setting up an agent. The fields can still be filled in by hand.
- The summary of new documents in the Company Brain. Documents with text are still added and searchable. Scanned pages and images that a model first has to read are not processed during this time.
When throttling ends
On the billing day a new month starts and everyone works with the model of their choice again. Throttling ends earlier when credits become available again.
For a single person, a bigger seat helps: a higher seat applies immediately and brings its budget with it. If the credits of the whole workspace are used up, additional or bigger seats help. If you need more credits beyond that, contact the Custodos team.
Read next
Still have a question? Write to us.
