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

# Plans & Credits

> Understand how token usage and credits work in Cattus

export const PRICING_URL = "https://cattus.ai/";

export const APP_URL = "https://platform.cattus.ai/";

## Overview

Cattus offers two plans to fit your needs: a **Free plan** for getting started and a **Premium plan** for power users. Both plans include access to multiple AI models and features, with different usage limits.

<Card title="View All Plans" icon="crown" href={PRICING_URL} horizontal>
  Compare plans and upgrade to Premium for more tokens and image generations.
</Card>

## What are Tokens?

Think of tokens as small pieces of text. A token can be a word, part of a word, or even a punctuation mark. For example:

* The word "hello" is typically 1 token
* The word "understanding" might be 2-3 tokens
* A sentence like "How are you?" is about 4-5 tokens

You don't need to count tokens yourself—Cattus automatically tracks your usage. On average:

* **1,000 tokens** ≈ 750 words
* **20,000 tokens** ≈ 30,000 words (about 120 pages of text)
* **1,500,000 tokens** ≈ 1,125,000 words (about 2,250 pages of text)

<Info>
  Tokens include both what you write and what the AI responds with, plus any conversation history.
</Info>

## Plan Comparison

| Feature               | Free Plan            | Premium Plan         |
| --------------------- | -------------------- | -------------------- |
| **Monthly Tokens**    | 20,000 tokens        | 1,500,000 tokens     |
| **Image Generations** | 1 image per month    | 25 images per month  |
| **AI Models**         | Access to all models | Access to all models |
| **Web Search**        | ✓ Included           | ✓ Included           |
| **File Upload**       | ✓ Included           | ✓ Included           |
| **File Limit**        | 20 MB per file       | 20 MB per file       |
| **Vocal Chat**        | ✓ Included           | ✓ Included           |
| **Reset Period**      | Monthly              | Monthly              |

<CardGroup cols={2}>
  <Card title="Free Plan" icon="rocket" href={APP_URL}>
    Perfect for trying out Cattus and occasional use. Start for free today.
  </Card>

  <Card title="Premium Plan" icon="crown" href={PRICING_URL}>
    Ideal for regular users who need more capacity for conversations and images.
  </Card>
</CardGroup>

## How Token Usage is Calculated

Every time you send a message to an AI model, your token usage includes three components:

| Component                | Description                                   | Example                              |
| ------------------------ | --------------------------------------------- | ------------------------------------ |
| **Your Message**         | Tokens in the message you send                | "Write a poem about cats" ≈ 6 tokens |
| **AI Response**          | Tokens in the AI's reply                      | A short poem ≈ 100-200 tokens        |
| **Conversation Context** | Previous messages in the conversation history | Past exchanges ≈ varies by length    |

### Example Calculation

Let's say you're having a conversation:

1. **You write**: "Explain what tokens are" (5 tokens)
2. **AI responds**: With a detailed explanation (150 tokens)
3. **Conversation history**: Your previous 2 exchanges (300 tokens)

**Total for this message**: 5 + 150 + 300 = **455 tokens**

<Tip>
  Longer conversations use more tokens because the AI needs context from previous messages to give relevant answers. Starting a new conversation resets the context.
</Tip>

## Image Generation Credits

Image generation is tracked separately from text tokens:

* Each image you generate counts as **1 image generation**, regardless of which AI image model you use (GPT Image, Stable Diffusion, etc.)
* All image models count toward the same limit
* Image generations do not consume your token allowance

<Info>
  Whether you generate a simple icon or a complex artwork, it counts as one image generation.
</Info>

## Usage Reset

Your usage limits reset automatically at the beginning of each calendar month:

* **Token count** resets to 0
* **Image generation count** resets to 0
* Unused tokens and image generations do not roll over to the next month

<CardGroup cols={2}>
  <Card title="Check Your Usage" icon="chart-line">
    View your current token and image usage in your account analytics.
  </Card>

  <Card title="Upgrade Anytime" icon="arrow-up">
    Need more capacity? Upgrade to Premium instantly—your new limits take effect immediately.
  </Card>
</CardGroup>

## Tips for Managing Your Usage

<AccordionGroup>
  <Accordion title="Start New Conversations for Unrelated Topics">
    Starting a fresh conversation reduces context size, saving tokens on messages that don't need previous history.
  </Accordion>

  <Accordion title="Be Concise When Possible">
    Clear, focused questions often get better answers while using fewer tokens.
  </Accordion>

  <Accordion title="Choose the Right Model">
    Some models may generate longer or shorter responses. Experiment to find the balance that works for you.
  </Accordion>

  <Accordion title="Monitor Your Usage">
    Check your account analytics regularly to track how many tokens and images you have remaining.
  </Accordion>
</AccordionGroup>

## Ready to Get Started?

<CardGroup cols={1}>
  <Card title="Start Free" icon="rocket" href={APP_URL}>
    Create your free account and get 80,000 tokens to explore Cattus.
  </Card>
</CardGroup>