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

YandexGPT API: ключ, ID каталога и подключение к WordPress

Сервисный аккаунт, роли и ID каталога — тексты, картинки и SEO-анализ на одном ключе.

Через YandexGPT API плагин пишет тексты моделями Яндекса, рисует картинки в YandexART, а заодно ищет конкурентов и смотрит частотность запросов для SEO-анализа. Всё это работает на одном API-ключе сервисного аккаунта Yandex Cloud и ID каталога — ниже, как их получить, не запутавшись в ролях.

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

Как получить API-ключ YandexGPT и ID каталога

Понадобится аккаунт в Yandex Cloud с привязанной картой: без активного платёжного аккаунта запросы к моделям и поиску не пройдут. Новым пользователям облако обычно даёт стартовый грант.

1. Скопируйте ID каталога

Откройте консоль и каталог, в котором будут выполняться запросы, — например, default. ID каталога виден в адресной строке после /folders/ и на странице обзора каталога. Сохраните его — он понадобится в плагине.

Консоль Yandex Cloud: ID каталога в адресной строке и плитка Identity and Access Management
ID каталога — строка после /folders/ в адресе консоли. Дальше откройте Identity and Access Management.

2. Создайте сервисный аккаунт с ролями

Ключ выдаётся не вам, а сервисному аккаунту — отдельной «учётке» для программ. Так плагин получит только те права, которые ему нужны.

  1. В каталоге откройте «Identity and Access Management» → «Сервисные аккаунты» и нажмите «Создать сервисный аккаунт».
  2. Назовите его, например smartypress-ai-engine, и добавьте три роли:
    • ai.languageModels.user — тексты YandexGPT;
    • ai.imageGeneration.user — картинки YandexART;
    • search-api.webSearch.user — поиск конкурентов и частотность запросов для SEO-анализа.
  3. Нажмите «Создать».
Страница сервисных аккаунтов Yandex Cloud с кнопкой создания аккаунта
Сервисный аккаунт создаётся на странице «Сервисные аккаунты».
Создание сервисного аккаунта в Yandex Cloud: имя и три роли
Три роли: тексты, картинки и поиск. Без последней не заработает SEO-анализ.

3. Выпустите API-ключ

  1. Откройте созданный аккаунт, нажмите «Создать новый ключ» и выберите «Создать API-ключ» — не статический ключ доступа и не авторизованный ключ.
  2. В поле «Область действия» отметьте все три области: yc.ai.languageModels.execute, yc.ai.imageGeneration.execute и yc.search-api.execute. Ключ с одной областью подойдёт для текстов, но не для SEO-анализа.
  3. Нажмите «Создать» и сразу скопируйте секретный ключ: Яндекс показывает его один раз.
Меню «Создать новый ключ» сервисного аккаунта Yandex Cloud с пунктом «Создать API-ключ»
Нужен именно API-ключ.
Окно «Новый ключ» в Yandex Cloud с тремя областями действия
Отметьте три области действия и нажмите «Создать».

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

  1. Откройте «SmartyPress AI» → «Настройки» и щёлкните по карточке «Yandex».
  2. Вставьте секретный ключ в поле «API-ключ» (API Key).
  3. В поле «ID каталога» (Folder ID) укажите ID из первого шага.
  4. Нажмите «Сохранить настройки провайдера» (Save Provider Settings).
Форма Yandex в SmartyPress AI: API-ключ сервисного аккаунта, подсказка о ролях и поле «ID каталога»
Для Яндекса нужны два значения: API-ключ сервисного аккаунта и ID каталога.

Под полем ключа плагин сам напоминает про роли, области действия и биллинг — если подключение не прошло, начните проверку с этого списка.

Модели Яндекса

Модель Что это
YandexGPT Lite
yandexgpt-lite		 Быстрая и недорогая, выбрана по умолчанию. Подходит для заголовков, описаний и правки текста.
YandexGPT Pro
yandexgpt		 Старшая модель: лучше держит структуру длинной статьи.
YandexART
yandex-art		 Генерация картинок в разделе «Генерация изображений».

Цены — на странице тарифов Foundation Models; оплата в рублях с привязанной карты.

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

  • 401 Unauthorized — неверный ключ или вместо API-ключа вставлен статический ключ доступа.
  • 403 Permission denied — у сервисного аккаунта нет нужной роли, у ключа нет нужной области действия или в облаке не активирован платёжный аккаунт. Для SEO-анализа нужна роль search-api.webSearch.user и область yc.search-api.execute.
  • Каталог не найден — в «ID каталога» попал ID облака, а не каталога, или лишний пробел. Откройте нужный каталог в консоли и скопируйте ID из адресной строки ещё раз.

Что дальше