SmartyPress AI Engine Documentation Article

Провайдер Yandex GPT

Подключение Yandex GPT: API-ключ сервисного аккаунта и Folder ID — роли, scopes, биллинг и настройка в SmartyPress.

Провайдер Yandex GPT — тема этой страницы документации. Подключите Yandex GPT с помощью API-ключа и Folder ID для генерации русскоязычного текста и изображений YandexART в SmartyPress AI Engine.

Yandex GPT доступен только при локали WordPress ru_RU (get_locale() === 'ru_RU'). В остальных локалях карточка провайдера Yandex в настройках не отображается.

Примечание: Yandex GPT появляется в настройках только при локали сайта ru_RU (Настройки → Общие → Язык сайта → Русский). На любой локали всегда доступны провайдеры OpenAI, DeepSeek, Claude и OpenRouter.
Важно: Если сменить язык сайта с русского, Yandex GPT исчезнет из интерфейса настроек и провайдер перестанет инициализироваться, даже если учётные данные были сохранены ранее.

Как получить API-ключ Yandex и Folder ID

Используйте API-ключ сервисного аккаунта Yandex Cloud с правом выполнять запросы к Foundation Models. SmartyPress передаёт ключ как Authorization: Api-Key. Тот же ключ обслуживает текст YandexGPT, изображения YandexART и SEO-анализатор (поиск конкурентов и Wordstat).

  1. Войдите в console.yandex.cloud, откройте свой каталог и скопируйте Folder ID из URL (строка после /folders/). Затем откройте плитку Identity and Access Management.
  2. На странице Service accounts нажмите Create service account.
  3. Задайте имя аккаунта (например, smartypress-ai-engine), краткое описание и назначьте роли каталога:
    • ai.languageModels.user — генерация текста YandexGPT
    • ai.imageGeneration.user — изображения YandexART
    • search-api.webSearch.user — SEO-анализатор: поиск конкурентов и Wordstat

    Затем нажмите Create.

  4. Откройте новый сервисный аккаунт, нажмите + Create new key и выберите Create API key (не статический ключ доступа).
  5. В диалоге New key выберите все три области действия (scopes):
    • yc.ai.languageModels.execute
    • yc.ai.imageGeneration.execute
    • yc.search-api.execute

    Ключ с одной областью действия не подойдёт для SEO-анализатора. Нажмите Create и сразу скопируйте секрет — он показывается только один раз.

Консоль Yandex Cloud: Folder ID в URL и выделенная плитка Identity and Access Management
Откройте console.yandex.cloud, выберите каталог, скопируйте Folder ID из URL и откройте Identity and Access Management.
Страница сервисных аккаунтов Yandex Cloud с выделенной кнопкой Create service account
В Identity and Access Management → Service accounts нажмите Create service account.
Диалог создания сервисного аккаунта в Yandex Cloud с назначенными ролями
Задайте имя аккаунта (например, smartypress-ai-engine) и роли ai.languageModels.user, ai.imageGeneration.user и search-api.webSearch.user, затем нажмите Create.
Страница сервисного аккаунта Yandex Cloud: открыто меню Create new key, выделено Create API key
На странице сервисного аккаунта нажмите + Create new key и выберите Create API key — не статический ключ доступа.
Диалог New key в Yandex Cloud с выбранными областями действия API-ключа
Выберите scopes yc.ai.languageModels.execute, yc.ai.imageGeneration.execute и yc.search-api.execute, нажмите Create и сразу скопируйте секрет.
Нужен биллинг: Привяжите платёжную карту к платёжному аккаунту облака. Без активного биллинга Search API отвечает 403 Permission denied, поэтому SEO-анализатор не сможет запускать поиск конкурентов и Wordstat.

Настройка в SmartyPress

  1. Перейдите в SmartyPress AI → Settings (#/settings) и откройте карточку провайдера Yandex.
  2. Вставьте секрет в поле API Key (отправляется как Authorization: Api-Key) и укажите Folder ID, скопированный из URL консоли.
  3. Нажмите Save Provider Settings — SmartyPress сохранит учётные данные и автоматически проверит соединение. Отдельной кнопки Test Connection нет.
  4. Вернитесь в General Settings, при необходимости выберите Yandex как Default Provider, укажите Default Model (по умолчанию в плагине — YandexGPT Lite) и нажмите Save Changes.

Доступные модели

Текстовые модели — статический список, поставляемый с плагином:

  • YandexGPT Lite — быстрая и доступная по цене (по умолчанию)
  • YandexGPT Pro — более высокое качество результата

Генерация изображений использует YandexART, когда вы запускаете функции изображений через провайдера Yandex.

Прокрутить вверх