Model pricing — Markdown source

> **AI Agents**: Index `/api/llms.txt` | Full EN `/api/llms-full-en.txt` | Full ZH `/api/llms-full-zh.txt` | OpenAPI `/api/openapi.yaml`
> Base URL: `<BASE_URL>/v1`

# Model pricing

SupaNexus bills by **token usage**. OpenAPI `GET /v1/models` returns model metadata only — **not** sell prices. Use the **developer console → Models** marketplace as the source of truth.

## Where to see prices

1. Sign in to the [Developer Console](https://console.supanexus.ai).
2. Open **[Models](https://console.supanexus.ai/models)**.
3. Open a model’s detail page and check **Pricing**.

When tiered pricing is configured, the detail page typically shows:

| Tier | Meaning |
|------|---------|
| **Input** | New input tokens (not from cache) |
| **Cached input** | Input tokens that hit Prompt Cache (usually cheaper) |
| **Output** | Completion tokens |

Some models may not have a public price yet — follow what the marketplace displays.

## OpenAPI vs billing

| Scenario | Description |
|----------|-------------|
| List models | `GET /v1/models` — no prices |
| Actual charges | After a successful `POST /v1/chat/completions` or `POST /v1/messages`, SupaNexus bills from token usage in the response (including cache hits) at the rates shown in the marketplace |

See [Chat Completions — usage & Prompt Cache billing](./chat-completions.md#usage-prompt-cache-and-billing) for the simplified formula.

## Related

- [Models](./models.md) — OpenAPI `GET /v1/models`
- [Help: Billing & balance](/help/billing)
- [Help: Cached input & Prompt Cache pricing](/help/prompt-cache-pricing)