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

# AI Credits System

> Understand how AI credits work, what they cost, and how to manage your credit balance in EcomWize Builder.

AI credits are the currency for all AI-powered features in EcomWize Builder. Every AI operation -- from rewriting text to generating images -- costs a specific number of credits. Your plan determines how many credits you receive each month.

## Credit Allocation by Plan

| Plan    | Credits per Month |
| ------- | ----------------- |
| Free    | 250               |
| Starter | 1,000             |
| Pro     | 5,000             |

<Note>
  Credits refresh at the beginning of each billing cycle for paid plans. Unused credits do not roll over to the next month.
</Note>

## Credit Costs

Different AI operations consume different amounts of credits based on their computational cost:

| Operation                 | Credit Cost | Description                                       |
| ------------------------- | ----------- | ------------------------------------------------- |
| **Text rewriting**        | 1 credit    | Rewrite a section's text content using AI prompts |
| **Background removal**    | 1 credit    | Remove the background from an image               |
| **Section generation**    | 10 credits  | AI-generate content for an entire section         |
| **Page creation**         | 50 credits  | Creating a new page (includes initial setup)      |
| **Image generation (1K)** | 30 credits  | Generate a 1024x1024 AI image                     |
| **Image generation (2K)** | 60 credits  | Generate a 2048x2048 AI image                     |

### Understanding Credit Equivalents

To help you gauge how far your credits go:

<CardGroup cols={3}>
  <Card title="250 credits (Free)">
    * 250 text rewrites, or
    * 5 page creations, or
    * 8 AI images (1K), or
    * 25 section generations
  </Card>

  <Card title="1,000 credits (Starter)">
    * 1,000 text rewrites, or
    * 20 page creations, or
    * 33 AI images (1K), or
    * 100 section generations
  </Card>

  <Card title="5,000 credits (Pro)">
    * 5,000 text rewrites, or
    * 100 page creations, or
    * 166 AI images (1K), or
    * 500 section generations
  </Card>
</CardGroup>

<Tip>
  In practice, you will use a mix of operations. A typical page-building session might use 50 credits for page creation, 10-20 credits for text rewrites, and 30-60 credits for an AI image -- around 90-130 credits total.
</Tip>

## Checking Your Balance

Your current credit balance is visible in the AI Chatbox. The balance updates in real time as credits are consumed.

To check your exact balance:

<Steps>
  <Step title="Open the AI Chatbox">
    Your remaining credit count is displayed in the AI Chatbox panel.
  </Step>

  <Step title="Check before AI actions">
    Some UI elements show credit cost information before you confirm an action. For example, the image generation modal displays the credit cost for each resolution option.
  </Step>
</Steps>

## What Happens at Zero Credits

When your credit balance reaches zero:

* **AI text rewriting** will show an error indicating insufficient credits.
* **AI image generation** will display an error with your remaining balance and the required amount.
* **Section generation** will add the section without AI-generated content.
* **Page creation** will fail if you do not have enough credits for the creation cost.

<Warning>
  You cannot go into negative credits. Each AI operation checks your balance before processing. If you do not have enough credits, the operation is blocked and no credits are deducted.
</Warning>

## Monthly Refresh

For **Starter** and **Pro** plans, credits are reset to the full allocation at the beginning of each billing cycle when your subscription renews.

* **Starter**: Reset to 1,000 credits on renewal
* **Pro**: Reset to 5,000 credits on renewal

### Free Plan Credits

Free plan credits are set to 250. These credits refresh monthly but are intended for exploration and testing, not production use.

## Upgrading for More Credits

If you consistently run out of credits before the end of your billing cycle, consider upgrading your plan:

* **Free to Starter**: 4x more credits (250 to 1,000)
* **Starter to Pro**: 5x more credits (1,000 to 5,000)

When you upgrade, your credit balance is immediately reset to the new plan's allocation.