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

# Credits and usage: compressions, AI credits, top-ups

> Understand how Fluximage compression credits and AI credits work, when they reset each month, and how purchased top-up credits extend your capacity.

Fluximage uses two separate credit types to track your usage: **compression credits** and **AI credits**. Each type covers a different set of features, resets on a monthly cycle, and has its own per-plan allocation.

## Compression credits

Compression credits are consumed each time you process an image through Fluximage — whether you use the dashboard uploader or the API. One image processed equals one compression credit used.

| Plan    | Compression credits per month |
| ------- | ----------------------------- |
| Free    | 20                            |
| Starter | 200                           |
| Pro     | Unlimited                     |
| Agency  | Unlimited                     |

## AI credits

AI credits are consumed when you use AI-powered features: **AI alt text generation** or **SEO rename**. Using both features on the same image still costs only **1 AI credit** for that image.

| Plan    | AI credits per month |
| ------- | -------------------- |
| Free    | 0                    |
| Starter | 200                  |
| Pro     | 1,000                |
| Agency  | 10,000               |

## Top-up credits

If you run out of your monthly AI credit allocation before the period resets, you can purchase top-up credits. Top-up credits are additional AI credits that **never expire** — they carry over indefinitely and are consumed only after your monthly allocation has been fully used.

<Tip>
  Top-up credits are a good option if you regularly run out of AI credits mid-month. Because they never expire, any unused top-ups roll over and remain available in future billing periods.
</Tip>

## Monthly reset

Both compression credits and AI credits reset at the start of each billing period.

<Note>
  Your credits reset on your **billing period start date**, not on the 1st of the calendar month. The exact reset date depends on when you originally subscribed. Top-up credits are not affected by the monthly reset — they are never cleared.
</Note>

## Viewing your usage

Your current-period usage is shown directly on the **Dashboard**, including:

* Compressions used vs. your monthly limit
* AI credits used and remaining (monthly allocation plus any top-up balance)

You can also retrieve your current usage state programmatically via the API (Agency plan with an API key required):

```bash theme={null}
curl https://fluximage.app/api/usage \
  -H "Authorization: Bearer flx_live_your_key_here"
```

The response includes the following fields:

| Field                  | Description                                         |
| ---------------------- | --------------------------------------------------- |
| `plan`                 | Your current plan name                              |
| `compressor_used`      | Images compressed this billing period               |
| `compressor_limit`     | Your plan's monthly compression limit               |
| `ia_credits_used`      | AI credits consumed this billing period             |
| `ia_credits_monthly`   | Your plan's monthly AI credit allocation            |
| `ia_topup_credits`     | Remaining non-expiring top-up credits               |
| `ia_credits_remaining` | Total AI credits still available (monthly + top-up) |
| `canCompress`          | `true` if you can still compress images this period |
| `canUseIA`             | `true` if you have AI credits available             |