> For the complete documentation index, see [llms.txt](https://docs.meganova.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meganova.ai/character-studio/pricing-credits/credit-system.md).

# Credit System

> **Note:** Credits are the currency for AI operations in Character Studio. Understand how credits are consumed and managed.

## Overview

The credit system provides:

* **Transparent pricing** — Know costs upfront
* **Pay-as-you-go** — Only pay for what you use
* **No expiration** — Credits never expire
* **Detailed tracking** — See where credits go

## How Credits Work

### Credit Units

Credits are consumed by AI operations:

| Operation            | Credit Cost       |
| -------------------- | ----------------- |
| Chat message         | Varies by model   |
| Image generation     | Varies by model   |
| AI-assisted creation | Varies by feature |

### Model Pricing

Different AI models have different costs:

| Model Tier      | Cost Range    |
| --------------- | ------------- |
| Economy models  | Lower cost    |
| Standard models | Moderate cost |
| Premium models  | Higher cost   |

### Token-Based Pricing

Chat costs are based on tokens:

```
Cost = (Input Tokens × Input Rate) + (Output Tokens × Output Rate)
```

* **Input tokens**: Your message + character definition + context
* **Output tokens**: AI's response

## Viewing Credit Balance

### Header Display

Your credit balance appears in the header:

### Detailed View

For detailed information:

1. Click on credit balance
2. Or go to **Settings** → **Credits**

### Usage Breakdown

See where credits are spent:

| Category         | Percentage |
| ---------------- | ---------- |
| Chat             | XX%        |
| Image Generation | XX%        |
| AI Assistance    | XX%        |

## Purchasing Credits

### Credit Packages

Available packages:

| Package  | Credits   | Price |
| -------- | --------- | ----- |
| Starter  | X credits | $X    |
| Standard | X credits | $X    |
| Pro      | X credits | $X    |

### Payment Methods

Accepted payment methods:

* Credit/debit cards
* Stripe payment processing

### Purchase Process

1. Go to **Settings** → **Credits**
2. Click **Buy Credits**
3. Select package
4. Complete payment
5. Credits added instantly

## Credit Consumption

### Chat Messages

Each chat message consumes credits based on:

* **Model selected** — Premium models cost more
* **Context size** — Longer conversations cost more
* **Response length** — Longer responses cost more

### Image Generation

Image generation costs depend on:

* **Model** — Different image models have different costs
* **Size** — Larger images may cost more
* **Quality** — Higher quality settings cost more

### AI-Assisted Features

Features that use AI:

| Feature             | Typical Cost |
| ------------------- | ------------ |
| Quick Create        | X credits    |
| Agent Mode          | X credits    |
| Blueprint AI assist | X credits    |
| Lorebook generation | X credits    |

## Cost Optimization

### Choose Appropriate Models

Match model to task:

| Task             | Recommended    |
| ---------------- | -------------- |
| Casual chat      | Economy model  |
| Creative writing | Standard model |
| Complex tasks    | Premium model  |

### Manage Context Size

Reduce context costs:

* Keep character definitions concise
* Use lorebooks efficiently
* Start new sessions when appropriate

### Monitor Usage

Track spending:

1. Review usage breakdown regularly
2. Identify high-cost patterns
3. Adjust settings as needed

## Low Balance Warnings

### Warning Thresholds

You'll be notified when:

* Balance falls below warning threshold
* Balance is critically low
* Balance is depleted

### Low Balance Behavior

When credits run out:

* Chat features pause
* You can still browse and edit
* Purchase credits to continue

## Credit History

### Transaction Log

View all credit transactions:

* Purchases
* Consumption
* Bonuses

### Export History

Download transaction history:

1. Go to **Settings** → **Credits**
2. Click **Export History**
3. Choose date range
4. Download CSV

## Subscription Credits

### Monthly Bonus

Subscribers receive monthly credits:

| Tier       | Monthly Credits |
| ---------- | --------------- |
| Free       | X credits       |
| Pro        | X credits       |
| Enterprise | X credits       |

### Bonus Timing

* Credits added at subscription renewal
* Unused bonus credits don't roll over
* Purchased credits never expire

## See Also

* [Subscription Tiers](https://docs.meganova.ai/character-studio/pricing-credits/subscription-tiers.md) — Plan benefits
* [Advanced Settings](https://docs.meganova.ai/character-studio/character-features/advanced-settings.md) — Model selection
* [Storage Quotas](https://docs.meganova.ai/character-studio/pricing-credits/storage-quotas.md) — Storage limits
