> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/others/usage.md).

# Usage Calculation

{% hint style="success" %}
✨ **MaiAgent fully adopts the Credits billing system starting 2026/06/02** — multiple enterprise customers (finance, government, retail, and other industries) have already upgraded early. This page explains how Credits are calculated. If you are still on the legacy word-count system (during the contract transition period), refer to the "[Legacy Word-Count Calculation (Transition Period)](#legacy-word-count)" section below.

For a complete explanation of the Credits system, see [Credits Billing System](/maiagent-user-guide/maiagent-user-guide-en/org/credits.md). To evaluate an early upgrade, contact <sales@maiagent.ai>.
{% endhint %}

## Credits Calculation <a href="#credits-calculation" id="credits-calculation"></a>

### Different Models, Different Rates — Configure Flexibly <a href="#per-model-pricing" id="per-model-pricing"></a>

Each AI conversation consumes Credits based on the model used, calculated as **Credits per 1 million tokens**, with **Input and Output priced separately**.

* Lightweight models (e.g., Claude 4.5 Haiku, GPT-5-mini) consume fewer Credits — the best choice for customer service FAQs and general Q\&A
* Flagship models (e.g., Claude 4.6 Opus, GPT-5) consume more Credits — the best choice for in-depth analysis and high-quality content creation
* **Budget control is in your hands** — multiple AI assistants can each use different models, with Credits deducted at the corresponding model-tier rate, allowing you to optimize costs by use case
* View the full rate table at <mark style="color:blue;">**Organization Settings**</mark> → <mark style="color:blue;">**Credits**</mark> → <mark style="color:blue;">**Pricing**</mark>

### Multimodal Features: One Quota Covers Everything <a href="#multimodal-features" id="multimodal-features"></a>

Previously, advanced features such as **voice assistants, meeting transcription, and contact centers** required separate add-on purchases. Other multimodal features (image generation, voice, document parsing) were converted to word counts and deducted from the main quota (e.g., 1 image = 500 words).\
**After upgrading, all features are available by default, each with its own independent Credits rate**, making billing more intuitive:

* **Image generation**: billed by resolution and model
* **Speech-to-text (STT)**: billed by audio duration
* **Text-to-speech (TTS)**: billed by character count
* **Document parsing**: billed by page count or file size
* **Web search**: billed by number of queries
* **AI assistant tool calls**: billed by tool type

### Usage Example <a href="#usage-example" id="usage-example"></a>

Using the most common model, **Claude 4.5 Haiku**, as an example:

* A customer service conversation of approximately 500 words → consumes approximately **25–50 Credits**
* Purchasing 1,000,000 Credits → supports **tens of thousands** of customer service conversations\
  — and can also be used for voice, image generation, document parsing, and other features

## Knowledge Base Storage Calculation <a href="#knowledge-base-storage" id="knowledge-base-storage"></a>

The total **file size** across all knowledge base upload pages for all AI assistants in the organization represents the knowledge base storage used.

* When a file is deleted, its storage is no longer counted
* Knowledge base storage limits vary by plan — see [Trial and Subscription Plans](/maiagent-user-guide/maiagent-user-guide-en/others/trial-and-plans.md)

## Usage Inquiry <a href="#usage-query" id="usage-query"></a>

Go to <mark style="color:blue;">**Organization Settings**</mark> → <mark style="color:blue;">**Credits**</mark> to view:

* **Overview**: real-time Credits balance, expiring quota, and monthly usage trends
* **Deposit History**: the source of each Credits entry (plan allocation, add-on purchase, bonus, etc.) and validity period, deducted on a FIFO basis
* **Consumption History**: detailed usage entries, filterable by date, type, and AI assistant, with **CSV export support for financial reconciliation**
* **Pricing**: detailed rates for all models and features

***

## Legacy Word-Count Calculation (Transition Period) <a href="#legacy-word-count" id="legacy-word-count"></a>

{% hint style="warning" %}
Before 2026/06/02, organizations still on the word-count system will have usage calculated as described below. **After that date, the system will automatically convert to the Credits system**, and your remaining word-count quota will be automatically converted at **1 word = 1 Credit** with no reduction.\
Want to upgrade early and enjoy the full feature set? Contact <sales@maiagent.ai>.
{% endhint %}

### General Text Calculation <a href="#legacy-text-calculation" id="legacy-text-calculation"></a>

* In each conversation turn, both **user input** and **AI assistant replies** are counted
* One character counts as one word

For example: user input `Hello!` counts as 6 words, and an AI reply `您好` counts as 2 words, for a total of 8 words.

```
User: Hello!
AI Assistant: 您好
```

### Image Calculation <a href="#legacy-image-calculation" id="legacy-image-calculation"></a>

Each image counts as **500** words.

### Usage Inquiry (Legacy) <a href="#legacy-usage-query" id="legacy-usage-query"></a>

Organizations on the legacy word-count system can view current usage at <mark style="color:blue;">**Organization Settings**</mark> → <mark style="color:blue;">**Usage Statistics**</mark>.

***

## FAQ <a href="#faq" id="faq"></a>

### Q: Is storage still counted after a file is deleted? <a href="#faq-deleted-file" id="faq-deleted-file"></a>

No, it is no longer counted after deletion.

### Q: Will I be automatically converted to the Credits system? <a href="#faq-auto-migration" id="faq-auto-migration"></a>

Yes. **Before 2026/06/02**, all organizations that have not yet switched will be automatically converted to the Credits system. Any remaining word-count quota will be automatically converted at 1 word = 1 Credit, **with no reduction**. See [Credits Billing System](/maiagent-user-guide/maiagent-user-guide-en/org/credits.md) for details.

### Q: Can I upgrade early? <a href="#faq-early-upgrade" id="faq-early-upgrade"></a>

Yes! Multiple enterprise customers (finance, government, retail, and other industries) have already upgraded early to enjoy the full feature set. Email <sales@maiagent.ai> and our sales team will provide a customized migration recommendation for you.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/others/usage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.