Перейти к основному содержимому

GigaChat

GigaChat — нейросеть Сбера. Модуль подключается к GigaChat API напрямую, без агрегатора-посредника. Оплата в рублях, зарубежная карта и VPN не нужны, а физическим лицам Сбер даёт бесплатный пакет токенов — его хватит, чтобы собрать правило генерации и обработать первые товары.

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

Быстрый путь

Пошаговый пример «ключ → модель → проверка → первая генерация» — в разделе Шаг 1. Подключите нейросеть. Здесь — подробности о каждой настройке и особенностях GigaChat.

Что умеет в модуле​

ВозможностьПоддержка
Каталог моделейПодгружается автоматически — модели, доступные вашему ключу. Без цен: тарифы смотрите в личном кабинете или на сайте Сбера
РассужденияНастроек нет: API GigaChat не даёт управлять рассуждениями, блок рассуждений в модуле не показывается
Веб-поискНет
Проверка балансаНет — остаток токенов смотрите в личном кабинете GigaChat API

Шаг 1. Ключ авторизации​

Гайд прямо в модуле

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

GigaChat работает не по обычному API-ключу, а по ключу авторизации (Authorization key). По нему модуль сам получает временный токен доступа и обновляет его, когда тот истекает, — вам ничего делать не нужно.

  1. Войдите в личный кабинет на developers.sber.ru (вход по Сбер ID).
  2. Создайте проект GigaChat API или откройте уже созданный.
  3. В проекте откройте «Настройки API» и нажмите «Получить ключ».
  4. Скопируйте Authorization Key и сохраните его в надёжном месте.
Ключ показывается один раз

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

Если вы скопировали ключ вместе со словом Basic в начале — ничего страшного, модуль уберёт его сам.

Шаг 2. Версия API (scope)​

Ключ авторизации выпускается для определённой версии API — она указана в личном кабинете проекта. В модуле нужно выбрать ту же:

Значение в модулеДля когоКод в документации Сбера
Физические лицаФизлица, в том числе бесплатный пакет токеновGIGACHAT_API_PERS
Юрлица и ИП, предоплатаИП и компании, которые покупают пакеты токеновGIGACHAT_API_B2B
Юрлица и ИП, постоплатаИП и компании с оплатой по факту потребления (pay-as-you-go)GIGACHAT_API_CORP

Если версия в модуле не совпадает с версией ключа, GigaChat не выдаст доступ, а модуль покажет ошибку «GigaChat не выдал токен доступа… Проверьте ключ авторизации и версию API (scope)».

Оплата для ИП и юрлиц

ИП и компаниям перед работой с API нужно оплатить доступ — пакетами или по факту. По документации GigaChat API, с 1 сентября 2026 года новые клиенты и клиенты, которые раньше не покупали пакеты, оплачивают работу с моделями на платформе cloud.ru. Актуальные условия уточняйте у Сбера.

Шаг 3. Подключение в модуле​

  1. Откройте «Настройки → Основное», блок «LLM Провайдер».
  2. В поле «LLM-провайдер» нажмите на выбор провайдера и в окне «Выбор LLM-провайдера» выберите карточку GigaChat.
  3. Вставьте ключ авторизации в поле «API-ключ». Значение скрыто точками; посмотреть его можно кнопкой с глазом.
  4. В поле «Версия API GigaChat» выберите версию, для которой выпущен ключ.
  5. Переключатель «Проверять SSL-сертификат GigaChat» пока оставьте выключенным (см. ниже).
  6. Нажмите «Сохранить» на панели внизу. Без сохранённого ключа модуль не сможет загрузить список моделей.

Блок «LLM Провайдер» с выбранным GigaChat: «API-ключ» скрыт точками, «Версия API GigaChat» — «Физические лица», переключатель «Проверять SSL-сертификат GigaChat» выключен

SSL-сертификат НУЦ Минцифры​

