Okunev Agency Try-On: виртуальная примерка одежды

Что умеет решение

Модуль Okunev Agency Try-On добавляет функцию виртуальной примерки одежды по фотографии в интернет-магазины на платформе 1С-Битрикс. Покупатель загружает собственное изображение, подтверждает согласие на его отправку в AI-сервис и получает результат, демонстрирующий, как выбранный товар будет выглядеть на нём. Функционал доступен непосредственно в карточке товара после подключения компонента.

Система работает с товарами и торговыми предложениями из стандартных инфоблоков 1С-Битрикс. Изображение товара может быть загружено из детального просмотра, изображения анонса или из свойства типа «Файл». Пользователь видит предварительный просмотр своего фото, статус обработки и готовый результат. История хранит до шести последних примерок текущего товара в пределах срока хранения.

Пользователи могут просматривать и удалять свои загруженные фотографии и полученные изображения. Администратор настраивает лимиты запусков функции для отдельного посетителя и для всего магазина за скользящие 24 часа. Реализована защита от повторного запуска одной и той же задачи при повторной отправке запроса. Просроченные фотографии автоматически удаляются при регулярном выполнении агентов 1С-Битрикс.

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

По умолчанию функция виртуальной примерки доступна только авторизованным пользователям. Администратор может разрешить использование сервиса без регистрации в общих настройках модуля.

В гостевом режиме история действий и доступ к сгенерированным изображениям привязаны к текущему сеансу посетителя. Каждый новый гостевой сеанс получает отдельный персональный лимит, который действует совместно с общим лимитом магазина.

Адаптация под дизайн магазина

Разработчик может изменять HTML-разметку, стили и расположение элементов, сохраняя при этом документированные атрибуты. Логика отправки запросов и обработки результатов вынесена в общее JavaScript-расширение, а верстка карточек результатов размещается в шаблоне компонента.

Шрифт автоматически наследуется от основного сайта; стили стандартных шаблонов ограничены областью видимости виджета. Инструкция по созданию собственного оформления включена в поставку модуля в файле CUSTOMIZATION.md.

AI-сервис и дополнительные расходы

Для генерации изображений используется внешний сервис FASHN AI. Владельцу сайта требуется собственный API-ключ и положительный баланс API-кредитов FASHN.

Использование сервиса FASHN не включено в стоимость лицензии модуля и оплачивается владельцем сайта напрямую поставщику сервиса.

Модуль Okunev Agency Try-On обеспечивает виртуальную примерку одежды, используя сервис FASHN с моделью Try-On Max в сбалансированном режиме. Генерация выполняется в разрешении 1k с выдачей одного результата.

Стоимость услуги зависит от тарифного плана. Одна успешная генерация потребляет 2 API-кредита. В тарифе On-Demand цена составляет 0,15 доллара США за результат, минимальная покупка начинается с 100 кредитов за 7,50 доллара США. Тарифы сервиса могут изменяться; актуальные условия следует уточнять в документации FASHN API.

API-ключ используется исключительно на сервере и не передаётся в браузер покупателя. Фотография клиента и изображение товара передаются на сервер FASHN через сервер сайта. Перед отправкой данных покупатель должен подтвердить согласие на обработку фотографии.

Исходные фотографии и результаты примерки хранятся на стороне магазина в отдельном приватном каталоге вне публичной директории сайта. Доступ к файлам контролируется по владельцу и сроку хранения. Администратор устанавливает срок от 1 до 72 часов. Посетитель может удалить исходное фото и результат примерки досрочно. Удаление файлов из магазина не отменяет уже переданную в FASHN задачу и не возвращает потраченные API-кредиты или локальный лимит запусков. Порядок обработки данных внешним сервисом регулируется отдельными условиями FASHN.

Модуль не вносит автоматических изменений в карточки товаров. Разработчик подключает компонент в шаблоне карточки, передавая идентификатор товара. Для торгового предложения передаётся идентификатор предложения; автоматическое переключение режима примерки при смене цвета или размера требует интеграции с шаблоном сайта.

Поддерживаются локальные изображения товаров, доступные через метод CFile. Облачное файловое хранилище в текущей версии не поддерживается.

AI-визуализация позволяет предварительно оценить внешний вид образа, но не определяет размер и не гарантирует точную посадку одежды.

Технические требования

1С-Битрикс: Управление сайтом, главный модуль main версии 23.0.0 или новее, модуль «Информационные блоки».

PHP 8.2 или новее; библиотека GD с поддержкой форматов JPEG, PNG и WEBP.

Рекомендуется наличие EXIF для корректной ориентации фотографий, сделанных на телефоне; рекомендуемое значение memory_limit — от 256 МБ.

MySQL или MariaDB. Поддержка PostgreSQL и кластерных конфигураций в текущей версии не заявлена.

Требуется исходящее HTTPS-соединение с api.fashn.ai.

Необходим отдельный приватный каталог вне корневой директории DOCUMENT_ROOT, доступный для чтения и записи со стороны PHP, но не публикуемый веб-сервером.

Модуль Okunev Agency Try-On обеспечивает регулярное выполнение агентов системы 1С-Битрикс для задач виртуальной примерки одежды. Для организации фоновой обработки и очистки данных без необходимости посещения сайта рекомендуется настроить запуск агентов через cron. Для корректной работы модуля на сайте должен быть установлен протокол HTTPS, а пользователи должны использовать современные браузеры.

Если «Okunev Agency Try-On: виртуальная примерка одежды» подходит под задачу, General iT поможет установить модуль, настроить его и проверить результат на проекте.