API-ключи и учётные данные
Страница API Keys позволяет управлять ключами доступа к внешним провайдерам: языковым моделям (LLM), распознаванию речи (STT), синтезу речи (TTS), эмбеддингам и другим сервисам.
Обзор
API-ключи являются общими для всей организации — все проекты и агенты внутри организации используют одни и те же ключи. Это упрощает управление и позволяет быстро переключать провайдеров.
Типы провайдеров
| Тип | Тег | Описание |
|---|---|---|
| LLM | Синий | Провайдеры языковых моделей (OpenAI, Anthropic, xAI, Google и др.) |
| STT | Зелёный | Провайдеры распознавания речи (Deepgram) |
| TTS | Фиолетовый | Провайдеры синтеза речи (Cartesia, ElevenLabs, Inworld) |
| Embedding | Голубой | Провайдеры эмбеддингов для баз знаний |
| Image | Оранжевый | Провайдеры генерации изображений |
| Video | Красный | Провайдеры генерации видео |
| Integration | Синий | Ключи для внешних интеграций |
Добавление ключа
- Нажмите Add Key.
- Выберите провайдера из выпадающего списка. Список загружается динамически и содержит всех доступных провайдеров.
- Введите учётные данные — набор полей зависит от провайдера:
- Для большинства провайдеров — один API-ключ.
- Для некоторых (например, Yandex) — API-ключ, Folder ID и другие параметры.
- Для GigaChat — OAuth-токен и область действия.
- Задайте Label (необязательно) — метку для удобной идентификации.
- Нажмите Add.
API-ключ шифруется при сохранении. После добавления полный ключ недоступен для просмотра — отображается только маскированный префикс.
Таблица ключей
| Колонка | Описание |
|---|---|
| Provider | Иконка и название провайдера |
| Label | Пользовательская метка |
| API Key | Маскированный префикс ключа |
| Type | Тип провайдера (LLM, STT, TTS и т.д.) |
| Status | Active или Inactive |
| Last Used | Дата последнего использования |
| Created | Дата создания |
Редактирование
Для редактирования ключа используйте контекстное меню (правый клик) > Edit:
- Label — изменить метку.
- Status — переключить между Active и Inactive.
Изменить сам API-ключ нельзя. Для замены ключа удалите старый и создайте новый.
Удаление
Удалить ключ можно через контекстное меню (правый клик) > Delete. Также доступно массовое удаление — выберите несколько ключей через чекбоксы и нажмите Delete Selected.
Удаление API-ключа немедленно прекращает работу всех агентов, использующих модели этого провайдера. Убедитесь, что ключ больше не нужен.
Порядок использования ключей
При запуске агента платформа автоматически подбирает подходящий активный ключ:
- Определяется провайдер выбранной модели.
- Ищется активный ключ для этого провайдера.
- Если ключ найден — используется для вызова API.
- Если ключ не найден или неактивен — выполнение завершается с ошибкой.
Рекомендуется всегда иметь активный ключ для каждого провайдера, модели которого используются в ваших агентах. Используйте метки (labels) для различения ключей, если у вас их несколько.