Инструкция · обновлено 12 мая 2026

Установка модуля ImgChanger для 1С-Битрикс

10 минут работы, без программиста. Нужны только FTP/SFTP-доступ к сайту и логин в админку Битрикса.

Ещё не скачали? — введите email на главной и получите ссылку моментально + 5 бесплатных AI-замен при установке.

Содержание

  1. Требования
  2. Скачать архив модуля
  3. Залить в /local/modules/
  4. Установить в админке Битрикса
  5. Получить лицензию (триал бесплатно)
  6. Первое сканирование
  7. Генерация и применение
  8. Бэкапы и откат
  9. Если что-то пошло не так

Требования

CMS1С-Битрикс 20.0+ любой редакции (Старт / Стандарт / Малый бизнес / Бизнес)
PHPверсия 7.4 или выше
ДоступFTP/SFTP к корню сайта + логин в админку Битрикса (роль с правами на установку модулей)
База данныхMySQL/MariaDB (любая поддерживаемая Битриксом)
Память PHPне менее 128 MB (для пакетной обработки)
Исходящий HTTPSсайт должен иметь доступ к api.imgchanger.org (для генерации)
Битрикс 17.x / 18.x или PHP 5.6/7.0 — не поддерживаются. Это конец жизненного цикла самих платформ. Перед установкой ImgChanger обновитесь — это 1-2 часа работы вашего админа и базовая гигиена.

Шаг 1. Скачать архив модуля

На главной imgchanger.org/ru/ в карточке «Триал» нажмите «Скачать модуль», введите email и нажмите «Получить ссылку». Письмо приходит в течение 1-2 минут со ссылкой на imgchanger-bitrix.zip.

Ссылка также сразу появится в окне формы — можно скачать не дожидаясь письма.

Шаг 2. Залить папку модуля в /local/modules/

Распакуйте архив локально. Внутри будет одна папка: kuratov_ru.imgchanger/.

Подключитесь к серверу по FTP/SFTP (любой клиент — FileZilla, WinSCP, Cyberduck) и загрузите эту папку целиком в директорию:

/local/modules/kuratov_ru.imgchanger/

Если папки /local/ или /local/modules/ ещё нет на сайте — создайте их (Битрикс рекомендует именно /local/, а не /bitrix/modules/: при обновлении ядра ваш модуль не пострадает).

Альтернатива через ZIP-загрузку: если у вас нет SFTP — можно использовать файловый менеджер хостинга (cPanel / ISPmanager / Plesk): создаёте /local/modules/, загружаете архив, распаковываете прямо там.

Шаг 3. Установить модуль в админке Битрикса

  1. Зайдите в админку: https://ваш-сайт/bitrix/admin/
  2. В левом меню: Marketplace → Установленные решения
  3. В списке появится строка «ImgChanger — AI-замена изображений». Нажмите «Установить».
  4. В появившемся окне согласитесь с условиями и нажмите «Применить».
  5. Модуль добавит свой пункт в главное меню админки — «ImgChanger». Обновите страницу, если не видно сразу.
Готово. Модуль установлен. Дальше — получить лицензионный ключ.

Шаг 4. Получить лицензию (триал — бесплатно)

В меню админки: ImgChanger → Настройки. Здесь два варианта.

Вариант A — триал (5 AI-замен бесплатно):

  1. В поле «Email» введите свой email (тот же, на который скачивали модуль — или любой другой)
  2. Нажмите «Получить триал»
  3. За 5-10 секунд модуль сам обратится к api.imgchanger.org, выпустит лицензию и впишет ключ в поле
  4. Сохраните настройки

Вариант B — купленная лицензия:

  1. Если вы уже оплатили пакет на imgchanger.org/ru/#price — ключ пришёл вам на email
  2. Скопируйте ключ из письма (формат: imc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)
  3. Вставьте в поле «Лицензионный ключ» в Настройках модуля
  4. Нажмите «Активировать» — модуль проверит ключ на сервере и привяжет к домену вашего сайта
