Документация

FAQ и устранение неполадок

Ответы на частые вопросы и решения типичных проблем при работе с KWP AI Product Studio (версия 1.2.2).

Частые вопросы (FAQ)

Когда списываются токены?

Токены списываются, когда плагин отправляет задачу на сервер wp.kalinin.pro и приходит успешный ответ от нейросети. Окно предпросмотра показывает уже готовый результат — к этому моменту списание уже выполнено. Нажатие Применить дополнительно не списывает. Повторная генерация — новая задача и новое списание. Режим веб-поиска для SEO обычно дороже обычной генерации.

Можно ли использовать одну лицензию на нескольких сайтах?

Да, если это позволяет тариф (например, 1, 3 или безлимит доменов). Добавьте домены в карточке лицензии в личном кабинете, пока не исчерпан лимит. Подробнее — в статье «Личный кабинет: лицензии и токены».

Нужен ли Yoast SEO?

Для генерации SEO title и meta description — да, Yoast SEO должен быть установлен и активен. Для описаний, характеристик и картинок Yoast не обязателен.

Перезапишет ли автогенерация уже заполненные поля?

Нет. Автогенерация заполняет только пустые поля. Ручная генерация на карточке товара также применяется по вашему решению через preview → «Применить».

Почему тексты «универсальные», без привязки к магазину?

Заполните поля О магазине и Целевая аудитория на вкладке «Стиль генерации». На карточке товара добавьте проверенные факты в блоке «Контекст для AI».

Устранение неполадок

Проблема Что проверить
Кнопки генерации неактивны Лицензия на вкладке Подключение — статус Активна; нажмите Подключить
Сообщение «Insufficient credits» Баланс токенов в личном кабинете; пополните и нажмите подключить
Подключение не проходит / лицензия не активна Домен в личном кабинете совпадает с доменом сайта; ключ скопирован полностью; сайт доступен по HTTPS
Кнопки SEO не видны Установлен и активен плагин Yoast SEO
Не подгружаются размеры картинки Лицензия активна; обновите плагин до актуальной версии; проверьте "подключение"
Ошибка API с ID запроса Сохраните ID запроса из сообщения; включите лог на вкладке «Подключение»; обратитесь в поддержку
Ошибка 422 / «поле слишком длинное» при картинке Обновите плагин до версии 1.1.0 или новее
provider_error — model not available Смените модель изображения на вкладке «Стиль генерации → Изображение» (например, Qwen Image)
Описания пропали после «Применить» характеристики Обновите плагин до 1.1.0+; для каждого описания нажимайте «Применить» в preview до генерации характеристик
Пустая панель KWP AI в блочном редакторе Обновите плагин до 1.2.1+; обновите страницу (Ctrl+F5)
Старый интерфейс после обновления Жёсткое обновление страницы: Ctrl+F5 или Cmd+Shift+R
Автогенерация не запускается Автогенерация включена и сохранена; настроен WP-Cron или system cron; есть товары с пустыми полями по выбранным целям
Автогенерация остановилась сама Нормально, если «Осталось» = 0 — все пустые поля по аудиту заполнены. Нажмите «Проверить» для нового скана

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

На вкладке Подключение можно включить запись лога работы плагина в файл.

  1. Отметьте Записывать лог работы плагина в файл.
  2. Сохраните настройки.
  3. Воспроизведите проблему (генерация или автогенерация).
  4. Нажмите Скачать лог за сегодня.

Настройки логирования на вкладке Подключение

Рис. 1 — вкладка «Подключение»: включение лога, скачивание и очистка старых файлов.

В лог не записываются: полный лицензионный ключ и тексты ответов AI. При обращении в поддержку приложите лог и ID запроса из сообщения об ошибке — не отправляйте лицензионный ключ.

Обращение в поддержку

Подготовьте:

  • Домен сайта
  • Версию плагина (в заголовке страницы KWP AI Product Studio, например v1.2.2)
  • ID запроса из ошибки
  • Краткое описание: какая кнопка, что ожидали, что получили
  • Фрагмент лога (если включён)

Глоссарий

Термин Значение
Лицензия Право использования плагина на доменах в пределах лимита тарифа; проверяется через wp.kalinin.pro
Токены Единица оплаты AI-задач; списываются при отправке задачи и получении ответа с сервера
Preview (предпросмотр) Окно с результатом генерации до применения к товару; токены к этому моменту уже списаны
fill_missing Режим автогенерации: заполняются только пустые поля, без перезаписи
Студийное фото (studio) Режим картинки — реалистичное фото товара на нейтральном фоне
Карточка маркетплейса (marketplace) Режим картинки — инфографика и надписи в стиле маркетплейса
Backlog Очередь товаров с пустыми полями по результатам проверки «Проверить»
ID запроса Уникальный код запроса к API — указывайте в обращении в поддержку

Связанные статьи

  • «Быстрый старт»
  • «Личный кабинет: лицензии и токены»
  • «Установка и подключение плагина»
  • «Настройки стиля генерации»
  • «Работа с карточкой товара»
  • «Фоновая автогенерация»
autor

Александр Калинин

Большой опыт работы в сфере оптимизации и создания сайтов. Помогу с решением важных вопросов.

Комментарии

Популярные статьи

Может быть интересно

Оставьте номер телефона и мы поможем вам