Гигачат

Получить ключ Гигачат

Получение Authorization Key Гигачат API и безопасное подключение ключа в кабинете.

Обновлено 22.08.2026
Время чтения 5 мин
Сложность Начальный
Цель инструкции

Помочь получить правильный ключ GigaChat API и не перепутать его с временным access token.

Короткий маршрут

Что вы сделаете

Откройте нужный шаг сразу или идите по порядку. Проверка результата остаётся в самой инструкции.

  1. 01 Получите ключ у провайдера
  2. 02 Не публикуйте ключ
  3. 03 Вставьте ключ в кабинете
Видеоинструкция

Смотрите разбор по шагам

получение токена гига-чат

для платформы нужен ключ авторизации из проекта GigaChat API. Это не временный access token, не Client ID и не Client Secret.

1. Получите ключ у провайдера

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

Безопасный пример вкладки Подключение Гигачата с пустым полем ключа авторизации
1. Полученный ключ вставляют только в поле «Ключ авторизации» выбранного бота. Не переносите значение в скриншот или переписку.

2. Не публикуйте ключ

Не отправляйте его в мессенджере, тикете, документе, скриншоте или форме. Если ключ стал доступен постороннему, отзовите его у провайдера и создайте новый.

3. Вставьте ключ в кабинете

Выберите нужного бота, откройте «Автоматизация» → «Ответы ИИ» → «Подключение», вставьте ключ в поле «Ключ авторизации» и сохраните. Режим доступа в дополнительных настройках меняйте только в соответствии с параметрами проекта у провайдера.

Мобильная вкладка подключения Гигачата с пустым полем ключа и кнопкой сохранения
2. Если ключ уже сохранён, оставьте поле пустым: так вы не замените действующее значение случайно.

Частые ошибки

  • Вставлен временный access token — он не подходит для постоянного подключения.
  • Вставлен Client Secret или Client ID — нужен готовый ключ авторизации.
  • Ключ вставлен в другой бот — всегда сверяйте имя бота в верхней панели.
  • Ключ опубликован — его нужно отозвать, а не просто удалить из текста.

После сохранения выполните проверку подключения. Инструкция актуальна для интерфейса платформы на 21 августа 2026 года.

Проверка

Чтобы убедиться, что всё работает корректно:

  • проверьте, что отображается статус «Подключено»
  • убедитесь, что ключ сохранён без ошибок
  • при необходимости нажмите кнопку «Проверить» повторно
Результат

После выполнения всех шагов:

  • создан проект в Studio Sber
  • получен ключ авторизации GigaChat
  • ключ добавлен в AppsMax
  • подключение успешно установлено

В интерфейсе AppsMax отобразится статус: «Подключено»

Важно

  • не передавайте ключ третьим лицам
  • не публикуйте его в открытом доступе
  • при утере создайте новый ключ

Сохраните два значения сразу

После генерации система показывает как минимум:

  • Client Secret;
  • Ключ авторизации.

Именно на этом шаге пользователи чаще всего теряют данные, потому что закрывают окно “на потом”. В официальной документации отдельно указано, что эти значения показываются только один раз и не хранятся в кабинете в открытом виде.

Правильное действие здесь простое:

  1. Скопируйте ключ авторизации.
  2. Сохраните его в надёжное место.
  3. Отдельно сохраните Client Secret, если он нужен вашей команде для других сценариев.

Если вы потеряли ключ, не пытайтесь “восстановить” его в старом окне. Обычно нужно просто сгенерировать новый.

Подберите правильный scope

В AppsMax есть поле Режим доступа. Оно связано со значением scope.

Обычно используются такие варианты:

  • GIGACHAT_API_PERS — для физлиц;
  • GIGACHAT_API_B2B — для ИП и юрлиц по пакетной предоплатной схеме;
  • GIGACHAT_API_CORP — для ИП и юрлиц при другой корпоративной схеме доступа.

Если у вас обычный сценарий настройки для личного использования или тестирования, чаще всего оставляют GIGACHAT_API_PERS. Если доступ корпоративный, используйте тот вариант, который выдан вам в кабинете или договоре Sber.

Нужна помощь с запуском?

Если не хочется разбираться самостоятельно, мы можем помочь. Поможем настроить платформу под вашу задачу и быстрее запустить проект без лишних шагов.