API для эффекта невидимого манекена

API Photoroom для создания эффекта «невидимого манекена» превращает фото одежды в аккуратный снимок товара без манекена, на котором хорошо видны посадка и драпировка. Этот приём также называют эффектом «невидимого манекена». Это одна из более чем 20 операций редактирования в API Photoroom.

Отправляй каждое фото в API Photoroom с включенной функцией Ghost Mannequin — по одному изображению за вызов. В ответ ты получишь готовое изображение без манекена. Ghost Mannequin предназначена для изображений с одеждой. Пример вызова приведен ниже.

API Photoroom умеет и то и другое: создавать аккуратные фото одежды с эффектом «невидимого манекена» и превращать фотографии одежды в лайфстайл-снимки с готовыми или созданными на заказ моделями ИИ с помощью Виртуальной модели. Одна интеграция охватывает обе функции, а также Flat Lay, Глажку с ИИ и удаление фона.

Подключи каталог или процесс загрузки к API Photoroom и отправляй по одной фотографии одежды в каждом запросе, выполняя запросы параллельно, — по умолчанию до 60 изображений в минуту. Тарифы Enterprise позволяют увеличить лимит для каталогов с большим объёмом: свяжись с отделом продаж.

Эффект невидимого манекена входит в тариф Plus API за 100 $ в месяц (0,10 $ за изображение), а также в тарифы Enterprise: свяжись с отделом продаж. Стоимость вызова не зависит от сочетания правок, а вызовы, завершившиеся ошибкой, не учитываются как использованное изображение. Сначала протестируй его в режиме песочницы: каждый месяц доступно 1 000 бесплатных вызовов с водяным знаком. Подробнее — на странице с ценами.

Получи ключ API, затем отправь фото одежды, установив ghostMannequin.mode в ai.auto:

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form ghostMannequin.mode=ai.auto \
  --output result.png

Все параметры есть в документации по Ghost Mannequin.

ghostMannequin.mode: установи значение ai.auto, чтобы использовать режим «Призрачный манекен».

ghostMannequin.size: размер и соотношение сторон сгенерированного изображения. По умолчанию используется SQUARE_HD. Другие значения: PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3 и LANDSCAPE_HD_16_9.

ghostMannequin.prompt: необязательный текстовый Prompt, задающий стиль генерации, например невидимый манекен.

Загружай файлы форматов PNG, JPEG, WEBP или AVIF размером до 30 МБ и шириной до 5000 пикселей по длинной стороне, а в ответ получай файлы в тех же форматах. По умолчанию Ghost Mannequin возвращает изображения с разрешением 1K (1024 x 1024). Разрешения 2K и 4K доступны на тарифах Enterprise. Подробнее — на странице документации о размере файла, разрешении и формате.

Да. У Photoroom есть MCP-сервер для ИИ-ассистентов, таких как Claude: см. Photoroom MCP, чтобы узнать, какие инструменты он поддерживает.

Возникли проблемы с API? Присоединяйся к нашему сообществу API, чтобы получить помощь от наших инженеров, или загляни на страницу устранения неполадок, где собраны решения распространённых проблем.

Если вопрос касается оплаты или конфиденциальной информации, напиши Photoroom напрямую в личные сообщения сообщества. Мы всегда рады помочь.