Серверы GigaChat используют сертификат Национального удостоверяющего центра (НУЦ) Минцифры. На многих серверах корневого сертификата НУЦ нет, и проверка сертификата не проходит.

  • Сертификат не установлен (обычный случай) — оставьте «Проверять SSL-сертификат GigaChat» выключенным: запросы к GigaChat будут работать без проверки сертификата.
  • Администратор установил корневой сертификат НУЦ Минцифры на сервер сайта — можно включить проверку. Если включить её без сертификата, запросы будут отклоняться с ошибкой «Не удалось связаться с GigaChat…».

Шаг 4. Выбор модели по умолчанию​

В блоке «Параметры модели» нажмите на поле «Модель по умолчанию». Откроется список моделей GigaChat, доступных вашему ключу.

Окно выбора модели GigaChat: GigaChat-2, GigaChat-2-Max, GigaChat-2-Pro (отмечена), GigaChat-3-Lightning, GigaChat-3-Pro, GigaChat-3-Ultra; в колонках «Цена за вход» и «Цена за выход» прочерки

Набор зависит от ключа и версии API. Например, на момент написания в списке были GigaChat-2, GigaChat-2-Pro, GigaChat-2-Max, GigaChat-3-Lightning, GigaChat-3-Pro и GigaChat-3-Ultra. По документации Сбера, GigaChat-3-Ultra доступна только физлицам в бесплатном режиме.

Выберите модель и снова нажмите «Сохранить». Общий принцип тот же, что у других провайдеров: для мета-тегов и анонсов хватит модели попроще, для длинных описаний берите модель сильнее — см. Как выбрать модель. Расход токенов у разных моделей разный — сравнивайте по остатку пакета в личном кабинете.

Цен в каталоге нет

GigaChat не сообщает цены через API, поэтому колонки «Цена за вход» и «Цена за выход» пустые, и модуль не может пересчитать расход в рубли. Количество потраченных токенов модуль показывает — в тесте подключения, в тестировании и в хронологии на дашборде. Цены и остаток пакета смотрите в личном кабинете GigaChat API.

Шаг 5. Проверка подключения​

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

Окно «Протестировать подключение» для GigaChat: сообщение «Ответь одним словом: "OK".», ответ модели «OK» и время ответа

Если модель ответила — ключ и версия API верны, модель доступна, а сервер сайта видит GigaChat. Можно переходить к источнику данных и конвейеру.

Модель не отвечает — что проверить
  • «GigaChat не выдал токен доступа» — неверный ключ авторизации или версия API не совпадает с ключом. Проверьте оба поля и сохраните настройки.
  • «Не удалось связаться с GigaChat» — сервер сайта не достучался до GigaChat. Если в тексте ошибки есть упоминание сертификата, выключите «Проверять SSL-сертификат GigaChat» или попросите администратора установить корневой сертификат НУЦ Минцифры. Если сервер выходит в интернет только через прокси — заполните блок «Прокси»: он действует и на получение токена GigaChat.
  • Ключ и модель сохранены (а не просто введены): мини-чат подскажет, чего не хватает.
  • В пакете остались токены — остаток виден в личном кабинете GigaChat API.

Особенности GigaChat​

  • Нет веб-поиска и настроек рассуждений. В окне модели шага конвейера у GigaChat есть только выбор модели — переключателя «Веб-поиск» и блока «Рассуждения» нет. Если шагу нужны свежие данные из интернета, используйте Polza.ai, OpenRouter или DeepSeek в отдельном профиле.

    Окно «Модель шага 1» у профиля с GigaChat: только блок «Модель» с вариантами «Как в «Основном»» (GigaChat-2-Pro) и «Своя для этого шага»

  • Баланс перед запуском не проверяется. Модуль не может узнать остаток пакета через API, поэтому следите за ним в личном кабинете. Когда токены заканчиваются, GigaChat начинает возвращать ошибки, и они видны в истории генерации.

  • Кэш запросов. Повторяющееся начало запроса GigaChat может брать из кэша — такие токены видны в подробностях ответа как «Из кэша».

  • GigaChat есть и в Polza.ai. Модели GigaChat доступны и через агрегатор Polza.ai — с ценами в каталоге и оплатой с баланса Polza. Прямое подключение выбирают ради бесплатного пакета для физлиц или прямой оплаты Сберу.