# WEARFITS Virtual Try-On API — Frequently Asked Questions

Base URL: https://api.wearfits.com

## What is WEARFITS?

WEARFITS is an AI virtual try-on and 3D product generation API for fashion ecommerce. Developers integrate it into storefronts and apps; it is not a consumer app.

## How do I add virtual try-on to my online store?

The fastest path is the embeddable widget: add <script src="https://api.wearfits.com/widget/tryon.js" data-api-key="..."></script> and call Wearfits.openTryOn({ products: [...] }) from a "Try on" button. For full control, call POST /api/v1/virtual-fitting directly from your backend.

## What is the difference between virtual-fitting and shoe-3d?

POST /api/v1/virtual-fitting applies clothing (tops, bottoms, full-body, optional shoes) onto a digital twin and returns a try-on image. POST /api/v1/shoe-3d turns shoe or bag photos into a 3D GLB model and an AR try-on. Footwear-only AR uses shoe-3d, not virtual-fitting.

## Which endpoint should I use for clothing vs shoes vs bags?

Clothing (tops/bottoms/dresses) → POST /api/v1/virtual-fitting. Footwear AR or 3D shoe models → POST /api/v1/shoe-3d. Handbags → POST /api/v1/shoe-3d with productType set to "other" or "auto". Many products at once → POST /api/v1/digitization/batches.

## Does WEARFITS require a full-body photo of the customer?

No. A digital twin can be created from a face photo plus a clothing size or body measurements, a silhouette image, or a full-body photo — at least one body source is required.

## Is the API synchronous or asynchronous?

Asynchronous. Submitting a job returns a jobId and status URL. Poll GET /api/v1/jobs/{jobId} until completed or failed, or supply a webhookUrl for a signed server-to-server callback.

## How do I authenticate?

Send your key in the X-API-Key header on every /api/* request. Never expose a service key in client-side code — proxy through your backend or use a scoped browser token.

## Does WEARFITS support Shopify and WooCommerce?

Yes. The widget loads on Shopify (theme embed + Liquid product JSON) and WooCommerce (enqueue + wp_localize_script). See https://wearfits.com/lp2/shopify-shoes/ and https://wearfits.com/lp2/woocommerce-shoes/.

## What is WEARFITS?

WEARFITS is an AI virtual try-on and product digitization API for fashion retailers, marketplaces, and commerce apps.

## What can developers build with it?

Developers can build virtual fitting rooms, digital twin flows, shoe and bag 3D generation pipelines, and embeddable try-on modals.

## Where is the machine-readable API specification?

The OpenAPI 3.1 specification is available at https://api.wearfits.com/doc.

## Can the same customer avatar be reused?

Yes. Save the returned digitalTwinId and pass it in later requests to skip twin generation.

## Which product categories are supported?

Tops, bottoms, and full-body garments such as dresses or jumpsuits. Every virtual fitting request needs at least one of those, and shoes can be added on top of an outfit. Standalone footwear try-on is a separate pipeline: the shoe-3d endpoint generates a 3D shoe model and an AR shoe try-on.

## Does the API return synchronously?

Virtual fitting creates an asynchronous job. Poll GET /api/v1/jobs/{jobId} or use signed webhooks.

## How long are digital twins cached?

Digital twins are cached for 30 days by default.

## Can users avoid full-body photos?

Yes. Size and measurements modes support digital twin creation without requiring a full-body photo.

## How is a saved twin checked?

Call GET /api/v1/digital-twin/{id} to verify that a saved digitalTwinId is still valid.

## Can bags be processed too?

Yes. Use productType "other" or "auto" to route non-shoe products such as handbags away from shoe-specific prompts.

## Can existing GLB files be enhanced?

Yes. Pass glbInput to skip generation and run transformation or texture enhancement on an existing GLB.

## Is batch digitization supported?

Yes. POST /api/v1/digitization/batches queues up to 500 products per batch on a low-priority queue.

## Where is the full API specification?

The OpenAPI 3.1 specification is at https://api.wearfits.com/doc and the Swagger UI at https://api.wearfits.com/reference.