Flat Lay API

API Flat Lay від Photoroom автоматично перетворює фото предмета одягу на охайне фото одягу, розкладеного на рівній поверхні та знятого згори, готове для електронної комерції та маркетплейсів. Це одне з понад 20 редагувань у API Photoroom.

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

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

Для каталогів одягу API Flat Lay від Photoroom створено для обробки великих обсягів. Одна інтеграція розкладає кожен предмет одягу на фото плазом і надає доступ до понад 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, що задає стиль генерації, наприклад, чиста студійна зйомка в стилі flat lay.

Надсилай файли 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 редагування зображень у sandbox-режимі: щомісяця доступно 1 000 безкоштовних запитів із водяним знаком. Деталі — на сторінці з цінами.

Так. У Photoroom є MCP-сервер для ШІ-асистентів, як-от Claude, з підтримкою Flat Lay. Докладніше див. Photoroom MCP.

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

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