Введение

Runne Pass — это managed API для AI-моделей: OpenAI, Anthropic, DeepSeek, Zhipu AI и Kimi за одним API-ключом, с единым балансом, выраженным в токенах.

Модель токенов

• 1 токен = 1 ₽ — фиксированный курс на период beta.
• У каждого воркспейса есть balance, хранящийся как десятичная строка в токенах (currency: "RUB").
• Стоимость вычисляется из цены каждой модели за 1k токенов и атомарно списывается с баланса.
• После beta: динамические курсы, подписки и скидки за объём.

Курс зафиксирован на время. Не пишите клиентскую логику с расчётом, что он останется фиксированным навсегда.

Воркспейсы

Воркспейс — это единица изоляции и биллинга:

• Владеет балансом, API-ключами и историей использования.
• Имеет status (active, suspended, archived).
• Всегда принадлежит ровно одному клиенту (customer_id).

Все запросы в разрезе воркспейса проверяют владение — см. Воркспейсы и баланс.

Роли

Роль	Как выдаётся	Что может делать
Клиент	Регистрация через POST /v1/auth/register	Создавать воркспейсы, API-ключи, платежи; читать собственные данные
Администратор платформы	is_platform_admin, установленный на строке клиента (назначается автоматически, если email совпадает с ADMIN_EMAIL)	Дашборд, управление клиентами, обновление цен и квот, корректировки баланса

Проверки администратора читают значение из базы данных при каждом запросе — claim isAdmin из JWT не считается источником истины.

Аутентификация в двух режимах

Runne Pass предоставляет две поверхности:

1. Кабинет клиента (cookie-сессия) — JWT в HttpOnly-cookie для веб-кабинета.
2. Программный API (Bearer-ключ) — ключи rn_live_… для клиентов server-to-server.

Оба режима описаны в Аутентификации.

Статус beta

Runne Pass находится в закрытой beta. Для интеграторов важны два следствия:

1. POST /v1/chat/completions обслуживается mock-провайдером — ответ детерминированный и не обращается к OpenAI/Anthropic/etc. При этом биллинговая цепочка (резерв → расчёт) настоящая.
2. tokens_per_month — единственный лимит квоты, который сейчас применяется; остальные поля квоты объявлены, но ещё не применяются.

Дальнейшие шаги

• Быстрый старт — полный сценарий в curl.
• Справочник API — все эндпоинты.