Flat Lay API

API Flat Lay от Photoroom автоматически превращает фотографию предмета одежды в аккуратное фото в стиле flat lay, снятое сверху, — готовое для интернет-магазинов и маркетплейсов. Это одна из более чем 20 операций редактирования в API Photoroom.

Да. С помощью API Photoroom ты отправляешь фотографию одежды, задав flatLay.mode значение ai.auto, и получаешь изображение в формате flat lay — по одному изображению за запрос. Запросы можно выполнять параллельно, не превышая лимит по умолчанию — 60 изображений в минуту. Так ты сможешь подключить API к каталогу или процессу загрузки и автоматически создавать flat lay для каждой новой вещи.

С API Photoroom ты отправляешь фото предмета одежды и получаешь аккуратное фото, где одежда разложена на плоскости и снята сверху, — готовое для интернет-магазинов и маркетплейсов. Не нужно вручную стилизовать, раскладывать и фотографировать одежду. Запросы выполняются параллельно: по умолчанию обрабатывается 60 изображений в минуту, поэтому весь каталог можно обработать за один запрос.

Для каталогов одежды API Flat Lay от Photoroom создан для обработки больших объемов. Одна интеграция позволяет преобразовать каждое фото одежды в снимок в стиле flat lay и использовать более 20 других вариантов обработки, например удаление фона, эффект невидимого манекена и глажку с ИИ. Тарифы Enterprise дают более высокие лимиты запросов и проверку результатов для больших каталогов: свяжись с отделом продаж.

Flat Lay раскладывает одежду на плоской поверхности и показывает её сверху. Ghost Mannequin демонстрирует одежду без манекена, передавая её посадку и драпировку, а Виртуальная модель превращает фотографии одежды в лайфстайл-снимки с готовыми или созданными на заказ ИИ-моделями. Все три решения работают на одном и том же API Photoroom, поэтому для всех трёх достаточно одной интеграции.

Получи API-ключ, затем отправь фото одежды, указав для flatLay.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 flatLay.mode=ai.auto \
  --output result.png

Все параметры указаны в документации Flat Lay.

Отправляй каждую фотографию предмета одежды через один и тот же вызов API Photoroom с одинаковыми настройками. Вот настройки, которые можно изменить:

• flatLay.mode: установи значение ai.auto, чтобы использовать Flat Lay.

• flatLay.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.

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

Отправляй файлы PNG, JPEG, WEBP или AVIF размером до 30 МБ и длиной до 5 000 пикселей по самой длинной стороне — и получай изображения в тех же форматах. Flat Lay по умолчанию выдаёт изображения с разрешением 1K (1024 x 1024), а вывод в 2K и 4K доступен на тарифе Enterprise. Подробнее — в документации по размеру файла, разрешению и формату.

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

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

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

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