Аутентификация
Все запросы к LowRouter API требуют Bearer-токен в заголовке Authorization.
Формат заголовка
Authorization: Bearer sk-lr-xxxxxxxxxxxxxxxx
Ключи создаются в личном кабинете и имеют префикс sk-lr-.
Создание ключей
- Войдите в личный кабинет
- Откройте API Keys
- Нажмите Создать ключ и задайте имя (например,
production-backend) - Скопируйте ключ — он показывается только один раз
Области (scopes)
Каждый ключ получает scopes при создании:
| Scope | Описание |
|---|---|
chat |
Chat completions API |
billing |
Баланс и usage (/v1/account/*) |
Безопасность
- Никогда не храните ключи в клиентском коде (браузер, мобильное приложение)
- Используйте переменные окружения на сервере
- Ротируйте ключи при утечке или увольнении сотрудника
- Следите за балансом и настройте алерты в кабинете
Проверка баланса
curl https://api.lowrouter.ru/v1/account/balance \
-H "Authorization: Bearer YOUR_API_KEY"
Ответ:
{
"balance_kopecks": 500000,
"held_kopecks": 0,
"available_kopecks": 500000,
"currency": "RUB"
}
Usage за период
curl "https://api.lowrouter.ru/v1/account/usage?period=30d" \
-H "Authorization: Bearer YOUR_API_KEY"
Периоды: 24h, 7d, 30d, 90d.