Один ключ на всю компанию — это риск: при утечке его придётся менять везде сразу, а расход нельзя разделить по сервисам. В Heli ключи создаются во вкладке «Ключи» кабинета после регистрации на getheli.ru, и каждому можно дать своё имя, проект и лимиты.
Схема ключей
Называйте ключи так, чтобы по имени было понятно, где он используется: support-bot-prod, crm-extract-staging. Ключ можно переименовать позже.
- Отдельный ключ на окружение: prod, staging, dev.
- Отдельный ключ на каждый сервис или продукт: бот поддержки, внутренний ассистент, пакетная обработка.
- Для агентств — проект и ключ на каждого клиента.
- Персональные ключи разработчикам для IDE и экспериментов вместо общего продового.
Проекты и лимиты
В разделе «Организация» создаются проекты — центры затрат, к которым привязываются ключи. Во вкладке «Лимиты» политику можно задать на весь аккаунт, проект или отдельный ключ: бюджет на день, неделю или месяц, разрешённые и запрещённые модели, потолок max_output_tokens и лимит запросов в минуту.
Например, ключу разработчика можно разрешить только недорогие модели и небольшой дневной бюджет, а продовому ключу — нужную модель и резервную модель на случай исчерпания бюджета. Запрос к запрещённой модели получит ошибку 400, а /v1/models для такого ключа покажет только разрешённые модели.
Ротация и отзыв
- Ротация выпускает новый секрет с периодом перекрытия (по умолчанию 24 часа): старый ключ ещё работает, пока вы обновляете переменные окружения, затем отзывается.
- При уходе сотрудника или подозрении на утечку отзовите ключ сразу: base URL и остальные ключи не меняются.
- Журнал действий показывает, кто менял ключи и состав команды.
Роли и учёт
В организации четыре роли: владелец, админ, финансы и участник. Права проверяются на сервере, а вход в кабинет можно защитить TOTP-кодом из приложения-аутентификатора.
Расход по каждому ключу виден на «Дашборде», а в «Выгрузке» можно скачать CSV или JSON с фильтром по ключу или проекту. Если через один ключ ходят несколько сотрудников, передавайте поле user или заголовок X-User — так расход разделится и по людям.
Попробуйте Heli
Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.