Лицензия привязывается к одному домену при первой активации. Это нужно чтобы не путалась статистика. Перенос на другой домен делается через поддержку (один раз бесплатно, далее — символическая плата за смену).

Шаг 5. Первое сканирование

ImgChanger → Сканирование в меню админки.

  1. Выберите инфоблок — например «Новости», «Каталог», «Услуги», «Блог»
  2. Опционально — задайте фильтр (например «только товары категории X» или «только публикации за 2018-2020»)
  3. Нажмите «Сканировать»

Модуль найдёт все картинки внутри выбранного инфоблока:

Картинки отображаются в виде сетки с превью. Для каждой — размер, формат, путь, ссылка «Открыть на сайте».

Шаг 6. Генерация AI-замен и применение

Из результатов сканирования отметьте картинки галочками и нажмите «🪄 Сгенерировать».

  1. Модуль отправит выбранные картинки на api.imgchanger.org/v1/generate
  2. На сервере применяется модель FLUX-dev img2img — создаёт похожую, но юридически чистую картинку
  3. Каждая генерация занимает 5-15 секунд. В пакетном режиме — 3 параллельно.
  4. Когда готово — рядом с оригиналом появляется AI-превью

Сравните визуально. Не нравится — нажмите «🪄» ещё раз с другим промптом (учтите: каждая попытка списывает 1 единицу с баланса).

Если устраивает — нажмите «✓ Применить»:

Bulk-режим (Стандарт и выше): выделите хоть тысячу картинок → нажмите «Применить ко всем». Тысяча картинок обрабатывается ~1 час.

Шаг 7. Бэкапы и откат

Оригиналы лежат в /upload/imgchanger_backups/. Структура:

/upload/imgchanger_backups/
  ├── 2026-05-12_14-32-15/      ← timestamp заходов в применение
  │   ├── /upload/iblock/abc/photo1.jpg
  │   └── /upload/iblock/def/photo2.png
  └── 2026-05-13_10-05-00/
      └── ...

В админке: ImgChanger → История замен — список всех применений с возможностью «Откатить» одной кнопкой (вернёт оригинал из бэкапа).

Бэкапы хранятся неограниченно — это просто файлы в файловой системе. Удалять можно вручную через FTP, когда уверены что замены ОК.

Если что-то пошло не так

Модуль не появился в Marketplace → Установленные решения

Проверьте права на папку: chmod -R 755 /local/modules/kuratov_ru.imgchanger/ (через SSH или панель хостинга). Владелец файлов должен совпадать с пользователем веб-сервера.

«Лицензионный ключ недействителен»

Проверьте, что:

Генерация падает с ошибкой timeout / 502

Это обычно max_execution_time в PHP. Увеличьте в .htaccess сайта:

php_value max_execution_time 120
php_value memory_limit 256M
AI-картинка получается хуже оригинала

Попробуйте другой промпт. Хороший базовый промпт: professional photograph, same subject and composition as reference, high quality, sharp focus. Можно добавить конкретику — «human portrait», «landscape», «product on white background».

Также можно сменить провайдера в настройках модуля: по умолчанию fal_img2img, но есть fal_t2i (text-to-image) и fal_redux (без промпта).

Не вижу пункт меню ImgChanger в админке

Очистите кэш Битрикса: Настройки → Настройки продукта → Автокеширование → «Очистить файлы кэша». Перелогиньтесь.

Хочу откатить уже применённую замену

В меню админки: ImgChanger → История замен. Найдите нужную запись, нажмите «Откатить». Файл будет восстановлен из /upload/imgchanger_backups/<timestamp>/.

Если папки бэкапа уже нет (удалена вручную) — восстановить не получится. Не удаляйте imgchanger_backups/ пока не убедились что замены ОК.

Если ничего не помогает — напишите на hello@imgchanger.org с темой «Битрикс установка». Приложите версию Битрикса, PHP, текст ошибки. Отвечаем в течение 24 рабочих часов.

Для тарифов «Стандарт» и выше: помощь с установкой включена — подключимся по SFTP или TeamViewer, поставим за вас, проверим что работает.

Следующие шаги