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

# Billing & credits

> Understand the metrics Fimo bills on — AI credits, environment and agent hours, and bandwidth — and how to check your balance.

Fimo meters usage in a few units. This page explains **what each metric means**, not what it costs — for current prices and plan limits, always check the [pricing page](https://fimo.ai/pricing).

## What an AI credit is

Credits power Fimo's AI features — chat, image generation, and agent runs. They come from four pools, drawn down in a fixed order (daily free, then monthly, then awarded, then purchased):

<Columns cols={2}>
  <Card title="Daily free" icon="calendar-day">
    A small pool that resets every day, available on all plans.
  </Card>

  <Card title="Monthly" icon="calendar">
    A larger pool included with your plan; resets each billing cycle.
  </Card>

  <Card title="Purchased" icon="cart-shopping">
    Bought with real money. These don't expire.
  </Card>

  <Card title="Awarded" icon="gift">
    Earned through referrals or promotions. These don't expire either.
  </Card>
</Columns>

## Beyond credits

Credits cover AI work. Your plan may also account for other kinds of usage — broadly:

* **Compute** — the time your environments and scheduled agents spend building and running work in the cloud runtime.
* **Bandwidth** — data served from your live site to visitors.

How each of these is counted, what's included in your plan, and what happens when you reach a limit are all defined on the [pricing page](https://fimo.ai/pricing) — treat it as the source of truth. Credits and usage belong to the **organization** that owns a project, not to a branch or environment.

<Note>
  When AI credits run low you're warned in the app, and you keep going by upgrading your plan or buying more credits.
</Note>

## Check your balance

`fimo credits` is a read-only view of your organization's AI credit balance:

```bash theme={null}
fimo credits
fimo credits --json                   # machine-readable, for tools and agents
fimo credits --project <project-id>
```

The output has three parts: **Available now** (total spendable across all pools, with an `OK` / `Low` / `Unavailable` status), a **breakdown** of the pools that make up that total, and a **daily allowance** section that explains plan limits — the allowance is *not* extra balance to add on top.

<Note>
  `fimo credits` never buys or refills credits. To purchase credits or change plans, use the billing UI — it charges the payment method on file after your confirmation.
</Note>

## What's next

<Columns cols={3}>
  <Card title="Pricing" icon="tag" href="https://fimo.ai/pricing">
    Current prices, plans, and limits.
  </Card>

  <Card title="Organizations" icon="building" href="/docs/collaboration/organizations">
    Billing is scoped to the organization.
  </Card>

  <Card title="Billing in Studio" icon="table-cells" href="/docs/studio/overview">
    Buy credits and upgrade from the dashboard.
  </Card>
</Columns>