# 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`:

<table data-header-hidden><thead><tr><th align="center" valign="top"></th><th align="center" valign="middle"></th></tr></thead><tbody><tr><td align="center" valign="top"><em>(original image)</em></td><td align="center" valign="middle"><em>(edited image)</em></td></tr><tr><td align="center" valign="top"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FLWzTLDSxQDmr9c8t3m7d%2F815Muj5qoUL._AC_SX679_.jpg?alt=media&#x26;token=6813142b-5549-4c15-8140-988a50a9b5ff" alt=""></td><td align="center" valign="middle"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FBPToWatAHmpT8VLbuM3I%2F815Muj5qoUL._AC_SX679_.png?alt=media&#x26;token=9f5ae862-6d4d-4b31-ab48-01eb89cf94e1" alt=""></td></tr><tr><td align="center" valign="top"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FGHg8ZMcTxPCWCrmlrOVo%2F819o0UjXJlL._AC_SY879_.jpg?alt=media&#x26;token=4d1d86f9-7c60-431c-a72e-c37041da6cdc" alt=""></td><td align="center" valign="middle"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FCDcyjHm5wBc8cMfI5Idk%2F819o0UjXJlL._AC_SY879_.png?alt=media&#x26;token=14da31f2-5c6b-486d-a775-54c9145543cf" alt=""></td></tr><tr><td align="center" valign="top"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FZgFki5V3g0wj2CReMWzd%2Faaa.png?alt=media&#x26;token=5c14ba24-a7ca-4eb8-878d-3731f41f2f83" alt=""></td><td align="center" valign="middle"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FlkPVJ9Qo1a5rmfuLsVTJ%2Faaa.png?alt=media&#x26;token=3601a369-3d8f-4e7e-b451-5525f16dd5f4" alt="" data-size="original"></td></tr><tr><td align="center" valign="top"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FO3NP0u8ic518Pk7Rjenn%2FIMG_9487%20Large.jpg?alt=media&#x26;token=55d620dd-3056-4e5f-970b-1dd26a1ccbee" alt=""></td><td align="center" valign="middle"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FkChHLtcPvAByU43oEl7w%2FIMG_9487%20Large.png?alt=media&#x26;token=b55cd993-bced-4632-b9d4-ea05f5be78b4" alt="" data-size="original"></td></tr><tr><td align="center" valign="top"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2F80dkMeJmhlYFWwQAtDmx%2FIMG_9520%20Large.jpg?alt=media&#x26;token=77099645-a77c-4791-a74a-6f477e73885b" alt=""></td><td align="center" valign="middle"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FHAJmN2831IZSn6lH6NjE%2FIMG_9520%20Large.png?alt=media&#x26;token=27e89f9d-2986-4599-8ac2-373aa7633231" alt="" data-size="original"></td></tr><tr><td align="center" valign="top"><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2Fs39bX6JvF3nBBY0Yj83v%2Fimage.jpeg?alt=media&#x26;token=9a2dec2b-6aad-4408-94d6-9690130c298b" alt="" data-size="original"></td><td align="center" valign="middle"><p></p><p><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2F25msxHr7krDw6Dul16ZK%2Fflat%20lay.png?alt=media&#x26;token=e6492bc6-017a-4796-841b-6027eea18b9e" alt=""></p></td></tr></tbody></table>

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

```bash
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
```

<a href="https://try-api.photoroom.com/?flatLay.mode=ai.auto" class="button primary">Try it now!</a>

{% hint style="info" %}
Flat Lay is meant to be used with images that feature clothing items.
{% endhint %}

## 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:

<div><figure><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2Fs39bX6JvF3nBBY0Yj83v%2Fimage.jpeg?alt=media&#x26;token=9a2dec2b-6aad-4408-94d6-9690130c298b" alt=""><figcaption><p><em>(original image)</em></p></figcaption></figure> <figure><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FjUkbprEPRZmNfA5EMKUZ%2Fresponse.jpeg?alt=media&#x26;token=c3f8957c-af81-4d20-bf08-96c34cf67bf3" alt=""><figcaption><p><em>(default 1K output)</em></p></figcaption></figure> <figure><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2F7tVQ0AIAbv8kCgmkrbdm%2Fresponse-4k.jpeg?alt=media&#x26;token=cc2242f5-d81e-4c15-bad0-12be299846b4" alt=""><figcaption><p><em>(4K output)</em></p></figcaption></figure></div>

<div><figure><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FHkKDiNfouKlCtVBLMcZk%2Fimage%202.jpeg?alt=media&#x26;token=3e29bc82-ed9d-4090-8e6d-c8b969224b86" alt=""><figcaption><p><em>(original image)</em></p></figcaption></figure> <figure><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FVZkTfhw0d8zyltFTUduT%2Fresponse.jpeg?alt=media&#x26;token=7fa57e2c-54bd-4557-b9cd-c79e47863851" alt=""><figcaption><p><em>(default 1K output)</em></p></figcaption></figure> <figure><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FAHOJuweP6YBwCuKdeBok%2Fresponse-4k.jpeg?alt=media&#x26;token=91b27c8a-daff-49c0-9479-9f5935daafc3" alt=""><figcaption><p><em>(4K output)</em></p></figcaption></figure></div>

<div><figure><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2F3jykr2urWFLKZC3oEZc6%2Fimage-4.jpeg?alt=media&#x26;token=64838b2b-6b12-4f80-b77f-5df85a6bd668" alt=""><figcaption><p><em>(original image)</em></p></figcaption></figure> <figure><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FliB2QdVJnkovAWuvLjTv%2Fresponse.jpeg?alt=media&#x26;token=b8b0a382-03d9-42a5-8f5c-c2f0ff16ab40" alt=""><figcaption><p><em>(default 1K output)</em></p></figcaption></figure> <figure><img src="https://2855892273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1SYxn7dWbQYsNtUdJE3f%2Fuploads%2FJ84yOw26fU3h5bbgay6k%2Fresponse-4k.jpeg?alt=media&#x26;token=a64b01d1-0978-4d40-83fe-c383d8ef9aa7" alt=""><figcaption><p><em>(4K output)</em></p></figcaption></figure></div>

{% hint style="info" %}
Make sure to click on the images to see them in full resolution.
{% endhint %}

If you're interested to use 2K or 4K resolution, please [contact our team to book a demo](https://www.photoroom.com/contact-sales?utm_source=apidocumentation\&utm_medium=enterprisegated).

<a href="https://www.photoroom.com/contact-sales?utm_source=apidocumentation&#x26;utm_medium=enterprisegated" class="button primary">Book a demo</a>

## 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`
