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

# Check Usage

> Where to see your usage.

## Metering

1. **Reserve.** Expected usage is reserved before the provider call.
2. **Settle.** On success, the reservation settles for actual usage.
3. **Release.** A request that fails before producing usage is not charged.

## The `usage` Block

Every successful chat response includes one:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
"usage": { "prompt_tokens": 28, "completion_tokens": 64, "total_tokens": 92 }
```

Reasoning models add `reasoning_tokens`. Server-side tools add `server_tool_use` with counts such as `web_search_requests`. A call settled against a prepaid balance may carry `customer_cost`, an exact amount in integer nanos of the named currency (`1,000,000,000` per unit), so JavaScript clients keep precision.

On a stream, ask for the usage chunk with `stream_options.include_usage: true`. See [Streaming](/api/features/streaming).

## The Developer Console

The overview tab at [app.trynito.ai/api](https://app.trynito.ai/api) shows spend for the selected window, requests, token totals, spend by model, and a daily breakdown. Owners and admins also see active keys and last use. Views are per organization, not per key, and need a browser session rather than an API key.

## Failed Requests

* An error before the provider returns usage: not charged.
* A streaming failure after usage was recorded: settled for what was produced.

See [Safe Retries](/api/features/safe-retries).

## Related

<CardGroup cols={3}>
  <Card title="Plans" icon="tags" href="/plans">
    Funding and allowances.
  </Card>

  <Card title="Safe Retries" icon="rotate" href="/api/features/safe-retries">
    Retry without paying twice.
  </Card>

  <Card title="Developer Console" icon="terminal" href="/web-app/developer-console">
    Keys, usage, playground.
  </Card>
</CardGroup>

## Read balance from code

Owners and admins can use an admin-enabled key with [`GET /api/v1/billing/balance`](/api/api-reference/usage/get-balance). Amounts are integer USD nanos strings. This read returns available balance and top-up attribution; usage history remains in response `usage` blocks and the developer console.


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