ворд-пресс.рф
Решение

Как подключить Yandex AI Studio к WordPress: API-ключ, модели и SEO

Подробная инструкция: получить API-ключ и Folder ID, настроить Yandex AI Studio Assistant, выбрать модель, работать с контентом и создавать черновики.

Опубликовано: 10.10.2026Обновлено: 10.10.2026

Чтобы подключить Yandex AI Studio к WordPress, установите Yandex AI Studio Assistant, создайте API-ключ в Yandex AI Studio, узнайте Folder ID каталога Yandex Cloud и сохраните эти данные во вкладке Yandex AI → Подключение. После теста соединения можно анализировать контент и создавать SEO-черновики с подтверждением.

Исходники и установочный ZIP: GitHub. Официальный быстрый старт Яндекса.

Что понадобится

  • Административный доступ к WordPress 6.0+ и PHP 7.4+.
  • Каталог в Yandex Cloud и доступ к Yandex AI Studio.
  • Платёжный аккаунт или другой разрешённый способ оплаты использования API.
  • Folder ID каталога и API-ключ. Для выполнения запросов обычно нужна роль ai.languageModels.user у сервисного аккаунта и область действия yc.ai.foundationModels.execute у ключа.

Плагин и исходный код бесплатны. Использование API модели может быть платным — проверьте действующие тарифы перед началом.

Шаг 1. Найдите Folder ID каталога

  1. Откройте Yandex Cloud и выберите облако и каталог, в котором хотите использовать модели.
  2. При необходимости создайте отдельный каталог для WordPress-интеграции — так удобнее отделить права и расходы.
  3. Скопируйте идентификатор каталога (Folder ID) из информации о выбранном каталоге. Не путайте его с названием каталога, идентификатором облака и ключом API.
  4. Убедитесь, что у каталога разрешён доступ к нужным моделям и настроен биллинг.

Шаг 2. Получите API-ключ Yandex AI Studio

  1. Откройте интерфейс AI Studio.
  2. В разделе создания API-ключей нажмите «Создать API-ключ».
  3. Задайте понятное название, например «WordPress AI Assistant», и ограниченный срок действия в соответствии с вашей политикой безопасности.
  4. Сохраните выданный секретный ключ сразу в менеджер паролей. Повторный просмотр секретной части после закрытия диалога может быть невозможен.
  5. Проверьте полномочия сервисного аккаунта и область действия ключа: ai.languageModels.user и yc.ai.foundationModels.execute.

В AI Studio ключ может выпускаться вместе с сервисным аккаунтом. Если вы используете собственный сервисный аккаунт, настройка ролей может отличаться. Сверяйте права по документации Яндекса.

Никогда не вставляйте ключ в статью, промпт, скриншот или открытый GitHub-репозиторий.

Шаг 3. Установите WordPress-плагин

  1. Откройте репозиторий Yandex AI Studio Assistant и скачайте архив v1.1.0.
  2. В административной панели сайта выберите Плагины → Добавить плагин → Загрузить плагин.
  3. Выберите ZIP, установите и активируйте.
  4. Слева появится меню Yandex AI, включающее «ИИ-помощник», «Подключение», «Как пользоваться».

Карточка проекта: Yandex AI Studio Assistant для WordPress.

Шаг 4. Настройте модель и проверьте соединение

  1. Откройте Yandex AI → Подключение.
  2. Укажите Folder ID и секретный API-ключ.
  3. Выберите модель из выпадающего списка; рядом отображаются назначение и окно контекста. Для неизвестного ID выберите пользовательскую модель.
  4. Нажмите «Сохранить настройки».
  5. Для уточнения доступа нажмите «Показать доступные модели каталога». Этот список может потребовать дополнительного разрешения yc.ai.models.viewer; его отсутствие не означает, что генерация текста недоступна.
  6. Нажмите «Проверить подключение». Это реальный запрос, который может тарифицироваться. Дождитесь сообщения об успехе или коде ошибки.

Как выбрать модель

  • Alice AI LLM Flash — Подходящая задача: Короткие описания, метатеги, быстрая редактура
  • Alice AI LLM — Подходящая задача: Более развёрнутый анализ и генерация
  • YandexGPT Pro 5.1 — Подходящая задача: Русскоязычные тексты, SEO-анализ, редактура
  • YandexGPT Lite 5 — Подходящая задача: Простые задачи и короткие ответы
  • Qwen3.6 35B — Подходящая задача: JSON-структуры, технические инструкции, CPT/ACF
  • DeepSeek V4 Flash / V4.1 — Подходящая задача: Анализ больших текстов и структур
  • GPT-OSS 120B — Подходящая задача: Дополнительный вариант; проверьте срок поддержки в каталоге

Доступность, идентификаторы и поведение моделей могут меняться. Не ориентируйтесь на один лишь размер контекстного окна. Смотрите каталог моделей и прайс-лист.

