Решение проблем и FAQ SmartyPress AI Engine

Решение проблем и FAQ — тема этой страницы документации. Частые проблемы (404 ассетов, ошибки API, ограничения частоты запросов) и ответы на частые вопросы. Ниже — как настроить возможности и использовать их в рабочем процессе WordPress.

Решения типичных проблем и ответы на частые вопросы о SmartyPress AI Engine.

Частые проблемы

API-ключ не работает

Проверьте, что ключ указан верно (без лишних пробелов)
Убедитесь, что на аккаунте провайдера есть кредиты/баланс
Откройте карточку провайдера в «Настройках» и нажмите Сохранить настройки провайдера — плагин автоматически проверит соединение
Проверьте, нужен ли для вашего региона прокси (OpenAI)

Ошибка «Provider Not Found»

Это значит, что для выбранного провайдера не настроен API-ключ или провайдер недоступен (ошибка: Provider not found or not configured).

Перейдите в «Настройки» и добавьте ключ хотя бы для одного провайдера
Убедитесь, что провайдер выбран как «Провайдер по умолчанию»

Ошибки ограничения частоты запросов (429)

Вы отправляете слишком много запросов. Решения:

Подождите несколько секунд и попробуйте снова
Временно переключитесь на другого провайдера
При массовой генерации повторите неудачные элементы из управления заданием; некоторые провайдеры (например, OpenRouter) также автоматически повторяют запросы с ограничением частоты

Уведомление о постоянных ссылках

Если видите уведомление о постоянных ссылках, откройте Настройки → Постоянные ссылки и выберите любую структуру, кроме «Простые». Сохраните изменения.

Логирование отладки

Чтобы разобрать проблемы с API:

Откройте SmartyPress AI → Настройки.
Включите Включить логирование отладки в блоке Настройки отладки.
При необходимости включите Также логировать успешные запросы для полного логирования запрос/ответ.
Воспроизведите проблему.
Откройте логи по ссылке Открыть журнал API в «Настройках отладки» или через пункт Журналы в боковом меню SmartyPress AI (#/logs).

В логах есть: время, провайдер, модель, данные запроса, ответ и ошибки. Они автоматически удаляются через 7 дней.

Частые вопросы

SmartyPress AI Engine бесплатный?

Да, полностью бесплатный и с открытым исходным кодом. Вы платите только за использование API выбранному провайдеру ИИ.

Сколько стоит генерация контента?

Заголовок: ~$0.001–$0.01
Полная статья (500–1000 слов): ~$0.02–$0.10
DeepSeek в 10–50 раз дешевле OpenAI

Какие языки поддерживаются?

Модели ИИ поддерживают все основные языки. Укажите язык в «Настройках» или для конкретной генерации. Интерфейс плагина доступен на английском и русском.

Можно ли использовать с WooCommerce?

Да. Включите Товары в параметре Включённые типы записей. Работает с описаниями товаров, заголовками и краткими описаниями.

Безопасны ли мои данные?

Да. Данные отправляются провайдерам ИИ только когда вы нажимаете «Сгенерировать». Нет фоновых запросов, трекинга и аналитики. API-ключи хранятся в базе WordPress. Вся связь идёт по HTTPS.

Что происходит при удалении плагина?

Все настройки плагина и API-ключи удаляются. Сгенерированный контент (записи, страницы, изображения) сохраняется — это ваш контент.

Можно ли ограничить, кто пользуется функциями ИИ?

Да, плагин учитывает права доступа WordPress:

edit_posts — нужно для волшебной палочки и генерации контента
publish_posts — нужно для массовой генерации
upload_files — нужно для Image ALT Generator
manage_options — нужно для «Настроек»

Как работает SEO Optimization?

Модуль SEO Optimization читает непройденные SEO-проверки из Rank Math (или использует встроенный анализатор), затем генерирует целевые исправления ИИ по каждой проблеме — расстановка ключевых слов, плотность, читабельность, длина контента и метаполя. Вы просматриваете предложенные изменения в diff-виде и применяете их одним кликом. Включите модуль в SmartyPress AI → Компоненты, затем откройте любую запись в Gutenberg и используйте Исправить ошибки SEO в меню SmartyPress AI Writer либо кнопку Исправить ошибки SEO с помощью ИИ / Исправить ошибки во внедрённой панели Rank Math или Yoast SEO.

Можно ли массово генерировать alt-текст для изображений?

Да. Модуль Image ALT Generator поддерживает массовую обработку всей медиатеки. Сначала проиндексируйте библиотеку, затем выберите изображения (или отфильтруйте по «Без ALT») и запустите задание массовой генерации. Модуль анализирует каждое изображение с помощью AI vision и генерирует alt-текст, подписи, заголовки и описания. Также можно включить автогенерацию для новых загрузок. Полные подробности — в документации Image ALT Generator.

Что такое OpenRouter и зачем его использовать?

OpenRouter — агрегатор моделей ИИ, который даёт доступ к 200+ моделям от десятков провайдеров (Meta Llama, Mistral, Google Gemini, Anthropic и другие) через один API-ключ. Удобно, когда нужно пробовать разные модели без множества аккаунтов, получить доступ к специализированным моделям (например, веб-поиск, vision) или найти самую дешёвую модель под задачу. В SmartyPress задайте API-ключ OpenRouter в «Настройках» и выберите, какие текстовые модели и модели изображений включить.

Почему в «Настройках» не видно YandexGPT или GigaChat?

Провайдеры Yandex и GigaChat видны только когда локаль сайта WordPress установлена в ru_RU (русский). Эти провайдеры рассчитаны на российский рынок. Чтобы их включить, откройте Настройки → Общие → Язык сайта и выберите «Русский». После сохранения карточки Yandex и GigaChat появятся в настройках SmartyPress AI.

Чек-лист решения проблем и FAQ

Рабочий процесс решения проблем и FAQ лучше воспринимать как повторяемую процедуру, а не разовую настройку. Сначала убедитесь, что связанный с этой страницей модуль SmartyPress AI Engine включён, затем проверьте провайдер, модель, язык и типы записей по умолчанию — и только после этого запускайте функцию на боевом контенте. Так результат остаётся предсказуемым и проще сравнивать ответы OpenAI, DeepSeek, OpenRouter, Yandex GPT и GigaChat. Используйте этот чек-лист, когда документируете, тестируете или обучаете другого редактора работе с решением проблем и FAQ. Он помогает держать настройку в согласии с правами WordPress, полями Rank Math SEO и редакционным процессом сайта. Если результат отличается от ожидаемого, повторите тот же чек-лист с более коротким промптом и меньшей температурой, прежде чем менять глобальные настройки.

Убедитесь, что нужный модуль SmartyPress AI включён на экране «Компоненты».
Откройте «Настройки», карточку провайдера в блоке Провайдеры ИИ, введите действительный API-ключ и нажмите Сохранить настройки провайдера (плагин автоматически проверяет соединение).
Выберите модель под задачу: быстрые — для черновиков, премиум — для финальных маркетинговых текстов, с веб-поиском — для исследований.
Перед генерацией проверьте язык вывода, температуру, max tokens и переменные промптов.
Сначала сохраните результат как черновик, затем проверьте заголовки, ссылки, факты и SEO-поля перед публикацией.

Решение проблем и FAQ