SmartyPress AI Engine Статья документации

Alt-текст для изображений: генератор на нейросети

Нейросеть смотрит на картинку и пишет alt и подпись — к одной картинке, ко всей медиатеке или сразу при загрузке.

Alt-текст для изображений нужен поисковикам и людям, которые слушают сайт экранным диктором. Вписывать его руками к сотням картинок долго, поэтому чаще его просто нет. SmartyPress смотрит на картинку нейросетью, учитывает запись, в которой она стоит, и пишет alt атрибуты изображений сам — к одной картинке или ко всей медиатеке.

Как плагин пишет alt

Работают две модели по очереди:

  1. Vision-модель смотрит на картинку и описывает, что на ней.
  2. Текстовая модель пишет из этого описания alt и подпись на нужном языке. Она учитывает заголовок записи, где стоит картинка, и её фокусное ключевое слово.

Смотреть на картинки умеют не все нейросети:

Провайдер Анализ картинки
GigaChat Да: GigaChat 2 Pro и GigaChat 2 Max. Только JPEG и PNG до 15 МБ.
OpenAI, Claude Да
OpenRouter Да, моделями, которые принимают картинку на вход
DeepSeek, YandexGPT Нет — подходят только для второго шага, текста

Удобная связка для русского сайта — GigaChat 2 Pro смотрит, DeepSeek пишет. Так сделано во всех примерах ниже.

Экран «Генерация ALT изображений»

Откройте «SmartyPress AI» → «Генерация ALT изображений» (Image ALT Generation).

Экран «Генерация ALT изображений»: вкладки, типы записей для индексации, кнопка «Начать массовую генерацию» и таблица картинок
Экран ALT: массовая генерация, фильтр картинок и кнопка у каждой картинки.
  1. Вкладки «Массовая генерация» (Bulk Generation) и «Настройки загрузки» (Upload Settings).
  2. «Начать массовую генерацию» (Start bulk generation) — подписать все картинки разом.
  3. Фильтр таблицы: «Все изображения», «Без ALT», «С ALT», «Без подписи». Выберите и нажмите «Поиск».
  4. «Сгенерировать метаданные» (Generate metadata) — подписать одну картинку.

В таблице видно, чего у картинки не хватает, и откуда плагин возьмёт контекст:

Строки таблицы ALT: у картинок нет alt и подписи, в колонке «Контекст» — запись, к которой картинка относится
В колонке «Контекст» — запись, где стоит картинка. Её заголовок и ключевое слово плагин учтёт в alt.
  1. Метаданные — есть ли alt, подпись, заголовок и описание.
  2. Контекст — запись, где стоит картинка: как миниатюра, вложение или в тексте. Если у записи есть фокусное ключевое слово, оно тоже здесь. Картинкам без записи достанется только то, что видно на них самих.

Настройки генерации

Настройки — в правой колонке, на обеих вкладках. Кнопки «Сохранить» нет: плагин сохраняет изменения сам через секунду и пишет «Настройки сохранены».

Настройки генерации ALT: анализ изображения, vision-провайдер GigaChat, текстовый провайдер DeepSeek
Сначала vision-модель смотрит на картинку, потом текстовая модель пишет alt и подписи.
  1. Анализ изображения (Image analysis). «Включено» — нейросеть смотрит на картинку. «Отключено» — alt пишется только по записи, ключевому слову и имени файла: дешевле, но точность ниже.
  2. Vision-провайдер и модель — кто смотрит на картинку.
  3. Текстовый провайдер и модель — кто пишет итоговый текст.
  4. Промпт для слабого контекста (Weak context prompt) — запасное задание на случай, когда анализ выключен, а у картинки нет ни записи, ни внятного имени файла. В нём доступны {filename}, {attachment_title}, {site_name} и {language}.
Настройки вывода ALT: язык, максимальная длина ALT, размер пакета и флажки полей, которые генерировать
Язык, длина alt и какие поля заполнять. Настройки сохраняются сами — кнопки «Сохранить» нет.
  1. Язык (Language) — на каком языке писать.
  2. Максимальная длина ALT (Max ALT length) — по умолчанию 125 символов. Больше ставить не стоит: экранные дикторы и поисковики длинный alt обрезают.
  3. Размер пакета (Batch size) — сколько картинок обрабатывать за один шаг массовой генерации.
  4. Какие поля заполнять. По умолчанию включены alt и подпись. Заголовок и описание вложения выключены — включите, если хотите заменить имена вроде «IMG_2057». «Использовать SEO focus keyword как контекст» подмешивает в alt ключевое слово записи.

Alt для одной картинки

Нажмите «Сгенерировать метаданные» в строке картинки. Через несколько секунд появится «ALT успешно сгенерирован», а в медиатеке у картинки будут alt и подпись:

Карточка картинки IMG_2057.jpg в медиатеке после генерации: alt, заголовок, подпись и описание заполнены
Alt, заголовок, подпись и описание заполнены по содержимому картинки и записи, где она стоит.

Заголовок остался «IMG_2057», потому что его генерация по умолчанию выключена.

Кнопка в строке перезаписывает alt. Если у картинки уже был хороший alt, написанный вручную, генерация заменит его. Для таких картинок кнопку не нажимайте, а массовую генерацию запускайте с фильтром «Без ALT».

Alt для всей медиатеки

  1. В «Типах записей для индексации» отметьте, картинки из каких записей обрабатывать: «Запись», «Страница».
  2. В фильтре выберите «Без ALT» — так плагин не тронет картинки, которые уже подписаны.
  3. Нажмите «Начать массовую генерацию». Плагин проиндексирует медиатеку и спросит в окне браузера: «Индексация завершена. N изображений соответствуют текущим фильтрам. Начать массовую генерацию сейчас?» Нажмите «ОК».

Дальше картинки подписываются по одной, над таблицей видно прогресс и счётчики. Не закрывайте страницу, пока идёт генерация: очередь двигает браузер.

Массовая генерация ALT завершена: счётчики индекса и картинка DSC_0112 без записи, оставшаяся без alt
Готово. В индекс попали только картинки из записей — DSC_0112 без записи остался без alt.
Массовая генерация берёт только картинки из записей. В индекс попадают картинки, которые стоят в записях выбранных типов: как миниатюра, вложение или в тексте. Картинки, которые просто лежат в медиатеке, подпишите кнопкой в строке таблицы.

Alt сразу при загрузке

На вкладке «Настройки загрузки» включите «Автоматически генерировать ALT при загрузке изображения в медиабиблиотеку».

Вкладка «Настройки загрузки»: переключатель «Генерация при загрузке»
Новые картинки можно подписывать сразу при загрузке — генерация идёт в фоне через WP-Cron.

Загрузка при этом не ждёт нейросеть: картинка встаёт в очередь WP-Cron и получает alt через минуту-другую. WP-Cron запускается при посещениях сайта, поэтому на тихом сайте очередь может двигаться медленнее.

Проверяйте, что написала нейросеть

Vision-модели иногда путают предметы. В наших примерах GigaChat дважды принял воронку для пуровера со стеклянным сервером за «кофемашину» и «кофеварку». Для декоративных картинок такая ошибка не страшна, а для товаров и инструкций перечитайте alt — исправить его можно прямо в медиатеке.

Что дальше