# Virtual Model ## Overview Virtual Model lets you automatically convert one or more clothing photos into a polished, lifestyle photoshoot image, using either pre-defined or custom models:


(original image)	(edited image)
	`virtualModel.mode=ai.auto` `virtualModel.model.preset.name=avery` `virtualModel.scene.preset.name=street` `virtualModel.pose=standing`
+	`virtualModel.mode=ai.auto` `virtualModel.model.custom` `virtualModel.scene.preset.name=random` `virtualModel.pose=random`
	`virtualModel.mode=ai.auto` `virtualModel.model.preset.name=jackson` `virtualModel.scene.preset.name=library` `virtualModel.pose=crossedarms`
+	`virtualModel.mode=ai.auto` `virtualModel.model.custom` `virtualModel.scene.preset.name=random` `virtualModel.pose=random`
	`virtualModel.mode=ai.auto` `virtualModel.model.preset.name=ava` `virtualModel.scene.preset.name=bedroom` `virtualModel.pose=seated`
+	`virtualModel.mode=ai.auto` `virtualModel.model.custom` `virtualModel.scene.preset.name=random` `virtualModel.pose=random`

{% hint style="warning" %} To keep the background around the virtual model, set the parameters `removeBackground=false` and `referenceBox=originalImage`. If not set, that background will be removed. {% endhint %} 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 removeBackground=false \ --form referenceBox=originalImage \ --form virtualModel.mode=ai.auto \ --form virtualModel.model.preset.name=avery \ --form virtualModel.scene.preset.name=street \ --form virtualModel.pose=standing \ --output result.png ``` Try it now! {% hint style="info" %} Virtual Model is meant to be used with images that feature clothing items. {% endhint %} ## Main Parameters To use Virtual Model, you'll need to use the following parameters: ### `virtualModel.mode` To enable Virtual Model, set the parameter `virtualModel.mode` to `ai.auto`. ### `virtualModel.model` The parameter `virtualModel.model` lets you control the likeness of the model. You can either use a pre-set model or a custom one. To use a **pre-set model**, set the parameter `virtualModel.model.preset.name` to the name of the pre-set model that you want to use.

List of pre-set models

	Cover image
`avery`	/files/KxZsKptBhUBF5Pg9AXTn
`sam`	/files/iI4iI0U1tTMUi811REMt
`taylor`	/files/MNkrqAJBnyEwo2qNp1Xx
`kendall`	/files/GM7Ug0EnlJmdAtgxSOcg
`jordan`	/files/3F9cvO91iuyfkROxxSPL
`casey`	/files/rRcC4kPlqkZtKLmn1ypP
`maya`	/files/ulf4uwToGwN7kSaKv33m
`reece`	/files/38w4CI4I3Utb70rOFkNn
`lena`	/files/BMo9D9o1E5imtxKjyk27
`julia`	/files/MF4rt8Fw37BAw3I9WMwx
`jackson`	/files/Ma8FcEK65qBuG5SWuceh
`sophia`	/files/VUUvCsaCzSJGro6M1hW7
`emma`	/files/lnwownojQKp0Odahn5k9
`ava`	/files/zf5HdWjhfVR8fFN67lqy
`zoe`	/files/ZrlLv9Qjf6qA2Ult1ycB
`fiona`	/files/oLic6Z5lk0ULY3tPE1PR

To use a **custom model**, you will need to provide an image of that model 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 %} By default, this parameter will be set to `virtualModel.model.preset.name=avery`. ### `virtualModel.scene` The parameter `virtualModel.scene` lets you control the environment in which the model 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 model. 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

By default, this parameter will be set to `virtualModel.pose=random`. ## Which resolutions are supported? By default, Virtual Model 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: 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: ``` GET https://docs.photoroom.com/image-editing-api-plus-plan/virtual-model.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.