Выпуск, ротация и отзыв API-ключей

Выпустите ключ для сервиса, выберите, что ему можно, замените его секрет и отзовите его на странице ключей консоли.

4 мин чтения

API-ключ позволяет сервису обращаться к Slen от имени одного проекта. Эта страница — о странице ключей в консоли. Как запрос использует ключ, описано в статье Аутентификация.

Где находятся ключи

Откройте Настройки, затем Ключи и доступ. Страница показывает ключи проекта, выбранного в шапке. Выберите там другой проект — и список сменится вместе с ним.

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

Страница открывается тому, у кого есть разрешение management:read. Для выпуска, ротации и отзыва нужно management:write. Без него страница — это список без кнопок.

Выпустить ключ

1. Начните создавать ключ

Нажмите Новый ключ.

2. Назовите ключ

Дайте ключу название сервиса, который будет им пользоваться. По названию ключи отличают друг от друга в списке. Оно может быть длиной до 120 символов.

3. Выберите разрешения

Отметьте, что ключу можно делать. Хотя бы одно разрешение должно быть отмечено. У нового ключа сразу отмечены Чтение и Запуск операций — этого достаточно, чтобы отправлять запросы и читать, что из них вышло.

Разрешение	Код	Что оно даёт ключу
Чтение	`read`	Читать операции, выполнения, реестр и каталог моделей
Запуск операций	`gateway:write`	Запускать флоу
Чтение настроек	`management:read`	Читать флоу, подключения, пулы и клиентов
Изменение настроек	`management:write`	Менять их и бюджеты
Клиенты: чтение	`customers:read`	Читать клиентов, их счета и выписки, а также цены в кредитах
Клиенты: пополнение, списание, блокировка	`customers:write`	Создавать, пополнять, списывать, корректировать, блокировать и удалять клиентов

Что включает каждое разрешение, сказано в статье Аутентификация. У разрешения flows:write на этой странице нет своей отметки, потому что его включает Изменение настроек. Давайте ключу только то, что нужно его сервису.

4. Создайте ключ и скопируйте его

Нажмите Создать ключ. Ключ начинается с sl_live_ и показывается один раз. Скопируйте его и положите туда, откуда сервис читает свои секреты.

Slen хранит только хэш ключа. После закрытия окна ключ больше не показать. Если он потерян, выполните ротацию.

Проверить ключ

Отправьте запрос с новым ключом. Этому запросу нужно разрешение Чтение.

Terminal

curl https://api.slen.ai/api/v1/models \
  -H "Authorization: Bearer $SLEN_API_KEY"

200 OK

{
  "data": [
    {
      "model_code": "gpt-4o-mini",
      "provider": "openai",
      "model_price_id": "1108",
      "input_price_per_million": "0.15000000",
      "output_price_per_million": "0.60000000",
      "cached_input_price_per_million": "0.07500000",
      "max_output_tokens": 16384,
      "currency": "USD",
      "effective_from": "2026-01-01T00:00:00+00:00",
      "effective_to": null
    }
  ]
}

Ответ 401 с кодом invalid_api_key значит, что ключ скопирован неверно. Ответ 403 с кодом insufficient_scope значит, что ключ работает, но разрешения у него нет.

Ротация ключа

Ротация заменяет секрет ключа и сохраняет сам ключ — с его названием и разрешениями. Откройте меню в строке ключа, выберите Ротация и подтвердите. Новый секрет показывается один раз, как секрет нового ключа.

Старый секрет перестаёт работать сразу, и каждый сервис, который всё ещё его отправляет, получает 401. Подготовьте развёртывание нового секрета до ротации.

Отозвать ключ

Откройте меню в строке ключа, выберите Отозвать и подтвердите. Ключ перестаёт работать сразу, и восстановить его нельзя. Он переходит в список отозванных ключей внизу страницы, с временем отзыва.

У ключа нет срока действия. Он работает, пока его не отозвали.

Изменить то, что можно ключу

Разрешения ключа выбираются при выпуске и потом не редактируются. Чтобы дать сервису больше или меньше, сделайте три шага.

Выпустите новый ключ с разрешениями, которые нужны сервису.
Переключите сервис на новый ключ.
Отзовите старый ключ.

Ключ приложения

Приложению, которое запускает флоу для своих клиентов и ведёт их кредиты, нужен ключ с двумя разрешениями: Запуск операций и Клиенты: пополнение, списание, блокировка. Такой ключ запускает флоу и ведёт клиентов своего проекта: добавляет, пополняет, корректирует, блокирует и удаляет их и списывает с них кредиты. Он читает и клиентов, их выписки и цены в кредитах, потому что Клиенты: пополнение, списание, блокировка включает Клиенты: чтение. Он не меняет ни флоу, ни бюджеты, ни цены в кредитах, ни ключи: для этого нужно Изменение настроек.

Ключ с разрешением Изменение настроек тоже ведёт клиентов, потому что это разрешение включает оба разрешения клиентов. Что нужно каждой операции клиентов, перечисляет статья Клиенты и кредиты.

Ключи и проекты

Ключ принадлежит проекту, в котором он выпущен, и действует только в этом проекте. Сервису, который работает с двумя проектами, нужен ключ каждого из них. Что доступно ключу, сказано в статье Аутентификация.