---
title: FLUX Virtual Try-On | Runware Docs
url: https://runware.ai/docs/models/bfl-flux-virtual-try-on
description: Low-latency virtual try-on for transferring garments onto a person image with strong identity and garment fidelity
---
# FLUX Virtual Try-On

![FLUX Virtual Try-On](https://assets.runware.ai/covers/bfl-flux-virtual-try-on.jpg)

FLUX Virtual Try-On is a virtual try-on image editing model from Black Forest Labs that generates apparel try-on results from a person image plus one or more garment references. It is tuned to preserve the subject's face and pose while transferring garments with strong logo, print, stitching, and hardware fidelity, making it suitable for catalog-scale styling, product visualization, outfit transfer, and shopper-facing try-on workflows. It supports multi-garment composition, seeded generation, and output sizes up to 2 megapixels.

- **Status**: live
- **ID**: `bfl:flux@vto`
- Try in Playground
- **Creator**: Black Forest Labs
- **Release Date**: May 28, 2026
- **Zero Data Retention**: Yes
- **Capabilities**: Image to Image, Edit, Checkpoint

## Pricing

$0.005 from, per output megapixel · ~10s per request

**Rates**

- First megapixel in · per input megapixel: `$0.0375`
- Each further megapixel inper input megapixel · beyond 1: `$0.005`
- Output megapixel · per output megapixel: `$0.005`

**4 example generations**

- [virtual-try-on](https://runware.ai/docs/models/bfl-flux-virtual-try-on/examples#example-rooftop-apiary-uniform-composite): `$0.0475` (~11s)
- [virtual-try-on](https://runware.ai/docs/models/bfl-flux-virtual-try-on/examples#example-winery-guide-banner-expansion) · steps 4: `$0.0475` (~9s)
- [virtual-try-on](https://runware.ai/docs/models/bfl-flux-virtual-try-on/examples#example-lava-tube-surveyor-portrait-composite): `$0.0475` (~9s)
- [virtual-try-on](https://runware.ai/docs/models/bfl-flux-virtual-try-on/examples#example-opera-tailcoat-costume-fitting) · steps 4: `$0.0625` (~10s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Image output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-outputformat)

- **Type**: `string`
- **Default**: `JPG`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`JPG\`: Best for photorealistic images with smaller file sizes (no transparency).
- \`PNG\`: Lossless compression, supports high quality and transparency (alpha channel).
- \`WEBP\`: Modern format providing superior compression and transparency support.

> [!NOTE]
> \*\*Transparency\*\*: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., \`PNG\`, \`WEBP\`, \`TIFF\`). \`JPG\` does not support transparency.

**Allowed values**: `JPG` `PNG` `WEBP`

### [outputQuality](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (1 property)`

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`

Enable or disable content safety checking. Increases total generation time and adds a small charge on top of the generation cost.

### [ttl](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `20`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [referenceImages](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of objects (2 properties)`
- **Required**: true
- **Min items**: `items: 2`

List of reference images (UUID, URL, Data URI, or Base64).

#### [image](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-inputs-referenceimages-image)

- **Path**: `inputs.referenceImages.image`
- **Type**: `string`
- **Required**: true

Image input (UUID, URL, Data URI, or Base64). Images under 2MP pass through unchanged. Images over 2MP are downscaled to 1MP with the original aspect ratio preserved.

#### [role](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-inputs-referenceimages-role)

- **Path**: `inputs.referenceImages.role`
- **Type**: `string`
- **Required**: true

Role of the image in the virtual try-on process. Use exactly one `person` and one `garment`.

**Allowed values**: `person` `garment`

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `bfl:flux@vto`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `2`
- **Max**: `3000`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [seed](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-seed)

- **Type**: `integer`
- **Min**: `0`
- **Max**: `9223372036854776000`

Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

**Learn more** (1 resource):

- [Seed](https://runware.ai/docs/learn/seed) (learn)

### [steps](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-steps)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `4`
- **Default**: `4`

Total number of denoising steps. Higher values generally produce more detailed results but take longer.

**Learn more** (1 resource):

- [Steps](https://runware.ai/docs/learn/steps) (learn)

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-advancedfeatures-watermark)

- **Path**: `advancedFeatures.watermark`
- **Type**: `object (6 properties)`

Configuration object for adding watermarks to generated videos. Watermarks can be applied using either text or image content with customizable positioning and appearance. You must provide either `text` or `image` content for the watermark, but not both.

**Text watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "© 2025 Company",
    "displayPosition": "bottom-right",
    "opacity": 0.6,
    "fontColor": "#ffffff",
    "bgColor": "#000000"
  }
}
```

**Image watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "image": "c64351d5-4c59-42f7-95e1-eace013eddab",
    "displayPosition": "top-left",
    "opacity": 0.6
  }
}
```

**Tiled watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "PREVIEW",
    "tiled": true,
    "opacity": 0.4,
    "fontColor": "#cccccc"
  }
}
```

#### [text](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-advancedfeatures-watermark-text)

- **Path**: `advancedFeatures.watermark.text`
- **Type**: `string`
- **Min**: `2`
- **Max**: `32`

Watermark text.

#### [image](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-advancedfeatures-watermark-image)

- **Path**: `advancedFeatures.watermark.image`
- **Type**: `string`

Watermark image (UUID, URL, Data URI, or Base64).

#### [displayPosition](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-advancedfeatures-watermark-displayposition)

- **Path**: `advancedFeatures.watermark.displayPosition`
- **Type**: `string`

Watermark position.

**Allowed values**: `top-left` `top-center` `top-right` `center-left` `center-center` `center-right` `bottom-left` `bottom-center` `bottom-right` `tiled`

#### [opacity](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-advancedfeatures-watermark-opacity)

- **Path**: `advancedFeatures.watermark.opacity`
- **Type**: `float`
- **Min**: `0.1`
- **Max**: `1`
- **Step**: `0.01`

Watermark opacity.

#### [fontColor](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-advancedfeatures-watermark-fontcolor)

- **Path**: `advancedFeatures.watermark.fontColor`
- **Type**: `string`

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/bfl-flux-virtual-try-on#request-advancedfeatures-watermark-bgcolor)

- **Path**: `advancedFeatures.watermark.bgColor`
- **Type**: `string`

Background color in hex format.

## Response Parameters

### [taskType](https://runware.ai/docs/models/bfl-flux-virtual-try-on#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/bfl-flux-virtual-try-on#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [imageUUID](https://runware.ai/docs/models/bfl-flux-virtual-try-on#response-imageuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/bfl-flux-virtual-try-on#response-imageurl)

- **Type**: `string`
- **Format**: `uri`

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/bfl-flux-virtual-try-on#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/bfl-flux-virtual-try-on#response-imagedatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output image.

### [seed](https://runware.ai/docs/models/bfl-flux-virtual-try-on#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/bfl-flux-virtual-try-on#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/bfl-flux-virtual-try-on#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### virtual-try-on (virtual-try-on)

![Opera Tailcoat Costume Fitting](https://assets.runware.ai/examples/bfl-flux-virtual-try-on/3b6e2a1b-3dcc-422d-a62e-6a890a9d3b14.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "23e84feb-0aa8-4704-a317-ff79e34a875f",
  "model": "bfl:flux@vto",
  "positivePrompt": "Create a photorealistic opera wardrobe fitting by dressing the person in the reference tailcoat. Preserve the person's face, hair, skin tone, age, identity, body shape, proportions, expression, exact full-body stance, hand position, camera angle, and placement in the frame. Preserve the historic rehearsal studio background, pale floorboards, faded sage walls, soft overcast window light, shadows, and photographic perspective. Replace only the plain black T-shirt with the supplied petrol-teal velvet tailcoat, worn naturally over the torso and arms; keep the original black trousers and black shoes unchanged. Reproduce the garment faithfully, including its fitted silhouette, structured shoulders, coral silk peak lapels, long split tails, antique-gold soutache embroidery, aged brass buttons, cuff detailing, velvet pile, seams, and glimpse of coral satin lining. Tailor the coat convincingly to the performer's physique with realistic sleeve length, drape, folds, closures, and contact shadows. Keep both hands unobstructed and anatomically correct. The finished image should read as a refined, production-ready costume fitting photograph for an opera wardrobe department, with restrained period elegance and no added props, text, logos, jewelry, hats, or scenery changes.",
  "seed": 184726593,
  "steps": 4,
  "inputs": {
    "referenceImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/14b479f7-5ef3-45fe-9911-a921e9592f1b.jpg",
        "role": "person"
      },
      {
        "image": "https://assets.runware.ai/assets/inputs/60aaeb4e-87f3-47d1-b8bd-5ec0661e34b0.jpg",
        "role": "garment"
      }
    ]
  }
}
```

---

### virtual-try-on (virtual-try-on)

![Rooftop Apiary Uniform Composite](https://assets.runware.ai/examples/bfl-flux-virtual-try-on/1146fe6c-36df-46e0-807e-31fcadd61226.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "2b2cd969-8b10-489f-99d1-df6e9aead9be",
  "model": "bfl:flux@vto",
  "positivePrompt": "Dress the person in the exact cream cotton-canvas beekeeping jacket from the garment reference, replacing only her charcoal shirt. Preserve the jacket’s warm cream color, brass front zipper, integrated fencing veil folded neatly behind the collar, elastic cuffs, reinforced elbows, patch-pocket proportions, seams and stitching. Fit it naturally over her body with believable folds and sleeve volume while keeping her olive trousers and brown work boots unchanged. Preserve the person’s identity, face, hair, expression, body shape, full-body pose, hand position and proportions. Preserve the original rooftop apiary background, painted hives, planters, skyline, camera angle, framing, overcast light, shadows and documentary photographic character exactly. Keep her face fully visible. Produce a realistic finished occupational portrait with seamless garment integration and no added people, props, text or logos.",
  "inputs": {
    "referenceImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/79f2f158-8ef9-4b35-8c1a-c9dd5af45e02.jpg",
        "role": "person"
      },
      {
        "image": "https://assets.runware.ai/assets/inputs/0b0c5e55-15d6-43ec-a333-8773e6f7c0b1.jpg",
        "role": "garment"
      }
    ]
  }
}
```

---

### virtual-try-on (virtual-try-on)

![Winery Guide Banner Expansion](https://assets.runware.ai/examples/bfl-flux-virtual-try-on/cf0063e4-c421-4a5d-8908-098f94967719.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "f9999f35-ce0e-4c46-a1ce-481ff7cefe81",
  "model": "bfl:flux@vto",
  "positivePrompt": "Create a polished wide environmental banner by dressing the winery guide in the exact rust-red waxed-canvas chore coat from the garment reference. Preserve her identity, facial features, hairstyle, expression, body shape, full-body pose, hand positions, trousers, boots, camera angle, and realistic proportions. Reproduce the coat faithfully, including its hip-length cut, pointed collar, matte brass snaps, reinforced seams, chest pocket, large patch pockets, tonal stitching, waxed texture, and natural rust-red color. Fit it convincingly over her black shirt with realistic drape, folds, sleeve length, and contact shadows. Preserve the original underground limestone wine-cellar setting and warm amber lighting. Expand the scene laterally into a spacious cinematic banner composition, placing the guide on the right third and continuing the same stone arches, barrel rows, floor perspective, lamp spacing, shadows, and depth into clean negative space on the left. The expansion must appear optically continuous with the source photograph, not like a composite. Premium documentary hospitality photography, restrained palette of limestone cream, barrel brown, black, and rust red; crisp garment detail, natural skin texture, no additional people, no lettering, no logo, no signage, no border.",
  "seed": 18472639,
  "steps": 4,
  "inputs": {
    "referenceImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/3a15cd77-f026-4a8b-a47c-ccefdbcc56f7.jpg",
        "role": "person"
      },
      {
        "image": "https://assets.runware.ai/assets/inputs/6d2a4083-b7b5-49ff-ac51-fb51d382b805.jpg",
        "role": "garment"
      }
    ]
  }
}
```

