> For the complete documentation index, see [llms.txt](https://docs.toucanai.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toucanai.cloud/getting-started/credits-and-usage.md).

# Credits & Usage

Toucan AI uses a credit-based system. Credits are consumed each time a user sends a message or triggers an AI action. Your plan includes a monthly credit allowance that resets each billing cycle.

#### **How credits work**

Each interaction deducts credits from your account's balance. The cost depends on the type and complexity of the request:

| Interaction                           | Indicative credit cost |
| ------------------------------------- | ---------------------- |
| Single question (standard)            | \~50 credits           |
| Single question (complex, multi-step) | Up to 100 credits      |
| Self-service dashboard creation       | \~950 credits          |
| Metadata enrichment                   | \~120 credits          |

Your monthly credit allowance depends on your plan:

| Plan  | Credits/month |
| ----- | ------------- |
| Start | 50,000        |
| Grow  | 100,000       |

At standard usage, 50,000 credits covers approximately **1,000 questions** — or a mix of questions and dashboard configurations.

{% hint style="info" %}
Credit costs are indicative and may vary depending on request complexity.
{% endhint %}

#### **Monitor your usage**

You can check your remaining credits at any time from **Settings → Usage**. The dashboard shows credits used and remaining for the current billing period.

<details>

<summary><strong>FAQ</strong></summary>

**When do my credits reset?** Credits reset every month on your billing renewal date.

**What happens if I run out of credits?** AI interactions will be paused until your credits reset. Contact your account manager if you need to increase your allowance.

**Why did a request cost more than expected?** Credit costs are indicative. Complex or multi-step requests may consume more credits depending on the amount of processing involved.

</details>


---

# 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.toucanai.cloud/getting-started/credits-and-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.