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

# Billing

> How Gradient meters usage: voice per minute by model class, chat and API per token, plus trials, payment, and the billing page.

Billing belongs to the [organization](/platform/organizations). Each organization is a single billing account with one payment method, and usage across all of its agents rolls up to one bill.

## How usage is metered

Gradient meters two kinds of usage, and the rule behind them is to bill the constraint, not the resource.

* **Voice: per minute.** A phone call has a person on the line, so time is the natural limit and the meter. You are billed for connected call time, on both inbound and outbound calls.
* **Chat, API, and evaluation: per token.** Off the phone there is no clock, so usage is metered by the tokens your agents consume. This covers dashboard and API turns, redteam runs, and rubric grading.

### Voice rate by model class

The per-minute voice rate is set by the **model class** of the published version, stamped at the moment you publish:

* **Standard**: lighter, faster models, billed at the lower per-minute rate.
* **Pro**: higher-capability models, billed at the higher rate.

Gradient stamps the rate from the highest model class used across the version's nodes, so the price is fixed for that [published version](/publish/versions) and does not move when you edit the draft afterward. Model choice is the main lever on what a voice minute costs.

<Note>
  The exact current per-minute and per-token rates are shown on your **Billing** page in the dashboard and on the Gradient pricing page.
</Note>

## Trials, credit, and payment

New organizations are **card-first**: add a payment method (or redeem a promo code that grants trial credit) before you can run agents. Add a card through hosted **Checkout** from the Billing page, and manage your card, subscription, and invoices through the hosted **customer portal**. Promo codes add trial credit and are redeemed on the Billing page.

### Billing states

An organization is always in one of three states:

| State       | Meaning                                                                           |
| ----------- | --------------------------------------------------------------------------------- |
| `trialing`  | Running on trial credit with no card connected. Runs until the credit is used up. |
| `active`    | A card is connected. Usage is metered and invoiced.                               |
| `suspended` | Trial credit is exhausted and no card is connected. Running is blocked.           |

When a trialing organization with no card reaches its credit, it is **suspended**, and requests to run its agents return `402` until a card is added. Connecting a card lifts the suspension immediately.

## The billing page

From **Billing** in the dashboard you can see:

* the current billing state and whether a card is connected,
* voice minutes used, split by Standard and Pro class,
* remaining trial credit and any promo codes you have redeemed,
* your outstanding balance, the upcoming invoice preview, and past invoices with hosted links and PDFs.

<CardGroup cols={2}>
  <Card title="Organizations and API keys" icon="building" href="/platform/organizations">
    The tenant that owns billing, members, and keys.
  </Card>

  <Card title="Voice" icon="phone" href="/run/voice">
    How phone calls run, the usage voice billing meters.
  </Card>
</CardGroup>