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

# Credits & billing

> A real US-dollar balance, topped up through the payments provider, metered against vendor cost.

Naive Managed Agents billing is **real US dollars** — no abstract point currency. Your organization holds a balance; every action draws from it at metered cost.

## The balance

Your [organization](https://vetta.sh/docs/platform/organizations.md) has one balance, denominated in US dollars. Every agent it owns draws from the same balance.

```bash CLI theme={"system"}
vetta credits show
vetta credits ledger --limit 50     # every grant and charge
```

## Topping up

Add funds through a hosted checkout session with the payments provider. You can also set up a subscription that grants a monthly dollar allowance.

```bash CLI theme={"system"}
vetta credits topup --usd 50        # returns a checkout link
vetta credits show                  # current balance
vetta credits ledger --limit 20     # what the balance was spent on
```

```typescript TypeScript theme={"system"}
const checkout = await vetta.credits.topup({ usd: 50 });
console.log(checkout.url);
```

## How usage is metered

Costs are measured against **vendor invoices**, not list price, and drawn from the balance in real dollars. What you see quoted is what you are charged — see the [rate card](https://vetta.sh/docs/platform/pricing.md).

* **[Model calls](https://vetta.sh/docs/concepts/model-router.md)** — per token across five tiers, at the [completion window](https://vetta.sh/docs/concepts/completion-window.md) tariff.
* **[Computer](https://vetta.sh/docs/computer/limits-and-billing.md)** — per second while running; paused meters storage only; no creation fee.
* **[Priced tools](https://vetta.sh/docs/platform/pricing.md#priced-tools)** — [`web_search`/`web_fetch`](https://vetta.sh/docs/capabilities/tools#web-tools) per call, [`generate_image`/`generate_video`](https://vetta.sh/docs/capabilities/tools#generation-tools) per finished job.

![Quote before spend: every call is priced, checked against the budget cap and org balance, then either runs with an idempotent ledger entry or is refused with budget\_paused and nothing spent](https://mintcdn.com/vetta/rjfQyQrWaQ5bFTTq/images/quote-before-spend.svg?fit=max\&auto=format\&n=rjfQyQrWaQ5bFTTq\&q=85\&s=3d84f1c0ee3fd78de9de066afa0be56b)

Every charge is:

1. **Quoted before the call** and checked against your [budget](https://vetta.sh/docs/concepts/budgets.md) and balance.
2. **Recorded as an idempotent ledger entry** — the balance can never be double-charged for the same call.
3. **Floored at zero** — the wallet never goes negative; a small post-hoc overshoot is forgiven rather than clawed back.

## Reading spend

```bash CLI theme={"system"}
vetta agent spend agt_01j8rk2vq6m4zx9kp7n3c5hwae --by component   # model vs computer vs search vs media
vetta session get $SID                  # cost consumed by one run
```

Every ledger debit records the [5-tier token line items](https://vetta.sh/docs/concepts/model-router.md), the `session_id`, and the acting `actor`, so spend is attributable end to end.

> [!NOTE]
>
> Managed Agents meters against measured vendor cost because list-price rate cards over-state real cost by 1.017x–4.176x depending on harness and window — see [Benchmarks](https://usenaive.ai/blogs/introducing-naive-managed-agents).

## Attribution & live usage

* **Who spent it** — every action and money movement is principal-attributed; see the [audit log](https://vetta.sh/docs/api/audit-logs.md).
* **Live cost per run** — a session exposes `consumed_micro_usd` and 5-tier `token_usage`, and emits `session.usage` before idle. See [Observability](https://vetta.sh/docs/capabilities/observability.md).

## On the wire

Money is integer **micro-USD** (`_micro_usd`, `1 USD = 1_000_000`) everywhere on the wire — every ledger entry, session `consumed_micro_usd`, and quote. The CLI renders dollars for humans.

> [card] [Next: pricing & the completion window](https://vetta.sh/docs/platform/pricing.md)
>
> How the window changes what you pay.


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