> ## 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

> Understand how AI credits work, what each operation costs, and how credits are allocated across plans.

AI credits are the currency for all AI-powered features in EcomWize Builder. Every AI operation -- from rewriting a headline to generating an image -- costs a specific number of credits.

## Credit Costs by Operation

| Operation                      | Credit Cost | Description                                 |
| ------------------------------ | ----------- | ------------------------------------------- |
| **Content rewriting**          | 1 credit    | Rewrite a text field using AI chatbox       |
| **Section content generation** | 10 credits  | Generate all text content for a new section |
| **Image generation (1K)**      | 30 credits  | Generate a 1024x1024 image from a prompt    |
| **Image generation (2K)**      | 60 credits  | Generate a 2048x2048 image from a prompt    |

<Note>
  Avatar selection from the built-in avatar library is free and does not cost any credits.
</Note>

## Credits by Plan

Each plan includes a monthly allocation of AI credits:

| Plan        | Monthly Credits | Price      |
| ----------- | --------------- | ---------- |
| **Free**    | 250 credits     | \$0/month  |
| **Starter** | 1,000 credits   | \$49/month |
| **Pro**     | 5,000 credits   | \$79/month |

Credits refresh at the beginning of each billing cycle. Unused credits do not roll over to the next month.

<Tip>
  With 250 free credits, you can perform up to 250 content rewrites, 25 section generations, or 8 image generations at 1K resolution -- or any combination of these.
</Tip>

## Checking Your Credit Balance

Your current credit balance is displayed in three places:

1. **AI Chatbox** -- The credit count appears next to the input field at the bottom of the builder canvas.
2. **Image Generation Modal** -- Your balance is shown at the top of the image generation interface.
3. **Settings** -- Open Settings from your account menu and go to the **Plans & Billing** section to see your credits remaining with a visual progress bar.

The balance updates in real-time after each AI operation completes.

## What Happens When You Run Out

When you attempt an AI operation without sufficient credits:

1. An error message appears showing your current balance and the credits required for the operation.
2. You are prompted to upgrade your plan for more credits.
3. The AI operation is cancelled -- no partial results are generated.

<Warning>
  Credit checks happen before the AI operation starts. If you have exactly enough credits, the operation will proceed. If you are even 1 credit short, the operation will be blocked entirely.
</Warning>

## Managing Your Credits

<AccordionGroup>
  <Accordion title="Prioritize high-impact operations">
    Content rewrites at 1 credit each are the most cost-effective AI feature. Use them liberally for polishing copy. Reserve image generation credits for key visuals like hero images.
  </Accordion>

  <Accordion title="Use 1K resolution first">
    When generating images, start with 1K resolution (30 credits) to test your prompt. Only upgrade to 2K (60 credits) when you need the final high-resolution version.
  </Accordion>

  <Accordion title="Upgrade when needed">
    If you consistently run out of credits, upgrading from Free to Starter gives you 4x the credits. Upgrading from Starter to Pro gives you 5x the credits.
  </Accordion>
</AccordionGroup>

## Credit Cost Examples

Here are some practical scenarios to help you estimate credit usage:

**Building a 10-section landing page with AI assistance (Starter plan):**

* 10 section content generations = 100 credits
* 15 content rewrites for fine-tuning = 15 credits
* 3 hero/banner images at 1K = 90 credits
* **Total: 205 credits**

**Building multiple pages with heavy AI usage:**

* 30 section content generations = 300 credits
* 50 content rewrites = 50 credits
* 10 images at 1K = 300 credits
* 2 images at 2K = 120 credits
* **Total: 770 credits** (requires Starter plan)

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Do unused credits roll over to the next month?">
    No. Credits reset to your plan's monthly allocation at the start of each billing cycle. Unused credits from the previous month are not carried forward.
  </Accordion>

  <Accordion title="Can I purchase additional credits without upgrading my plan?">
    Currently, credits are tied to your subscription plan. To get more credits, upgrade to a higher plan tier.
  </Accordion>

  <Accordion title="Are credits shared across team members?">
    Credits are allocated per user account. Each team member has their own credit balance based on their individual plan.
  </Accordion>

  <Accordion title="What if an AI operation fails -- do I still lose credits?">
    Credits are only deducted after a successful AI operation. If the operation fails due to a server error, your credits are not charged.
  </Accordion>
</AccordionGroup>