WEARFITS API terms defined

Glossary

Precise definitions of the core WEARFITS Virtual Try-On API concepts for developers and AI agents.

Terms

Virtual try-on

AI-generated image showing a product on a person. POST /api/v1/virtual-fitting creates or reuses a digital twin; POST /api/v1/tryon/clothing and /api/v1/tryon/shoes use person photos or an existing twin image without generating a new twin.

Digital twin

A reusable customer avatar identified by digitalTwinId and cached for 30 days. POST /api/v1/digital-twin requires faceImage plus exactly one of bodyPhotoUrl, silhouetteImage, clothingSize, or bodyMeasurements. Inline virtual-fitting photo generation also needs faceImage plus photoUrl.

Virtual fitting

Applying product images to a digital twin through POST /api/v1/virtual-fitting. Use garment slots for an outfit with optional shoes, or productImage for a single product, including a shoe. This produces an image, not a live AR session or a size recommendation.

Estimated size fitting

A synchronous, non-billable comparison of an eligible measurements/clothing-size twin with merchant body-range size charts through POST /api/v1/size-fitting. Recommendations are estimates. Photo/direct twins are unavailable; garment dimensions are not body-range charts.

Shoe 3D generation

Converting shoe or bag photos into a GLB asset through POST /api/v1/shoe-3d. AI texture enhancement and WEARFITS AR publication are configurable. Set options.productType to other or auto for bags; options.uploadToWearFits defaults to false for a single job.

Product digitization

Batch conversion of catalog products into 3D assets through POST /api/v1/digitization/batches: up to 500 products and 10 images per product. Batch records have a 7-day retention period. WEARFITS upload defaults to true for batches; set options.productType to other or auto for bags.

AR try-on

A live camera-based product preview in the separate WEARFITS viewer. A successful optional WEARFITS upload from shoe-3d can return a viewerUrl. The photo try-on endpoints return images rather than live AR sessions.

GLB

The binary glTF 3D model format produced by WEARFITS shoe and bag 3D generation.

Lightweight storefront try-on widget

A lightweight API-backed modal (/widget/tryon.js) without the hosted size-fitting overlay. For the complete try-on and size-fitting UI, the hosted iframe is recommended; guide: https://tryon.wearfits.com/docs/integration.html; demo: https://tryon.wearfits.com/demo_tryon.html.