SmartyPress AI Engine Статья документации

GigaChat API: ключ авторизации и подключение к WordPress

Ключ авторизации Сбера, область доступа и адрес API: тексты и картинки с оплатой в рублях.

GigaChat — нейросеть Сбера: пишет по-русски, рисует картинки и оплачивается в рублях без VPN и зарубежных карт. Чтобы подключить GigaChat API к WordPress, нужен ключ авторизации из личного кабинета Сбера и пара настроек: область доступа и адрес API.

Только для русскоязычных сайтов. Карточки GigaChat и Yandex появляются в настройках SmartyPress, если язык сайта — русский («Настройки» → «Общие» → «Язык сайта»). Сменили язык — провайдер пропадёт из интерфейса, хотя сохранённый ключ останется в базе.

Как получить ключ GigaChat API

  1. Зайдите в Studio на портале разработчиков Сбера через Сбер ID.
  2. Создайте проект GigaChat API. Частным лицам Сбер даёт бесплатный Freemium-режим с большим пакетом токенов на год; текущие объёмы и цены платных пакетов — на странице тарифов для физлиц.
  3. В проекте откройте «Настройки API» и нажмите «Получить ключ».
  4. Скопируйте значение «Authorization Key» — это и есть ключ авторизации для плагина. Сбер показывает его один раз; потеряли — выпустите новый.

Чтобы получить API GigaChat для компании, проект создаётся от имени юрлица или ИП, и запросы оплачиваются по договору. Для плагина разница только в «Области доступа API» — о ней ниже.

Как подключить GigaChat к WordPress

  1. Откройте «SmartyPress AI» → «Настройки» и щёлкните по карточке «GigaChat».
  2. Вставьте ключ в поле «Ключ авторизации» (Authorization Key).
  3. В поле «Область доступа API» (API Scope) выберите тариф своего проекта: «Персональный (PERS)» для частных лиц, «Бизнес (B2B)» или «Корпоративный (CORP)» для компаний. Ошибётесь — Сбер не выдаст токен, и подключение не пройдёт.
  4. «API endpoint» оставьте «Основной endpoint» (Main endpoint). «Endpoint «Салют для Бизнеса»» нужен, только если ваш проект создан в этом сервисе.
  5. «Проверка SSL» (SSL Verification) оставьте выключенной. Включайте её, только если на сервере установлены сертификаты Минцифры: без них запросы к Сберу оборвутся с ошибкой сертификата.
  6. Нажмите «Сохранить настройки провайдера» (Save Provider Settings).
Форма GigaChat в SmartyPress AI: ключ авторизации, область доступа API, endpoint и проверка SSL
GigaChat: ключ авторизации, область доступа, адрес API и проверка SSL.

При сохранении плагин получает у Сбера временный токен и проверяет ключ. Всё в порядке — появится «Подключение к провайдеру успешно», а карточка GigaChat позеленеет.

GigaChat подключён: сообщение «Подключение к провайдеру успешно» и зелёная карточка
Подключение прошло: карточка GigaChat зелёная.

Модели GigaChat

Модель Что это
GigaChat 2
GigaChat-2
Основная модель, выбрана по умолчанию. Хватает для статей, заголовков и правки текстов.
GigaChat 2 Max 💰🧠
GigaChat-2-Max
Старшая модель рассуждений: тексты аккуратнее, токенов уходит больше.

Как и у других провайдеров, модель можно сменить для одного запроса в «Расширенных настройках» окна генерации.

Выбор провайдера Gigachat и модели GigaChat 2 в расширенных настройках окна генерации
GigaChat в окне генерации: GigaChat 2 и GigaChat 2 Max.

Картинки и alt-тексты через GigaChat

GigaChat умеет рисовать: в разделе «Генерация изображений» выберите его в поле «Окружение» — получится квадратная картинка 1024 × 1024. Как это выглядит, показано в статье «Изображение для статьи нейросетью».

Ещё GigaChat может «посмотреть» на картинку из медиатеки и описать её — это нужно для генерации alt-текстов. Анализ работает с JPEG и PNG; картинки в WebP и других форматах GigaChat не принимает.

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

  • Подключение не проходит, ошибка авторизации — проверьте ключ и «Область доступа API»: ключ проекта для частных лиц не работает с областью B2B и наоборот.
  • Ошибка SSL-сертификата — выключите «Проверку SSL» или установите на сервер корневые сертификаты Минцифры.
  • Генерация картинок отвечает «No such model» — переключите «API endpoint» на «Основной endpoint» и сохраните настройки провайдера ещё раз.
  • Payment Required (402) — закончился бесплатный пакет или оплаченные токены. Пополните баланс в кабинете Сбера.

Что дальше