Опишите доработку или сценарий — обсудим вместе с другими клиентами.
Виртуальная примерка
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
Описание
«Виртуальная примерка» помогает покупателю представить одежду или обувь на себе перед покупкой. В карточке товара он открывает примерочную, выбирает снимок товара, добавляет свою фотографию и получает готовый образ.
Как это работает
- Покупатель нажимает кнопку примерки: плавающую или расположенную рядом с кнопкой «В корзину».
- Выбирает фотографию товара и при необходимости уточняет, что примеряет: верх, низ, платье, комплект или обувь.
- Загружает своё фото и подтверждает передачу изображений сервису обработки.
- Видит товар и готовую примерку рядом. Результат можно скачать.
Возможности
- Примерка одежды, обуви или обоих типов товаров.
- Два варианта автоматического размещения кнопки: плавающая или рядом с покупкой. Для нестандартной темы доступен CSS-селектор; для точного ручного размещения — компонент и PHP-хелпер.
- Выбор из основных и дополнительных фотографий товара.
- Фото покупателя в JPG/JPEG, PNG и WebP до 12 МБ.
- Модели Nano Banana 2, Nano Banana Pro и Nano Banana; шесть редактируемых промптов.
- Суточные лимиты на сайт, посетителя и IP, ограничение одновременных запросов.
- Защита от повторной оплаты при повторной отправке одного запроса.
- Закрытое хранение результатов на 24 часа, журнал согласий с выгрузкой CSV, диагностика ошибок.
- Штатные настройки и права доступа CMS, отдельные настройки сайтов.
Стоимость и внешний сервис
Лицензия модуля — 2 500 ₽, пробный период — 3 дня. Для генерации необходимы собственный API-ключ и оплаченный баланс RouterAI. Это реферальная ссылка. Работа внешнего сервиса оплачивается отдельно владельцем магазина, в том числе во время пробного периода. Без ключа и баланса генерация недоступна.
Варианты внешней оплаты — использование выбранной модели с оплатой каждого запроса по факту расхода. Справочно на 29.10.2026: тариф генерации изображений за 1 млн токенов — 6 307 ₽ у Nano Banana 2 и Nano Banana Pro, 3 153 ₽ у Nano Banana; входные данные тарифицируются отдельно. Это не цена одной примерки. Итог зависит от модели, фотографий и тарификации сервиса, возвращается в ответе API; цены провайдера могут меняться. Актуальные тарифы уточняются в кабинете RouterAI. Модуль не устанавливает лимит расходов в рублях и не содержит отдельной покупки дополнительных функций.
Требования и ограничения
- CMS «1С-Битрикс: Управление сайтом», модуль main от 24.0.0, модуль iblock, PHP от 8.2, UTF-8. Нужны GD с JPEG/PNG/WebP, cURL, mbstring и HTTPS-доступ к API.
- Хостинг должен поддерживать длительный PHP-запрос до 150 секунд и запись в защищённый каталог вне корня сайта. EXIF необязателен.
- Фото — не менее 100×100 пикселей, до 16 мегапикселей. Перед передачей изображения уменьшаются до 1536 пикселей по длинной стороне и перекодируются без EXIF.
- Поддерживаются локальные файлы товаров. Облачные и внешние хранилища фотографий требуют отдельной адаптации. Наследование фото торгового предложения от родительского товара не реализовано.
- Автоматический вывод зависит от адресов товаров и разметки шаблона. Для нестандартной темы может потребоваться указать CSS-селектор или вручную разместить компонент.
- Лимиты и блокировки рассчитаны на один сервер либо общую файловую систему. Композит, PostgreSQL и независимые многосерверные конфигурации не заявляются.
Фотографии и приватность
Фото покупателя и товара передаются RouterAI и поставщику выбранной модели для создания примерки после подтверждения в форме. Исходное фото покупателя не сохраняется модулем постоянно. Готовый результат доступен только создавшей его сессии в течение 24 часов; физическое удаление выполняется при очистке и работе агента. Журнал согласий хранится отдельно; срок его хранения определяет владелец сайта. Локальное удаление не удаляет копии у внешних провайдеров. Модуль не передаёт фотографии разработчику и не содержит телеметрии.
Примерка создаёт визуализацию образа, не определяет физический размер и не гарантирует точную посадку. Качество результата зависит от фотографий и модели. Скриншоты демонстрируют работу на искусственно созданном фото; фактический результат может отличаться.
Установка
- Создайте резервную копию рабочего сайта и настроек.
- Установите модуль «Виртуальная примерка» через Marketplace → Установленные решения. ID: proffiweb.pwtryon.
- Откройте Настройки → Настройки продукта → Настройки модулей → Виртуальная примерка и выберите сайт.
- На вкладке «Настройки» введите API-ключ из RouterAI. Запросы оплачиваются отдельно с баланса владельца магазина. Пустое поле сохраняет прежний ключ; для удаления есть отдельный флажок.
- Укажите ID инфоблоков товаров через запятую и код файлового свойства дополнительных фотографий — по умолчанию MORE_PHOTO. Используются также детальная и анонсная фотографии.
- Выберите модель и режим: одежда, обувь или оба типа. Задайте лимиты, затем включите примерку.
Размещение кнопки
На вкладке «Витрина» включите автоматический вывод и выберите «Плавающая кнопка» либо «Рядом с кнопкой «В корзину»». Во втором случае кнопка примерки появляется непосредственно после кнопки покупки. Для стандартного шаблона каталога селектор предустановлен. Для собственной темы укажите CSS-селектор её основной кнопки покупки. Если подходящий элемент не найден, автоматическая кнопка скрыта. Укажите текст, дополнительные CSS-классы, подпись и два цвета оформления.
Автовывод сопоставляет текущий путь с DETAIL_PAGE_URL активного доступного товара выбранных инфоблоков. Нестандартные адреса, ID только в параметрах URL и собственные шаблоны могут требовать ручного размещения.
Ручное размещение
Отключите автоматический вывод и добавьте в PHP-шаблон карточки компонент:
<?php $APPLICATION->IncludeComponent('proffiweb:virtual.tryon', '', [ 'PRODUCT_ID' => (int)$arResult['ID'], ]); ?>PRODUCT_ID — ID элемента выбранного инфоблока. Компонент не требует настройки кеша и сам выводит кнопку с ресурсами. Альтернатива после подключения модуля: \Proffiweb\Pwtryon\Frontend::renderButton((int)$arResult['ID']). У торгового предложения используются его собственные фото, если выбран инфоблок предложений.
Хранилище и сервер
При необходимости администратор указывает общий абсолютный путь к закрытому хранилищу вне корня сайта. По умолчанию используется соседний каталог proffiweb-pwtryon-private, внутри — каталог по ID сайта. На установке с разными корнями сайтов задайте единый путь. PHP должен иметь права записи. При смене пути прежние файлы автоматически не переносятся.
Для фото 12 МБ настройте upload_max_filesize и post_max_size с запасом. Разрешите исходящий HTTPS к RouterAI и время выполнения до 150 секунд. Настройки сервера модуль не меняет.
Лимиты, промпты и журналы
Начальные лимиты: 100 попыток на сайт в сутки, 5 на сессию и IP, 2 одновременно. Сутки считаются по UTC, неудачные попытки после резервирования тоже учитываются. На вкладке «Промпты» доступны шесть инструкций; каждая содержит 1–6000 символов. Первое изображение — покупатель, второе — товар. Сохранение и сброс промптов выполняются отдельными кнопками.
На вкладке «Логи и согласия» можно включить запись ошибок, прочитать последние 100 событий и скачать CSV согласий. Права D/R/W назначаются штатно; изменение и выгрузка требуют W. Сам API-ключ в HTML формы не возвращается.
Очистка и удаление
Результаты выдаются 24 часа только своей сессии. Часовой агент и новые запуски удаляют истёкшие файлы. Для регулярной очистки без посещений настройте штатный запуск агентов через cron. При удалении модуля можно явно удалить настройки; фотографии и согласия в закрытом каталоге сохраняются и при необходимости удаляются владельцем сайта отдельно. Окончание пробного периода настройки и файлы не удаляет. Для отката верните резервную копию модуля и его настроек.
Разработчик: Proffiweb, ИП Рзянкин Денис Игоревич.
Техническая поддержка: support@proffiweb.ru.
Рабочие дни: понедельник–пятница, 08:00–18:00 по московскому времени. Первый ответ — в течение одного рабочего дня; это не означает завершения исправления.
Поддержка включает установку, штатные настройки и воспроизводимые ошибки модуля в заявленной среде в течение действующего срока поддержки лицензии. Доработки шаблонов, обслуживание сервера и изменение разметки сторонних тем и услуги внешнего провайдера согласовываются отдельно.
Укажите версию модуля, CMS и PHP, редакцию, шаги воспроизведения и обезличенный снимок ошибки. Не отправляйте пароли, лицензионные ключи, гостевые ссылки и ключи API и реальные персональные данные покупателей в открытой переписке.
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
Подтвердите что сама лицензия у вас куплена
