> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atamai.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits

> Understanding AI credits

# Credits

Credits are the unit of AI usage on AtamaiAgents.

**1 credit = 100 tokens**

Tokens are consumed every time your agent sends or receives a message to an AI model.

## Credit Limits by Plan

| Plan     | Credits/month |
| -------- | ------------- |
| Starter  | 40,000        |
| Pro      | 80,000        |
| Ultimate | 500,000       |

## Monitoring Usage

Your dashboard shows real-time credit usage with a color-coded progress bar:

* 🟢 Green — under 70% used
* 🟡 Yellow — 70–90% used
* 🔴 Red — over 90% used

When you hit 100%, your agent will stop responding until the next billing cycle resets your credits.

## What Uses Credits

| Action                                  | Approx. Credits |
| --------------------------------------- | --------------- |
| Short message (GPT-4o Mini)             | 1–2 credits     |
| Standard message (Claude Haiku)         | 3–5 credits     |
| Long reasoning response (Claude Sonnet) | 15–30 credits   |
| Document analysis (1,000 words)         | 10–20 credits   |

These are estimates. Actual usage depends on message length, model, and context window.

## Bring Your Own Key

Connect your own Anthropic, OpenAI, or Google API key to bypass platform credits entirely. See [AI Models → BYOK](/ai-models#bring-your-own-key).

## Credit Resets

Credits reset at the start of each billing cycle (monthly, on your signup date). Unused credits do not roll over.

## Running Out of Credits

If you run out mid-month, you have two options:

1. **Upgrade your plan** for more credits immediately
2. **Wait for reset** — credits refill automatically on your next billing date

Agents stop responding when credits hit 0 but retain all configuration and data.