Шаг 5. Разберите структуру сайта перед первой задачей

  1. Перейдите в Yandex AI → ИИ-помощник.
  2. Выберите тип контента — обычную запись (post), страницу (page) или доступный CPT.
  3. Нажмите «Посмотреть контракт выбранного типа».
  4. Посмотрите список доступных ACF-полей, таксономий и других ограничений.
  5. Для редактирования выберите конкретный материал; для общего анализа можно оставить выборку последних опубликованных материалов.

Плагин не читает исходный PHP-код темы и произвольную бизнес-логику. Если шаблон требует дополнительные поля, их следует явно включить в контракт. Практический пример — в руководстве по CPT и ACF.

Шаг 6. Обсудите материалы сайта с моделью

Выберите режим «Обсудить контент сайта», тип записи и при необходимости строку поиска. Введите запрос, например:

Какие вопросы недостаточно раскрыты в этих публикациях? Предложи 5 тем для новых статей и объясни, какой пользовательский запрос каждая из них закрывает. Не утверждай, что проверил весь сайт.

Подтвердите передачу данных. Плагин отправляет ограниченный контекст (до 16 материалов для аналитической выборки), а не весь сайт. Ответы требуют редакторской проверки.

Шаг 7. Проанализируйте SEO-контент

Выберите «Проанализировать материалы». Можно запросить:

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

Плагин не подключается к Яндекс.Вебмастеру или Метрике и не измеряет настоящие позиции. Он анализирует только переданные текстовые данные и контракт сайта.

Шаг 8. Создайте запись с Yoast SEO

  1. Выберите «Подготовить новую запись» и CPT post либо другой поддерживаемый тип.
  2. Опишите тему, поисковый интент, факты, желаемую структуру и целевую аудиторию.
  3. Установите флажок согласия на передачу данных и отправьте задачу.
  4. Проверьте в предпросмотре title, slug, excerpt, content_html, seo_title, meta_description, focus_keyphrase и доступные ACF/таксономии.
  5. Нажмите «Создать черновик» и откройте созданную запись в WordPress.
  6. Проверьте статью в редакторе: факты, ссылки, изображения, SEO, ACF-поля, таксономии. Опубликуйте вручную.

Если Yoast SEO не установлен, метаполя могут сохраниться, но сам WordPress не обязан выводить их как полноценные SEO-теги. Зелёный индикатор Yoast также не гарантирует поисковых позиций.

Шаг 9. Предложите исправления опубликованной статьи

Выберите «Предложить редактирование записи», укажите конкретный материал и задание. Плагин вернёт предпросмотр. Для опубликованной или запланированной записи будет создан отдельный черновик, не изменяющий оригинал; для черновиков и материалов на модерации допускается обновление после вашего подтверждения.

Альтернатива: хранение ключа в wp-config.php

Если не хотите хранить секрет в настройках WordPress, добавьте константы в wp-config.php выше завершающего комментария WordPress:

define( 'WPR_YAI_API_KEY', 'YOUR_SECRET_API_KEY' );
define( 'WPR_YAI_FOLDER_ID', 'YOUR_FOLDER_ID' );
define( 'WPR_YAI_MODEL', 'yandexgpt-5.1' );

Подставляйте значения только на сервере, никогда не публикуйте заполненный файл. Константы имеют приоритет над полями админки. При смене WordPress salts зашифрованный в базе ключ придётся сохранить повторно.

Возможные ошибки

  • 401 Unauthorized — Что проверить: Секретный ключ, срок действия, отзыв ключа
  • 403 Forbidden — Что проверить: Роль сервисного аккаунта, область действия ключа, доступ к модели
  • 400 Bad Request — Что проверить: ID модели и поддерживаемость Chat Completions / JSON Schema
  • 429 Too Many Requests — Что проверить: Ограничения скорости, квоты и платёжный аккаунт
  • Ошибка PHP/HTTP timeout — Что проверить: Исходящие HTTPS-запросы сервера, таймаут PHP/прокси
  • Список моделей недоступен — Что проверить: Дополнительная область yc.ai.models.viewer; генерация может работать независимо
  • Не видны поля ACF — Что проверить: Активность ACF, назначение группы полей выбранному CPT, права, ограничения обнаружения
  • Ошибка при сохранении ACF — Что проверить: Тип и допустимые значения поля, обязательность других полей шаблона
  • Не отображаются SEO-метатеги — Что проверить: Установлен ли Yoast SEO и активна ли нужная SEO-интеграция

Безопасность, расходы и ограничения

Плагин доступен администраторам с manage_options. Он использует защищённые запросы WordPress, шифрует ключ при сохранении в базе и требует подтверждения передачи контента. Не включайте в запросы персональные данные, секреты, закрытые договоры и другие сведения, которые нельзя передавать в облако.

Возможна тарификация теста и генерации по токенам. Запрос может не уложиться в лимит PHP/Nginx или API. Плагин не выполняет массовый фоновый аудит, не публикует самостоятельно, не заменяет редактора и SEO-аналитика и не даёт внешним агентам прямой доступ к WordPress.

Дополнительные материалы

Источник: https://aistudio.yandex.ru/ru/docs/ai-studio/quickstart/

Материал был полезен?

Помогите нам сделать материалы точнее и понятнее.