Models

Virtual try-on (v2)

Changed on

Submits a virtual try-on task against the v2 model. Identical request shape to /vto-v1, with reference and output resolution supported up to 4MP. Person and garment images are mapped to the underlying input image slots. An edit instruction is generated from the person and garment images, with the supplied prompt used as a fallback.

post/v1/flux-tools/vto-v2

Request

Request body

userstring nullable

Opaque identifier for the end user supplied by the calling platform.

promptstring required

Text prompt for VTO generation.

personstring required

Person image (maps internally to input_image).

garmentstring required

Image of one more garments (maps internally to input_image_2).

seedinteger nullable

Optional seed for reproducibility.

safety_toleranceinteger

Harm moderation tolerance from 0 to 7, with 0 the strictest. The route and organization determine the approved maximum and per-category ceilings. Unapproved levels return 422 with approved levels.

output_format'jpeg' | 'png' | 'webp'
webhook_urlstring uri nullable

URL to receive webhook notifications

webhook_secretstring nullable

Optional secret for webhook signature verification

Example request

{
  "prompt": "TRY-ON: The person of image 1 wearing the garments of image 2.",
  "seed": 42
}

Response

Successful Response

OR

Changes