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

# Pricing

> What routing costs, what verification costs, and how the prepaid balance works.

Source: https://telluvian.ai/docs/pricing

| What you pay for | Rate |
| --- | --- |
| **Model tokens** | Gateway catalogue rates, based on provider pricing. |
| **Model Select** | $0.05 per 1M input tokens, only when we pick the model. |
| **Verification** | $1.00 per 1M completion tokens. Optional. |

Model generation uses the gateway catalogue rates. Verification is charged
only when explicitly enabled; the Model Select fee only when Gallery or a direct `/v1/modelSelect`
call picks the model.

## Your balance

Billing is **prepaid**. You add credit up front and each request debits your
balance. There is no subscription and no invoice at the end of the month.

- **Your balance is in dollars.** A $25 payment adds $25 of API credit. There
  is no separate credit currency and no exchange rate to work out.
- Top-ups run between **$5.00** and **$500.00** per transaction, paid by card
  through Stripe. We never see or store your card details.
- Cost is settled *after* each response, from the token counts the model
  reports.
- Credit does not expire and is not transferable. Unused credit is refundable on
  request. See the [Terms](/terms).

When your balance reaches zero, requests are refused with a `402`. Nothing is
charged automatically.

## Model tokens

The gateway bills its published model rates, based on provider pricing.
Provider updates and discounts may not be reflected until the catalogue is
refreshed; use the gateway rate card to calculate your Telluvian charge.

Dollars per million tokens, for the models most people start with. Read live
from the gateway catalogue, with website caching. Rates can lag a recent update.
See [all models](https://telluvian.ai/docs/models.md) for the full catalogue.

| Model | Input / 1M | Output / 1M |
| --- | ---: | ---: |
| `google/gemma-4-31b-it` | $0.20 | $0.40 |
| `anthropic/claude-opus-5` | $5.00 | $25.00 |
| `anthropic/claude-sonnet-5` | $2.00 | $10.00 |
| `openai/gpt-5.6-terra` | $2.00 | $12.00 |
| `openai/gpt-5.5` | $5.00 | $30.00 |
| `openai/gpt-5.4` | $2.50 | $15.00 |
| `openai/gpt-5.4-mini` | $0.75 | $4.50 |
| `openai/gpt-4o-mini` | $0.15 | $0.60 |
| `deepseek/deepseek-chat-v3.1` | $0.25 | $0.95 |
| `x-ai/grok-4.6` | $2.00 | $6.00 |

All models (182): https://telluvian.ai/docs/models.md

## Gallery and Model Select

[Model Select](https://telluvian.ai/docs/model-select.md) costs **$0.05 per 1M input tokens**, on both
[Gallery](https://telluvian.ai/docs/gallery.md) requests and direct `/v1/modelSelect` calls. It applies
to the whole prompt, cached tokens included, because Model Select reads every
token whatever the provider later serves from its cache. It is never scaled by a
long-context tier.

Gallery completions also incur the selected model's generation charges. Direct
Model Select calls generate no completion, so the fee is the whole charge.
Naming a model yourself skips Model Select and is not charged the fee.

## Verification

Verification costs **$1.00 per 1M completion tokens**, on top of the model's
pass-through rate.

> **Completion tokens only**
>
> The probe scores each token as it is generated, so the work scales with how
> much the model writes, not with how long your prompt was. A 100k-token prompt
> with a short answer pays the fee only on that short answer.

Enable it with [`include_scores: true`](https://telluvian.ai/docs/include-scores.md). Omitted or false
means no verification surcharge on a normal completion. Analyze requests also
require explicit opt-in.

### Calculating a charge

Generation depends on the selected model, input and visible output tokens,
reasoning tokens, cache reads/writes, and any long-context tier. Use the current
catalogue rates rather than a fixed price table copied into application code.

Verification adds $0.30 for 300,000 completion tokens when enabled,
regardless of prompt length. It adds nothing when disabled. Routing adds $0.01
for a 200,000-token prompt when we pick the model, and nothing when you name
one yourself.

Usage may be estimated if a stream ends before the provider reports its final
counts; stored usage records distinguish estimates from reported counts.

## Your own provider keys

Requests served by [your own provider key](https://telluvian.ai/docs/byok.md) are billed for our fees
only: verification and Model Select, when they apply. The provider bills you for
the tokens directly, so model tokens cost nothing here. If your key fails and
you have turned on fallback, the request runs on our key at the normal price.

## Reasoning tokens

Some models spend part of their budget on internal reasoning that never appears
in the output. OpenAI's `gpt-5` family most notably, which can consume a whole
budget and return no visible text at all.

These are reported separately as `usage.reasoning_tokens` and billed at the
model's **standard output rate**, passed through with no markup, exactly like
every other token.

> **No verification fee on reasoning tokens**
>
> The probe scores tokens by reading the hidden states of the pass that produced
> them. Reasoning tokens never reach our probe model, so no probe pass runs on
> them and the $1.00 fee does not apply.

They are **not** included in `completion_tokens` or `total_tokens`, so a
response's token counts will not sum to what you were billed for on a reasoning
model. Read `reasoning_tokens` explicitly if you are reconciling spend. It is
`0` for every non-reasoning model.

> **How money is counted**
>
> Balances are integer micro-dollars ($1 = 1,000,000 micros) and every charge is
> computed in integers, rounded up once at the end. No floating point touches the
> billing path, so a price can never drift by a fraction of a cent.