SmartyPress AI Engine Documentation Article

Модуль генерации alt-текста изображений

Image ALT Generator — модуль создаёт SEO-дружественные alt-тексты, подписи, заголовки и описания для изображений в медиатеке WordPress. Можно обработать всю библиотеку массово или автоматически генерировать метаданные при загрузке новых файлов.

Хороший alt-текст повышает доступность, помогает поисковым системам понимать изображения и улучшает SEO-показатели. Модуль использует vision-модели ИИ для анализа картинок и автоматически формирует точные описания с учётом ключевых слов.

Включение модуля

  1. Перейдите в SmartyPress AI → Components (#/components).
  2. Найдите Image ALT Generation в списке модулей.
  3. Нажмите Activate, если модуль выключен (по умолчанию включён).
  4. В меню SmartyPress AI появится страница Image ALT Generation по адресу #/image-alt-generation.

Структура экрана

На странице две вкладки и постоянная боковая панель:

  • Bulk Generation — индексация, фильтры, таблица изображений и генерация по строкам
  • Upload Settings — автогенерация при загрузке в медиатеку
  • Боковая панель Generation settings — vision-модель, текстовая модель, язык и переключатели полей

Режимы генерации

Анализ изображений управляется параметром Image analysis в боковой панели:

Режим Как работает Когда лучше
Enabled (vision, по умолчанию) Vision-модель ИИ анализирует сам файл изображения, затем текстовая модель генерирует метаданные Отдельные изображения, фото товаров, скриншоты
Disabled (контекст) ИИ опирается на окружающий текст записи, имя файла и SEO-ключевые слова — без анализа картинки Изображения, уже описанные текстом рядом, декоративные картинки
Требования к режиму vision: нужен провайдер с поддержкой изображений на входе — OpenAI, OpenRouter (модели с поддержкой изображений) или Claude (Anthropic).

Что генерируется

В боковой панели в блоке Generation Options выберите, какие поля метаданных создавать:

  • Generate ALT — основное описание для доступности (самое важное для SEO)
  • Generate caption — видимая подпись под изображением
  • Generate title — заголовок вложения в WordPress
  • Generate description — полное поле описания вложения
  • Use SEO focus keyword context — вплетать фокусные ключевые слова из связанной записи в метаданные

Генерация для одного изображения

  1. Перейдите в SmartyPress AI → Image ALT Generation (#/image-alt-generation).
  2. Оставайтесь на вкладке Bulk Generation.
  3. Просмотрите, найдите или отфильтруйте изображения медиатеки.
  4. В столбце Actions нажмите Generate Metadata для одного изображения.
  5. Сгенерированные поля записываются сразу согласно настройкам боковой панели.

Массовая генерация

Обработка нескольких изображений за раз:

  1. Перейдите в SmartyPress AI → Image ALT Generation.
  2. На вкладке Bulk Generation выберите Post types to index.
  3. При необходимости отфильтруйте таблицу: All images, Missing ALT, Has ALT, Missing caption или поиск по имени файла/заголовку.
  4. Нажмите Start bulk generation.
  5. Сначала модуль индексирует медиатеку, затем запрашивает подтверждение с числом подходящих изображений.
  6. После подтверждения изображения обрабатываются пакетами (размер пакета 1–5 в боковой панели) с индикатором прогресса.
Массовая генерация alt-текста в SmartyPress AI с живым индикатором прогресса
Изображения обрабатываются по одному пакету; запуск можно отменить в любой момент.
Совет: Отдельных кнопок «Index Library» или «Select All» нет. Индексация — часть Start bulk generation, а очередь заданий строится из текущих фильтров и типов записей.

Автогенерация при загрузке

Включите автоматическую генерацию alt-текста для каждого нового изображения на сайте:

  1. Откройте вкладку Upload Settings.
  2. Включите Automatically generate ALT when an image is uploaded to Media Library.
  3. Загрузки ставятся в очередь через WP-Cron, чтобы запрос медиатеки не блокировался медленным ИИ-провайдером.
Совет: Автогенерация лучше всего работает с включённым vision-анализом и быстрой недорогой vision-моделью, например GPT-4o Mini.

Интеграция с SEO-ключевыми словами

Модуль может включать SEO-ключевые слова в сгенерированный alt-текст:

  • При включённом Use SEO focus keyword context модуль читает фокусное ключевое слово из связанной записи (Rank Math, Yoast, AIOSEO или метаданные SmartyPress).
  • Ключевые слова вплетаются в alt-текст естественно — не просто добавляются в начало или конец.
  • В каждой строке таблицы также показываются контекст связанной записи и обнаруженные фокусные ключевые слова, если они есть.

Настройки боковой панели

Параметр По умолчанию Описание
Image analysis Enabled (vision) Использовать vision-модель или отключить и генерировать только из контекста записи/SEO/имени файла
Vision provider / model (первый доступный) Провайдер и модель для анализа изображения
Text provider / model (первый доступный) Провайдер и модель для итогового текста ALT/подписи/заголовка/описания
Poor context prompt (встроенный шаблон) Резервный промпт, если анализ выключен и контекст слабый
Language (язык сайта) Язык вывода сгенерированных метаданных
Max ALT length 125 Максимальная длина alt-текста в символах (40–300)
Batch size 1 Число изображений в пакете при массовом режиме (1–5)
Generate ALT On Генерировать alt-текст для изображений
Generate caption On Генерировать видимые подписи
Generate title Off Генерировать заголовки вложений
Generate description Off Генерировать полные описания
Use SEO focus keyword context On Учитывать фокусное ключевое слово из связанной записи
Auto-generate on Upload Off Настраивается на вкладке Upload Settings
Прокрутить вверх