Introduction

Runne Pass is a managed API for AI models: OpenAI, Anthropic, DeepSeek, Zhipu AI, and Kimi behind one API key, with a single token-denominated balance.

Token model

• 1 token = 1 ₽ — a fixed exchange rate for the beta period.
• Every workspace has a balance stored as a decimal string in tokens (currency: "RUB").
• Costs are computed from each model's per-1k-token pricing and settled atomically against the balance.
• Post-beta: dynamic exchange rates, subscriptions, and volume discounts.

The exchange rate is fixed for now. Do not build client logic that assumes it stays fixed forever.

Workspaces

A workspace is the unit of isolation and billing:

• Owns the balance, the API keys, and the usage history.
• Has a status (active, suspended, archived).
• Is always owned by exactly one customer (customer_id).

All workspace-scoped queries verify ownership — see Workspaces & Balance.

Roles

Role	How it is granted	What it can do
Customer	Registered via POST /v1/auth/register	Create workspaces, API keys, payments; read own data
Platform admin	is_platform_admin set on the customer row (auto-assigned when the email matches ADMIN_EMAIL)	Dashboard, customer management, pricing and quota updates, balance adjustments

Platform-admin checks read the value from the database on every request — the JWT isAdmin claim is not trusted as the source of truth.

Authentication in two modes

Runne Pass exposes two surfaces:

1. Customer dashboard (cookie session) — a JWT stored in an HttpOnly cookie for the web cabinet.
2. Programmatic API (Bearer key) — rn_live_… keys for server-to-server clients.

Both are covered in Authentication.

Beta status

Runne Pass is in closed beta. Two consequences matter for integrators:

1. POST /v1/chat/completions is served by a mock provider — the response is deterministic and does not call OpenAI/Anthropic/etc. The billing path (reserve → settle) is real.
2. tokens_per_month is the only quota limit currently enforced; the other quota fields are declared but not yet enforced.

Next steps

• Quickstart — the full flow in curl.
• API Reference — every endpoint.