Удаление фона часто становится обязательным этапом подготовки изображений для интернет-магазинов, маркетплейсов, каталогов и цифровых сервисов. Когда фотографий много, ручная обработка каждого файла замедляет публикацию товаров и увеличивает нагрузку на команду.
Retouch4me Background Removal API позволяет автоматизировать этот процесс и встроить удаление фона в собственные приложения, сайты и рабочие процессы обработки изображений.
Удаление фона для разных типов изображений
Retouch4me API предназначен для автоматического выделения объектов на фотографиях. Модель работает с разными категориями изображений: товарами, одеждой, аксессуарами, мебелью, едой, предметами интерьера и другими объектами.
API можно использовать для обработки студийных фотографий и изображений, снятых в реальных условиях. Результат зависит от исходного изображения: на качество выделения влияют чёткость границ объекта, фокусировка, контраст с фоном и наличие перекрытий.
Два формата результата
В зависимости от задачи API возвращает один из двух вариантов результата.
PNG с прозрачным фоном
Готовое изображение объекта в формате RGBA PNG. Исходный фон становится прозрачным, а сам объект сохраняется.
Такой вариант подходит, если изображение нужно сразу использовать в интернет-магазине, каталоге или рекламных материалах. Вырезанный объект можно разместить на белом, однотонном, фирменном или любом другом фоне без повторного удаления фона.
PNG-маска без RGB
Одноканальное PNG-изображение, содержащее только данные маски объекта, без цветовых каналов исходной фотографии.
Маска определяет, какие области относятся к объекту, а какие к фону: чёрный цвет обозначает фон, белый — объект, промежуточные оттенки серого передают мягкие переходы по краям.
Этот формат подходит для композитинга, собственной обработки изображений, контроля результата и интеграции в автоматизированные рабочие процессы.
Для маски можно выбрать характер переходов по краям:
- Мягкая маска сохраняет промежуточные значения серого. Это помогает передать тонкие детали, например волосы и сглаженные контуры.
- Жёсткая маска использует чёрные и белые значения с порогом разделения 0,5.
Для каких задач подходит API
Подготовка изображений для интернет-магазинов
Автоматическое удаление фона помогает подготовить фотографии товаров для карточек, каталогов и товарных страниц. Объекты можно размещать на едином белом или фирменном фоне.
Обработка изображений для маркетплейсов
API можно встроить в процесс подготовки фотографий продавцов и товарных позиций. Это упрощает стандартизацию изображений перед публикацией и обновлением ассортимента.
Интеграция с DAM, PIM и CMS
Удаление фона можно добавить в существующие процессы загрузки, обработки, хранения и публикации медиаконтента. Например, запускать его при поступлении новых изображений в каталог.
Собственные приложения и онлайн-редакторы
Разработчики могут встроить функцию удаления фона в графический редактор, форму загрузки изображений, дизайн-приложение или внутренний сервис компании.
Композитинг и дальнейшая обработка
Если приложению нужны данные о границах объекта, API может вернуть отдельную маску. Её можно использовать для замены фона, наложения изображений и других операций с фотографией.
Обработка большого количества изображений
Retouch4me Background Removal API поддерживает асинхронную обработку. Это позволяет интегрировать удаление фона в системы, где изображения поступают постоянно или обрабатываются большими партиями.
Для каждого изображения создаётся отдельная задача. При массовой обработке приложение отправляет запросы, сохраняет идентификаторы задач и проверяет их статус. После завершения обработки результат можно скачать.
Такой подход подходит для импорта товарных каталогов, обновления изображений по SKU, обработки потоков фотографий и синхронизации медиабиблиотек.
Как интегрировать Background Removal API
Работа с API состоит из трёх основных этапов:
- Отправка изображения. Передайте исходный файл в формате JPG или PNG на endpoint
/retoucher/startвместе с токеном доступа и параметрами запроса. - Проверка статуса. Используйте
/retoucher/status/{id}, чтобы узнать, завершилась ли обработка. - Получение результата. После завершения задачи скачайте обработанное изображение через
/retoucher/getFile/{id}.
Формат результата задаётся параметрами запроса. Для получения готового изображения с прозрачностью используется RGBA PNG, для одноканальной маски — PNG с параметром MaskOnly: 1.
Важно учитывать, что Remove Background должен запускаться как отдельная задача. Его нельзя объединять с другими инструментами Retouch4me в одном запросе. Если после удаления фона требуется дополнительная обработка, например кадрирование или цветокоррекция, отправьте отдельный запрос к API.
Автоматизируйте удаление фона в своих проектах
Retouch4me Background Removal API помогает встроить выделение объектов и удаление фона в существующие цифровые продукты и процессы обработки изображений.
Используйте готовый PNG с прозрачностью для публикации изображений или получайте маску для собственного рабочего процесса. Выбор формата зависит от того, как результат будет использоваться в вашей системе.
Документация содержит описание параметров запросов и примеры интеграции.
По вопросам интеграции API, техническим проблемам или запросам на разработку специальных функций обращайтесь по адресу relu@retouch4.me.