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

# Billing and credits

> How usage is priced and charged, and how to cap spend.

Antara bills usage in USD from your organization's prepaid **credit balance**. Each model has a price per million input, cached input, and output tokens (`pricing` in `GET /v1/models`). Reasoning tokens are output tokens.

## Adding credits

In the console's **Billing** page you can:

* Buy credits as you go: $20, $100, \$500, or a custom amount.
* Subscribe to a plan (Developer, Growth, or Scale). Each plan's monthly price comes back as the same amount of credit, and higher plans grant a higher [rate-limit tier](https://docs.antarah.dev/guides/rate-limits.md).
* Turn on auto-reload, which buys credits when the balance drops below a threshold.

Credits don't expire. Prices and plans are listed by `GET /v1/plans` (no authentication needed).

## How a request is charged

1. **Admission.** The request needs an available balance above zero, and spend under any [spend limit](#spend-limits). Antara reserves the request's estimated cost.
2. **Settlement.** When it finishes, the actual tokens are charged and the reservation is released.

Because admission only needs a positive balance, one request can take the balance a little below zero; the next one then gets `402 insufficient_credits`.

| Case | Charged |
| - | - |
| Completed request | Its actual tokens |
| You close the stream early, or the model fails mid-stream | The input, and the output delivered until then |
| Blocked by a request policy | Nothing |
| Blocked by a response policy | The tokens the model generated |
| Failed upstream before any output, or `503 policy_evaluation_unavailable` | Nothing |
| `count_tokens`, policy judge calls | Never |

## Spend limits

Set a monthly cap on the organization or on a project (UTC calendar month). When month-to-date spend reaches it, requests get `402 spend_limit_reached` until the next month or until you raise it. Manage limits in the console or with the [spend limit endpoints](https://docs.antarah.dev/api-reference/introduction.md) and an Admin API key with `spend_limits:write`.

## Checking usage

| Need | Endpoint |
| - | - |
| Lifetime credits granted and used | `GET /v1/credits` (project key; may lag up to 5 seconds) |
| Available, reserved, and owed balance | `GET /v1/organization/balance` |
| Tokens and requests over time | `GET /v1/organization/usage/completions` |
| Daily costs | `GET /v1/organization/costs` |

```bash theme={null}
curl https://api.antarah.dev/v1/credits -H "Authorization: Bearer $ANTARA_API_KEY"
# {"data":{"total_credits":25.0,"total_usage":3.4172}}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.