Аутентификация в API платформы

Запросы к API платформы аутентифицируются ключом управления (Management Key), передаваемым как Bearer-токен:

Authorization: Bearer rat_your_management_key

Пример:

curl https://www.routeapi.ai/api/open/v1/balance \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

Ключ управления

Ключ управления — это учётные данные для API платформы (/api/open/v1), начинающиеся с rat_. Это не то же самое, что API-ключ sk-, которым вызываются модели:

Учётные данные	Префикс	Назначение
Ключ управления	rat_	Вызов /api/open/v1 для управления аккаунтом и API-ключами
API-ключ	sk-	Вызов эндпоинтов моделей (например, /v1/chat/completions), см. Chat Completions

Ключ управления может работать только с ресурсами своего владельца. Он не наследует права администратора и не может управлять ключами управления через API платформы.

Храните в секрете

Ключ управления может управлять API-ключами в вашем аккаунте и читать их полные значения в открытом виде через Получить полный API Key. Не коммитьте его в репозитории, не встраивайте во frontend-код и не передавайте другим. Открытое значение показывается только один раз при создании; если вы его потеряли, создайте новый ключ.

Создание ключа управления

1. Войдите в консоль RouteAPI.
2. Откройте Management Keys на боковой панели (между Billing и Playground) или перейдите напрямую на console/management-keys.
3. Укажите имя, выберите срок действия, затем создайте ключ.
4. Сразу скопируйте и сохраните открытое значение ключа, начинающееся с rat_.

У каждого пользователя может быть не более 10 ключей управления. Истёкшие ключи остаются в списке и продолжают учитываться в лимите; удалите ключ, чтобы освободить место. При утечке удалите ключ на той же странице; удаление вступает в силу немедленно.

Новые ключи управления можно только удалить — отозвать или снова включить их нельзя. Удаление — единственный способ отключить ключ; запросы с удалённым ключом завершаются ошибкой 401 invalid_token.

Рекомендации по безопасности

• Храните ключи управления в менеджере секретов или секретах CI, а не в исходном коде или коммитимых конфигурационных файлах.
• Создавайте отдельный ключ управления для каждого скрипта или сервиса, чтобы удалять один, не затрагивая остальные.
• Задавайте срок действия. Ключ, который больше не нужен, лучше удалить, а не оставлять до истечения срока.
• Выдавайте ключ только тем системам, которые действительно управляют вашим аккаунтом. Приложениям, которые вызывают модели, нужен API-ключ sk-, а не этот ключ.
• Регулярно просматривайте список ключей управления и удаляйте ключи, которые вы больше не узнаёте.

Путаница с учётными данными

Эти два типа учётных данных не взаимозаменяемы, и каждый API отклоняет чужой ключ с ошибкой 401:

Запрос	Результат
API-ключ sk- отправлен на /api/open/v1	401 invalid_token — этот путь ожидает ключ управления
Ключ управления rat_ отправлен на эндпоинты моделей, например /v1/chat/completions	401 ошибка аутентификации — этот путь ожидает API-ключ

Если запрос к любому из API возвращает 401, хотя ключ выглядит корректным, проверьте, на какой странице он создан и какой у него префикс.

Коды ошибок и ограничения частоты см. в разделе Ошибки и лимиты.