---

### virtual-try-on (virtual-try-on)

![Lava Tube Surveyor Portrait Composite](https://assets.runware.ai/examples/bfl-flux-virtual-try-on/26efe9d5-50af-4672-9e16-f3d7745acd3c.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "9f7f0f45-3fa5-4937-aba1-1c5608854da8",
  "model": "bfl:flux@vto",
  "positivePrompt": "Dress the volcanologist in the exact burnt-orange geological survey coverall from the garment reference. Preserve her identity, facial features, hairstyle, body shape, proportions, full-body stance, hand position, helmet, headlamp, boots, camera viewpoint, and composition. Preserve the Icelandic lava-tube background exactly, including the charcoal basalt walls, roped survey path, cool cyan work lights, shadows, depth, and documentary low-light atmosphere. Fit the one-piece coverall naturally over her body with credible folds at the shoulders, waist, knees, and ankles. Retain the garment’s burnt-orange technical fabric, black reinforced knees and elbows, reflective silver piping, chest pockets, utility loops, central zipper, stitching, and hardware with high fidelity. Match the cave lighting across the garment: cool cyan edge light, soft headlamp spill, subdued highlights, and realistic contact shadows. Photorealistic environmental field portrait for a professional volcanology annual report, restrained charcoal, cyan, and safety-orange palette, no text or logos.",
  "inputs": {
    "referenceImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/8e2390fa-1753-4954-967b-16bf15fd946b.jpg",
        "role": "person"
      },
      {
        "image": "https://assets.runware.ai/assets/inputs/add2ccc7-35ea-4450-8627-e87b5727fa2f.jpg",
        "role": "garment"
      }
    ]
  }
}
```