For the complete documentation index, see llms.txt. This page is also available as Markdown.

Flat Lay

Overview

Flat Lay allows you to automatically generate clean, top-down visuals ready for e-commerce and marketplaces.

To use Flat Lay, set the parameter flatLay.mode to ai.auto:

(original image)

(edited image)

If you want to give it a try, here's the code to reproduce the first example above:

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

Try it now!

Flat Lay is meant to be used with images that feature clothing items.

Which resolutions are supported?

By default, Flat Lay will produce outputs at a resolution of 1K (1024x1024).

Output resolutions of 2K and 4K are available for Enterprise plans:

(original image)
(default 1K output)
(4K output)
(original image)
(default 1K output)
(4K output)
(original image)
(default 1K output)
(4K output)

Make sure to click on the images to see them in full resolution.

If you're interested to use 2K or 4K resolution, please contact our team to book a demo.

Book a demo

Additional Parameters

flatLay.prompt

Optional text prompt to guide the generation style.

Example: a clean studio flat lay

flatLay.size

The output size and aspect ratio of the generated image.

Default: SQUARE_HD

Possible values: PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, SQUARE_HD, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3, LANDSCAPE_HD_16_9

Last updated

Was this helpful?