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

# Account & Billing

> Credits, cost preflight, and reading your balance and usage.

ContentHero bills generation in **credits**. Pricing is computed server-side per operation, based on the model, resolution, duration, and mode. The developer tools let you read your balance and preview any cost before it happens.

## Read your balance

<Tabs>
  <Tab title="MCP">
    Call `get_balance`. It returns your current credit balance.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    contenthero account balance
    ```
  </Tab>

  <Tab title="Raw API">
    ```bash theme={null}
    curl https://app.contenthero.ai/api/v1/account/balance \
      -H "Authorization: Bearer $CONTENTHERO_API_KEY"
    ```
  </Tab>
</Tabs>

## Preview cost before you spend

Every cost can be previewed for free. The preview takes the exact same parameters as the real generation, so the quoted price matches what you will be charged.

<Tabs>
  <Tab title="MCP">
    Pass `getCost: true` on any `generate_*` call. It returns the price and submits no job.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    contenthero generate image --prompt "..." --model nano-banana-2 --cost
    ```
  </Tab>
</Tabs>

<Note>
  Always preview cost before a large or batched generation, and show it to the user. This is a hard rule for agents.
</Note>

## Usage attribution

Charges made with an API key are attributed to that key, so you can see which integration consumed what. Per-key usage is visible in the API Keys view in the app.

## Plans and limits

Some features are plan-limited (for example, the brand knowledge base caps items per brand kit by tier). When you hit a cap, the response says so. Upgrade the plan in the app, or remove an item to make room.