Try-On addons

Virtual Try-On API

Shopper / PDP fitting-room — standalone from Fashion Studio. Endpoint POST /api/v1/ai with action: product_to_model. Credit pool (not studio 500/2k/5k caps). Model input: BYOM HTTPS URL and/or Model Library catalog URL. Does not require ai_models. Premium requires Try-On Pro and is never auto-selected when standard fails.

← Docs overview · Product page · Fashion Studio (not this SKU) · Pricing

KadmilOS kos_live_* key with try-on addon modules. Standard: tryon_standard (or legacy tryon). Premium: tryon_premium only. Try-On Pro alone also unlocks standard quality on this endpoint.

header

Authorization: Bearer kos_live_YOUR_KEY

Authentication

KadmilOS kos_live_* key with try-on addon modules. Standard: tryon_standard (or legacy tryon). Premium: tryon_premium only. Try-On Pro alone also unlocks standard quality on this endpoint.

header

Authorization: Bearer kos_live_YOUR_KEY

Standard try-on

Fast, consistent garment placement. Consumes 1 AI credit per call. Categories: upper_body, lower_body, dresses (and common aliases).

POST /api/v1/ai · standard

curl -sS -X POST https://www.vinket.eu/api/v1/ai \
  -H "Authorization: Bearer $KADMILOS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "product_to_model",
    "garment_image": "https://cdn.yourbrand.com/sku-001.jpg",
    "model_image": "https://cdn.yourbrand.com/model-f-01.jpg",
    "category": "upper_body",
    "quality": "standard"
  }'

Try-On Pro (premium)

Set quality to premium or high explicitly. Photorealistic tier for campaign / editorial use. Consumes 13 credits per call. Without Try-On Pro on the key → 403. Premium is never used as a silent fallback from standard.

POST /api/v1/ai · premium

curl -sS -X POST https://www.vinket.eu/api/v1/ai \
  -H "Authorization: Bearer $KADMILOS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "product_to_model",
    "garment_image": "https://cdn.yourbrand.com/sku-001.jpg",
    "model_image": "https://cdn.yourbrand.com/model-f-01.jpg",
    "category": "upper_body",
    "quality": "premium"
  }'

Credits & response

Standard: 1 credit · Pro: 13 credits
Success: output_url, quality, ai_credits_remaining
Exhausted credits → 402
Client JSON never names underlying processing providers

Not Fashion Studio

Brand catalog photoshoot is a different product: POST /api/v1/ai/models (ai_models) with studio caps. Cross-SKU note: Studio quality: "pro" also requires Try-On Pro. See Fashion Studio docs.