# Credits, usage and limits

<Term id="credits">Credits</Term> pay for usage across Klarety. **1 credit is 1 US dollar.** <Term id="studio">Studios</Term>, <Term id="nexus">Nexus</Term> queries and storage, deployed apps, AI replies and <Term id="run">agent runs</Term> all draw from one balance, shown in <AppLink to="settings.usage" /> (account menu, **Credits**).

## Where credits come from [#where-credits-come-from]

| Kind | Where it comes from | When it ends |
| --- | --- | --- |
| **Plan credits** (Monthly credits) | Your Pro plan, every month | Reset at renewal. Unused credits do not roll over. |
| **Additional credits** | **Buy more credits** | No expiry. Used after plan credits. |

<Callout type="info" title="Free Trial credits">
  The Free Trial includes credits to try everything. Monthly credits come with Pro. See [Plans and billing](/docs/workspace/billing).
</Callout>

## Read your balance [#read-your-balance]

<ForEveryone>
The tiles at the top of <AppLink to="settings.usage" /> show:

- **Credit balance**, split into plan credits and additional credits.
- **Month-to-date cost**.
- **Credit runway**: how long credits last at recent usage.
- **Forecasted cost to renewal**, after one full day of usage.

<Screenshot src="/docs/_media/usage-progress-bars.png" alt="The credit tiles on Usage and limits" />
</ForEveryone>

<ForDevelopers>
```python title="balance.py"
from klarety import Nexus

nx = Nexus.connect("YOUR_API_KEY")
print(nx.account().credits)
print(nx.limits())
```

Over HTTP, read your plan's limits with `GET /v1/limits`. See [Limits](/docs/developers/limits).
</ForDevelopers>

## See where credits go [#see-where-credits-go]

**Cost and usage** breaks spend down by service: **Nexus**, **Studios**, **Deploy**, **AI** and **Seats and projects**.

- Filter by **Project**, **Member**, **Service** and **Date range** (presets from **This month** to **Last 90 days**, or a custom range up to 92 days).
- **By project** and **By member** show who spent what.
- Select a service to see its **Cost breakdown**.

<Screenshot src="/docs/_media/usage-daily-spend-by-service.png" alt="Cost and usage with the Project, Member, Service and Date range filters and the By project view" />

## Transactions [#transactions]

**Transactions** lists every credit movement, newest first, with **Date**, **Description**, **User**, **Credits** and **Project**, following the filters above.

| Description | Meaning |
| --- | --- |
| Monthly credits | Plan credits added at renewal |
| Credit purchase | Credits you bought |
| Usage | Credits spent |
| Refund / Adjustment by Klarety | Credits returned or corrected |
| Expired at renewal | Unused plan credits removed |

A usage line can be marked "reserved" (credits held while work runs) and "unused reservation returned" (what was not spent).

<Callout type="info" title="Owners and admins only">
  Only owners and admins see Transactions, buy credits or change monthly credits.
</Callout>

<Screenshot src="/docs/_media/usage-transactions-table.png" alt="The Transactions table on Usage" />

## Usage and limits [#usage-and-limits]

**Usage and limits** compares usage with your plan: projects, seats, active Studios, Studio storage, Nexus storage, app images, live apps, data transfer out and logs. A bar turns to **Approaching limit** and then **Limit reached**.

Usage above the included amount is billed from credits, up to your plan's limit. Where you can buy more, select **Purchase**; otherwise **Contact us**.

## Add-ons [#add-ons]

**Add-ons** are billed from credits monthly, on top of your plan: additional seats, active Studios, Studio storage, Nexus storage, live apps, app image storage, always-on apps, projects and secrets. Each shows its monthly cost, plus a **Monthly total**.

<Callout type="warn" title="Add-ons renew every month">
  An add-on is charged the day you add it, then at each renewal. Remove it in Usage and limits when done.
</Callout>

## Buy more credits [#buy-more-credits]

<Steps>
<Step>
### Open the dialog [#open-the-dialog]
In <AppLink to="settings.usage" />, select **Buy more credits** (or **Monthly credits**).
</Step>
<Step>
### Choose an amount [#choose-an-amount]
Enter a **New monthly amount** above your current one. You see what you pay today and what you get from the next renewal. The renewal date does not change.

<Screenshot src="/docs/_media/settings-billing.png" alt="The Buy more credits dialog with New monthly amount and the pay-today summary" />
</Step>
<Step>
### Pay [#pay]
Select **Pay** to confirm.
</Step>
</Steps>

A smaller amount lowers monthly credits from your next renewal; this month stays as is and nothing is refunded.

## When credits run out [#when-credits-run-out]

<Callout type="error" title="Usage pauses, data stays">
  With no credits left, usage pauses until you buy more or your plan renews. No data is deleted.
</Callout>

## Next steps [#next-steps]

- [Plans and billing](/docs/workspace/billing)
- [Members and roles](/docs/workspace/members)
- [Limits for developers](/docs/developers/limits)