> For the complete documentation index, see [llms.txt](https://docs.photoroom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.photoroom.com/image-editing-api-plus-plan/virtual-try-on.md). # Virtual Try-On ## Overview Virtual Try-On lets you automatically place a piece of clothing on an a person:


(original image)	(edited image)
+
+
+

{% hint style="info" %} Virtual Try-On is meant to be used with images that feature clothing items. {% endhint %} ## Main Parameters Virtual Try-On shares the same parameters than [Virtual Model](/image-editing-api-plus-plan/virtual-model.md), but used in a different way. To use Virtual Try-On, you'll need to use the following parameters: ### `virtualModel.mode` To enable Virtual Try-On, set the parameter `virtualModel.mode` to `ai.auto`. ### `virtualModel.model` The parameter `virtualModel.model` lets you control the likeness of the person wearing the clothing. The image of that person is provided using either the parameter `virtualModel.model.custom.imageFile` or `virtualModel.model.custom.imageUrl`. {% hint style="info" %} The parameter `virtualModel.model.custom.imageFile` is only available when using the [POST endpoint](/image-editing-api-plus-plan/quickstart-guide.md#post-endpoint). {% endhint %} ### `virtualModel.scene` The parameter `virtualModel.scene` lets you control the environment in which the person will be placed. You can either use a pre-set scene or a custom one. {% hint style="warning" %} To keep the scene generated around the virtual model, please also set the parameters `removeBackground=false` and `referenceBox=originalImage`. {% endhint %} To use a **pre-set scene**, set the parameter `virtualModel.scene.preset.name` to the name of the pre-set scene that you want to use.

List of pre-set scenes

	Cover image
`random`	/files/0IahvwH1qAhBC7VK1DmK
`street`	/files/hqCfOdvjAbxiRGpQYQWR
`bedroom`	/files/JuqlkH1Q44j6ejNektqZ
`sunset`	/files/YQyJXdUeWE5uMsPBVd3w
`factory`	/files/O5Xhtq4bq6JIN2XmhNRb
`studio`	/files/46pbuQT1qatH5mFzK0KN
`coloredstudio`	/files/xB188ouKVuWUedpoS6ix
`concretestudio`	/files/K9WgvXohswvMQxmCvI07
`beach`	/files/sO0N99T9AZiCj3LlaHCi
`tropical`	/files/SYh2uL2aUBjcIXBjtey0
`library`	/files/GiraV1vfH23kImqTPNyb
`forest`	/files/Cabudtg7qofeRxSJvqxb
`businessdistrict`	/files/1whyFWttZIX1PgjBgPuM
`countryside`	/files/k0JYUfdQhHWFIZ9BxKMq
`flowers`	/files/qnRyUk2mdQhhY3C7Zpaj
`goldenlight`	/files/dYJbjI0QUpUbVt4AAhPg
`mountain`	/files/mNj17LqxxHiH43QJah5p
`pool`	/files/5P0ZoyzgUQldwBHUosCL
`latincity`	/files/ASerA2aObCrrfohVZzzK
`cafe`	/files/pOIsqqeC1TY1hAylFnkB
`asiancity`	/files/4TGJJG4wGjWgSdrE3M4X
`nightlights`	/files/EsIhqi1zDJIacnhmhpW8
`desert`	/files/9y3YDcyNziwCXcAm35TG

To use a **custom scene**, you will need to provide an image of that scene using either the parameter `virtualModel.scene.custom.imageFile` or `virtualModel.scene.custom.imageUrl`. {% hint style="info" %} The parameter `virtualModel.scene.custom.imageFile` is only available when using the [POST endpoint](/image-editing-api-plus-plan/quickstart-guide.md#post-endpoint). {% endhint %} By default, this parameter will be set to `virtualModel.scene.preset.name=random`. ### `virtualModel.pose` The parameter `virtualModel.pose` lets you control the pose of the person. You can pick between a list of pre-set poses:

List of pre-set poses

	Cover image
`random`	/files/Faf3PSv0EshWPi7lZidj
`standing`	/files/cnatpfhy24KObYRZ2PeB
`34turn`	/files/dyekqFCnTIiokOHjGz1h
`powerstance`	/files/NL5voD4ITlb6OMMCWwBN
`walkingforward`	/files/dlkWBG6HAwLwzpUQXs6p
`handinpocket`	/files/ur6H0OFDmyyQ00lRlHJy
`crossedarms`	/files/9XySYGJsLsS1Ogxv9yEG
`back`	/files/VM4Rvi8urMlwKsKYWuuf
`overtheshoulder`	/files/s1TKlWffMaDgpiNR9MTC
`seated`	/files/rteXK1iHRMgqj77j4EvW
`adjustingclothing`	/files/bCpiBRHlpXeNTQWOvzqt
`playfulspin`	/files/o2L52MkKqh55bta3bX83

{% hint style="info" %} For a Virtual Try-On, we recommend setting `virtualModel.pose=standing` {% endhint %} By default, this parameter will be set to `virtualModel.pose=random`. ## Which resolutions are supported? By default, Virtual Try-On will produce outputs at a resolution of 1K (`1024x1024`). Output resolutions of 2K and 4K are available for Enterprise plans:

{% 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). Book a demo ## Additional Parameters ### `virtualModel.additionalProductImages[]` Additional product images showing different angles or details of the same item. These help the model better understand the product and generate more accurate results. To provide these images, use either the parameter `virtualModel.additionalProductImages[].imageFile` or `virtualModel.additionalProductImages[].imageUrl`. {% hint style="info" %} The parameter `virtualModel.additionalProductImages[].imageFile` is only available when using the [POST endpoint](/image-editing-api-plus-plan/quickstart-guide.md#post-endpoint). {% endhint %} ### `virtualModel.prompt` Optional text prompt to guide the generation style. Example: `street style` ### `virtualModel.size` The output size and aspect ratio of the generated image. Default: `PORTRAIT_HD_3_2` 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` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.photoroom.com/image-editing-api-plus-plan/virtual-try-on.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.