Аутентификация API моделей

API-ключи для запросов к моделям — отдельно от токена кабинета.

Кому подходит

Разработчикам и администраторам, подключающим приложения к API моделей.

API-ключ


Формат	`sk-…` (секрет показывается один раз при создании)
Заголовки	`Authorization: Bearer sk-…` или `x-api-key: sk-…`
Где создать	Кабинет → API-ключи или `POST /api/organization/api-keys`

Один и тот же ключ sk-… используется и для OpenAI-совместимых маршрутов, и для POST /messages.

Если переданы оба заголовка, приоритет у Authorization: Bearer. x-api-key нужен прежде всего для официального Anthropic SDK; OpenAI SDK обычно использует Authorization.

Не используйте токен сессии кабинета (POST /api/auth/login) для запросов к моделям — это разные учётные данные. Ключи Management API (sk-mgmt-…) предназначены для API платформы, не для inference.

Проверка доступа к модели

Перед отправкой запроса к модели платформа проверяет:

Ключ активен и не отозван.
Модель разрешена policy rules (access) для ключа, системы и организации.
Модель поддерживает нужный тип запроса. Если маршрута нет — 404 model_not_found.
Бюджет и rate limits (для организаций с платным тарифом).

При отказе — 401, 403, 402 insufficient_balance, 429 rate_limit_exceeded или 404 model_not_found — см. Ошибки.

Для POST /messages выбор маршрута всё равно проверяется по capability chat_completions, а thinking и prompt cache доступны только у native-поставщиков anthropic и ru-openrouter.

Realtime

Для WebSocket GET /realtime нужны два credential:

Credential	Где передаётся
API-ключ организации	`Authorization: Bearer sk-…`
Client secret (из `POST /realtime/client_secrets`)	query `?client_secret=…`

Подробнее — Realtime.

Безопасность

Храните sk-… в секретах (env, vault), не в репозитории.
При компрометации — отзовите ключ и выпустите новый.
Client secret Realtime одноразово показывается при создании; повторно его получить нельзя.