10. ALT-тексты: по шаблону и через GigaChat (Премиум)

ALT — это текстовое описание картинки. Оно нужно поисковым системам и людям, которые пользуются экранными дикторами. Функция «Генерация ALT-текста» находится на вкладке «Функции» в блоке «Альтернативный текст» и доступна в редакции «Премиум».

Общие правила

ALT добавляется только к тегам img без атрибута alt. Если alt у картинки уже есть — в том числе пустой alt="" у декоративной картинки — плагин его не изменяет.
Текст безопасно экранируется для атрибута, в нём допустимы кавычки и угловые скобки.
Предел длины — 255 символов (не байт); длиннее — обрезается с многоточием. Кириллица и эмодзи не обрываются посередине.
Для каждой картинки ALT генерируется один раз при обработке и сохраняется; при каждом просмотре страницы запросов к нейросети нет.
Если ALT не появился, возможно, у тега уже есть alt (это штатно).

Метод 1. Шаблон с переменными (без нейросети)

Выберите «Использовать переменные (шаблон)» и напишите шаблон. Доступные переменные:

Переменная	Что подставляется
`{$image_name}`	имя файла картинки
`{$image_alt}`	текущий ALT картинки
`{$page_title}`	заголовок страницы
`{$page_keywords}`	ключевые слова страницы

Примеры: {$page_title}: {$image_alt} → «Каталог товаров: Фото товара»; {$image_alt} | {$page_keywords}. Переменные можно сочетать с обычным текстом.

Метод 2. GigaChat (нейросеть)

Выберите «Использовать ИИ (GigaChat)». Плагин передаёт картинку сервису GigaChat (Сбер) и получает краткое описание. Это внешний сервис: использование может быть платным у провайдера и подчиняется его условиям.

Где взять токен

Зарегистрируйтесь на сайте GigaChat для разработчиков (developers.sber.ru, ссылка есть рядом с полем в настройках).
Создайте проект GigaChat API.
Получите «Ключ авторизации» (Authorization key) и вставьте его в поле «API-ключ для GigaChat».
Нажмите «Сохранить». После сохранения ключ на страницу не передаётся: вы увидите «Ключ задан» и кнопки «Заменить ключ» и «Очистить ключ».

Ключ используется только для генерации ALT. Не передавайте его третьим лицам.

Плагин обращается к GigaChat с областью доступа для физических лиц (GIGACHAT_API_PERS), модель — GigaChat Pro. Работа с другими областями доступа (например, для юридических лиц) не проверялась.

Шаблон запроса

Поле «Шаблон ALT-текста» — это подсказка нейросети: что описывать, в каком стиле и какой длины. Примеры: «Краткое описание товара, 5–7 слов», «Альтернативный текст для изображения товара с акцентом на SEO». Чем точнее шаблон, тем лучше результат. Не оставляйте поле пустым.

Что отправляется в GigaChat

Файл самой картинки (оригинал с вашего сервера) — загружается на сторону GigaChat на время запроса.
Текст вашего шаблона запроса.
Ваш ключ авторизации — только для получения временного токена доступа.

Не отправляются: данные покупателей, адреса и содержимое страниц, заказы. После получения ответа загруженный файл удаляется на стороне GigaChat. Прежде чем включать функцию, убедитесь, что вы вправе передавать свои картинки внешнему сервису (например, для фото людей).

Технические подробности и ограничения

Проверка сертификата всегда включена. Соединение с GigaChat проверяется корневым сертификатом НУЦ Минцифры (Russian Trusted Root CA), который входит в состав плагина. Отключить проверку нельзя. Если ваш сервер блокирует исходящие соединения, обращения не пройдут.
Токен доступа получается один раз на серию запросов, а не на каждую картинку.
При сетевом сбое, а также при ответах 429 и 5xx запрос повторяется с паузой (не дольше 20 с). Платный запрос чата после ошибки 5xx или потерянного ответа не повторяется, чтобы не списывать деньги дважды.
На обработку внешних вызовов для одной картинки отводится 60 секунд (параметр --external-budget фоновой команды).
Стоимость и лимиты запросов определяет ваш тариф GigaChat, а не плагин.
В версии 3.3.0 токен GigaChat был доступен через публичный адрес плагина, а запросы шли без проверки сертификата. Если вы использовали GigaChat на 3.3.0, замените токен и отзовите старый (раздел 13).

Если ALT не создаётся

Проверьте, что переключатель «Генерация ALT-текста» включён, метод выбран, ключ задан (на странице «Ключ задан»).
Посмотрите вкладку «Диагностика» → «Последние ошибки».
Убедитесь, что у тега img нет атрибута alt: если он есть, плагин его не трогает.
Проверьте, что с сервера доступны адреса GigaChat (исходящие соединения не заблокированы файрволом хостинга).
Если запросы стали отклоняться из-за лимита или оплаты, проверьте тариф GigaChat.