idm-vton

Generates virtual try-on images by compositing garments onto person photos via the Pixazo API.

Updated May 2, 2026
One-click install
npx skills add https://github.com/Pixazo-AI/skills --skill idm-vton-pixazo-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: idm-vton
Source: https://github.com/Pixazo-AI/skills/tree/main/skills/idm-vton
Command: npx skills add https://github.com/Pixazo-AI/skills --skill idm-vton-pixazo-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually visualizing how clothing looks on a person requires physical fittings or complex photo editing. This Skill lets an AI agent call the IDM VTON model through the Pixazo API to produce a virtual try-on image from a garment photo and a person photo. ## Core Features & Use Cases - Virtual Try-On Generation: Submits a garment image URL, a person image URL, a garment description, and a clothing category to the IDM VTON endpoint and returns a composited result image. - Guided API Key Setup: Walks the agent through obtaining and storing a Pixazo API key once in ~/.pixazo/api-key so authentication never needs repeating. - Synchronous Result Handling: Returns the try-on image URL directly in the JSON response with no polling, plus structured handling for 401, 402, 429, and 5xx errors. - Use Case: An e-commerce seller asks the agent to show how a blue cotton dress looks on a model photo, and the agent returns the rendered try-on image URL in one request. ## Quick Start Ask the agent to virtually try a garment on a person by providing the garment image URL, the person image URL, and the clothing category.

Frequently Asked Questions about idm-vton

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a virtual try-on image with the IDM VTON API?▼

Send a POST request to https://gateway.pixazo.ai/idm-vton-api/v1/r-idm-vton with garm_img (garment image URL), human_img (person image URL), garment_des (description), and category. The response JSON contains an output array with the result image URL.

What inputs does the IDM VTON virtual try-on endpoint require?▼

The endpoint requires a garment image URL, a person image URL, a short garment description such as "A blue cotton dress", and a clothing category such as dresses. Both images must be accessible via public URLs.

Does IDM VTON virtual try-on require polling for results?▼

No, virtual try-on through this model is synchronous. The API returns the result image URL directly in the JSON response, so no polling loop or job status checks are needed.

Why does the Pixazo API return a 401 error on try-on requests?▼

A 401 means the API key is missing or invalid. The key is read from the PIXAZO_API_KEY environment variable or the ~/.pixazo/api-key file, and a fresh key can be created at https://api-console.pixazo.ai/api_keys.

What is the difference between IDM VTON and FASHN VTON on Pixazo?▼

Both are virtual try-on models available through the Pixazo gateway, but they are separate skills with different underlying models and endpoints. IDM VTON is based on the IDM-VTON model, while fashn-vton uses the FASHN model.