# WEARFITS Virtual Try-On API

> AI-powered virtual try-on, digital twin, and 3D product generation API for fashion commerce.

WEARFITS provides Cloudflare Workers-hosted API endpoints for:

- Virtual fitting: apply tops, bottoms, and full-body garments to a reusable digital twin; shoes are an optional add-on to an outfit. Standalone footwear AR try-on is a separate pipeline (the shoe-3d endpoint).
- Digital twins: create and reuse customer avatars from face photos, silhouettes, photos, sizes, or measurements.
- Shoe and bag 3D generation: convert product images into GLB assets with AI texture enhancement.
- Storefront widget: open a virtual try-on modal by passing product JSON from a shop page.

## Primary Links

- Website: https://api.wearfits.com/
- OpenAPI JSON: https://api.wearfits.com/doc
- Swagger UI: https://api.wearfits.com/reference
- Virtual Try-On API: https://api.wearfits.com/virtual-try-on-api
- AI Fitting Room: https://api.wearfits.com/ai-fitting-room
- Digital Twin API: https://api.wearfits.com/digital-twin-api
- Shoe 3D API: https://api.wearfits.com/shoe-3d-api
- Shopify Virtual Try-On: https://api.wearfits.com/shopify-virtual-try-on
- WooCommerce Virtual Try-On: https://api.wearfits.com/woocommerce-virtual-try-on

## Agent Documentation

- Full LLM context: https://api.wearfits.com/llms-full.txt
- Virtual try-on markdown: https://api.wearfits.com/docs/virtual-try-on-api.md
- Storefront modal guide: https://api.wearfits.com/docs/shopify-modal.md
- Endpoint summary: https://api.wearfits.com/docs/openapi-summary.md

## Integration Skills

Step-by-step integration playbooks for AI agents. JSON index at https://api.wearfits.com/skills; each skill body is markdown.

- API integration (direct HTTP): https://api.wearfits.com/skills/wearfits-api-integration.md
- Embeddable try-on widget: https://api.wearfits.com/skills/wearfits-virtual-tryon-widget.md
- Shopify integration: https://api.wearfits.com/skills/wearfits-shopify-integration.md
- WooCommerce integration: https://api.wearfits.com/skills/wearfits-woocommerce-integration.md

## Core API Endpoints

- POST /api/v1/virtual-fitting
- POST /api/v1/digital-twin
- GET /api/v1/digital-twin/{id}
- POST /api/v1/shoe-3d
- POST /api/v1/digitization/batches
- GET /api/v1/jobs/{jobId}

## Authentication

All /api/* endpoints require X-API-Key. Public documentation, /llms.txt, /llms-full.txt, and /widget/tryon.js do not require authentication.


## Recommended Integration Sequence

1. For a direct API integration, create or reuse a digital twin.
2. Submit product images as garment slots to POST /api/v1/virtual-fitting.
3. Poll GET /api/v1/jobs/{jobId} until the job reaches completed or failed.
4. Save digitalTwinId for future sessions.
5. Use webhooks for server-to-server production flows.

## Storefront Modal Integration

Use https://api.wearfits.com/widget/tryon.js when a shop wants a fast modal integration. The widget exposes window.Wearfits.openTryOn(config). Pass product JSON with id, name, category, images, sizes, variants, and selectedVariant when available.

Recommended product categories:

- top
- bottom
- full-body
- shoe

For one product, the widget sends the first image as `productImage` with the product category as a hint (`auto` when unknown), explicitly triggering the direct 2-image path so the model sees only the avatar/person and that product image (no grid). For multiple products, it maps categories to topGarment, bottomGarment, fullBodyGarment, and shoes fields. For standalone footwear with AR output, use the shoe-3d endpoint instead — it generates a 3D shoe model and an AR shoe try-on.

## Product JSON Shape

```json
{
  "products": [
    {
      "id": "sku-123",
      "name": "White Cotton Shirt",
      "category": "top",
      "images": ["https://shop.example/products/shirt-front.jpg"],
      "sizes": ["S", "M", "L"],
      "variants": [{ "id": "variant-1", "size": "M" }]
    }
  ],
  "customer": {
    "gender": "female",
    "height": 170
  }
}
```

## API Behavior Notes

- Virtual fitting returns a jobId; digitalTwinId is exposed on the job status response (GET /api/v1/jobs/{jobId}) once the job completes, not on the initial submission response.
- Digital twins are cached for 30 days.
- Result cache may return fast completed results for identical twin and garment inputs.
- Garment fields accept a single URL or an array where the first image is the packshot and the optional second image is an on-model reference.
- Webhooks are signed with HMAC-SHA256 using SHA-256(api key) as the signing secret.

## Positioning

Use these entity descriptions consistently:

- Product name: WEARFITS Virtual Try-On API
- Category: AI virtual try-on API for fashion ecommerce
- Main use cases: virtual fitting rooms, digital twin reuse, shoe 3D generation, product digitization, Shopify and WooCommerce try-on modals
- Primary domain: https://api.wearfits.com