API-ключи

API-ключ — это учётные данные для вызова Glacier AI. Создавайте и ведите отдельный ключ под каждый сценарий: у каждого своя квота, свои модели, группа и ограничения по источнику.

Нажмите «API-ключи» в левой навигации или перейдите на /keys. На странице отображаются имя ключа, замаскированный ключ, состояние, использование квоты и группа; доступны фильтрация, копирование, изменение, включение/отключение и массовое удаление. Меню строки также позволяет скопировать данные подключения, открыть пресет чата, настроенный администратором, и отправить ключ в поддерживаемую клиентскую интеграцию.

Создание API-ключа

Откройте «API-ключи» и нажмите «Создать API-ключ».
Укажите имя ключа, чтобы различать приложения и окружения.
При необходимости задайте квоту, срок действия, ограничения по моделям, ограничения по IP и группу.
После сохранения посмотрите и скопируйте полный ключ из списка.

Параметры настройки

Параметр	Назначение
Имя	Имя API-ключа (лучше по назначению, например «Продакшн» или «Тесты»)
Группа	Группа каналов, которую использует ключ
Порядок групп Auto	Отображается, только если выбрана группа `auto`. Оставляет порядок по умолчанию или задаёт порядок перебора групп для этого ключа
Повтор между группами	При включении недоступная группа сменяется следующей по порядку. Доступность выше, но цены в разных группах могут отличаться
Срок действия	После истечения ключ отклоняется
Количество	Позволяет создать несколько API-ключей сразу (к имени добавляется случайный суффикс)
Квота	Ограничивает квоту, которую может израсходовать ключ
Безлимитная квота	При включении назначает этому API-ключу неограниченную квоту
Ограничения по моделям	Ограничивает ключ указанными моделями. Пусто — без ограничений
Список разрешённых IP	По одному IP или CIDR в строке. Пусто — без ограничений. Подходит для серверов с постоянным публичным IP; домашние и мобильные сети меняют IP и заблокируют вас самих

Просмотр и копирование API-ключа

Нажмите на замаскированный ключ в списке и следуйте подсказкам, чтобы посмотреть и скопировать полное значение. Полный ключ — чувствительные учётные данные, поэтому просмотр может потребовать дополнительной проверки безопасности.

«Скопировать данные подключения» копирует ключ и адрес платформы в виде данных для импорта в приложение. При нажатии на пресет чата в разделе «Чат» боковой панели браузер попытается запустить установленное чат-приложение и автоматически подставит настройки. См. Интеграция чат-приложений.

Изменение API-ключа

Найдите нужный ключ в списке и нажмите «Изменить» справа, чтобы поменять параметры настройки (само значение ключа изменить нельзя).

Включение, отключение и удаление API-ключей

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

Связанные страницы

Использование API и Playground: адреса конечных точек, аутентификация и список эндпоинтов для запросов с ключом.
Кошелёк и подписки: баланс уровня аккаунта и квота подписки, которые вместе с лимитом на уровне ключа определяют доступный объём.
Журналы и асинхронные задачи: фильтрация вызовов и деталей тарификации по имени ключа.