IDM VTON API: Pricing, Documentation

by IDM-VTON

IDM VTON API, fashion retailers and e-commerce platforms can implement realistic virtual fitting rooms. The API handles various clothing types and body poses, creating convincing visualizations that help customers make confident purchasing decisions.

Get API Key

Models Version

WELCOME BONUS

Get $5 Free Credit on First Payment

No strings attached — add funds and get $5 bonus instantly

Claim Your $5 →

IDM VTON v1 API Documentation

https://gateway.pixazo.ai/idm-vton-api/v1/r-idm-vton

idm-vton - IDM VTON API

Request Code

POST https://gateway.pixazo.ai/idm-vton-api/v1/r-idm-vton
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: your-subscription-key

{
  "garm_img": "https://example.com/garment.jpg",
  "human_img": "https://example.com/human.jpg",
  "garment_des": "A blue cotton dress",
  "category": "dress"
}

import requests

url = "https://gateway.pixazo.ai/idm-vton-api/v1/r-idm-vton"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "your-subscription-key"
}
data = {
    "garm_img": "https://example.com/garment.jpg",
    "human_img": "https://example.com/human.jpg",
    "garment_des": "A blue cotton dress",
    "category": "dress"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

const url = 'https://gateway.pixazo.ai/idm-vton-api/v1/r-idm-vton';

const data = {
  garm_img: 'https://example.com/garment.jpg',
  human_img: 'https://example.com/human.jpg',
  garment_des: 'A blue cotton dress',
  category: 'dress'
};

fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Cache-Control': 'no-cache',
    'Ocp-Apim-Subscription-Key': 'your-subscription-key'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

curl -v -X POST "https://gateway.pixazo.ai/idm-vton-api/v1/r-idm-vton" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: your-subscription-key" \
  --data-raw '{
    "garm_img": "https://example.com/garment.jpg",
    "human_img": "https://example.com/human.jpg",
    "garment_des": "A blue cotton dress",
    "category": "dress"
  }'

Output

{
  "result_url": "https://result.pixazo.ai/output.jpg",
  "status": "completed",
  "job_set_id": "job-12345-abcde",
  "processing_time": 2.4
}

Try Now

Request Parameters - idm-vton

Parameter	Required	Type	Default	Allowed values / range	Description
garm_img	Yes	string	—	—	URL of the garment image. Should match the selected category; can be a product image or a photo of someone wearing the item.
human_img	Yes	string	—	—	URL of the person/model image. Best results with a 3:4 aspect ratio; otherwise enable crop.
garment_des	No	string	—	—	Text description of the garment (e.g. Short Sleeve Round Neck T-shirt). Improves try-on quality.
category	No	string	upper_body	upper_body, lower_body, dresses	Category of the garment being tried on.
mask_img	No	string	—	—	Optional mask image (URL). Supplying one skips automatic masking and speeds up generation.
crop	No	boolean	false	true / false	Crop and resize the human image to a 3:4 ratio. Enable when the source image is not already 3:4.
force_dc	No	boolean	false	true / false	Use the DressCode variant of IDM-VTON. Applied automatically when category is dresses.
mask_only	No	boolean	false	true / false	Return only the generated mask instead of the final try-on image.
steps	No	integer	30	1 - 40	Number of denoising steps. Higher values add detail at the cost of speed.
seed	No	integer	42	—	Random seed for reproducible results.

Content Item Types & Limits

Type	Max	Format / Size	Description
human_img	1	JPG, PNG, WEBP	Person / model photo.
garm_img	1	JPG, PNG, WEBP	Garment image.

Example Request

{
  "garm_img": "https://example.com/garment.jpg",
  "human_img": "https://example.com/human.jpg",
  "garment_des": "A blue cotton dress",
  "category": "dress"
}

Response

{
  "result_url": "https://result.pixazo.ai/output.jpg",
  "status": "completed",
  "job_set_id": "job-12345-abcde",
  "processing_time": 2.4
}

Request Headers

Header	Value
Content-Type	application/json
Cache-Control	no-cache
Ocp-Apim-Subscription-Key	your-subscription-key

Response Handling

Common status codes for idm-vton.

Code	Meaning
200	Success
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
429	Too Many Requests
500	Internal Server Error

IDM VTON v1 API Pricing

Your request will cost $0.05 per try-on image.