AI Fashion Studio API

AI Fashion Studio + Model Library

AI Fashion Studio = brand catalog / campaign photoshoot at studio caps (500/2k/5k) via POST /api/v1/ai/models. Not shopper Try-On (product_to_model). Checkout includes Model Library as a complementary catalog add. Standard path needs ai_models; quality: "pro" requires Try-On Pro — never an automatic upgrade.

← Docs overview · Studio product · Model Library · Try-On (fitting-room) · Pricing

Bearer kos_live_* key. Standard shoots need ai_models. Catalog reads need model_library. Pro shoots need tryon_premium.

header

Authorization: Bearer kos_live_YOUR_KEY

Authentication

Bearer kos_live_* key. Standard shoots need ai_models. Catalog reads need model_library. Pro shoots need tryon_premium.

header

Authorization: Bearer kos_live_YOUR_KEY

Standard studio shoot

Brand photoshoot path — POST garment + model image URLs. Async job_id + poll_url. Caps 500 / 2,000 / 5,000 per tier. Categories: upper_body, lower_body, dresses (aliases tops / bottoms accepted). For shopper PDP fitting-room use Try-On docs instead.

POST /api/v1/ai/models

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

Pro quality (requires Try-On Pro)

Cross-SKU gate: set quality: "pro" only when Try-On Pro is on the key. Pro is never a silent fallback from standard studio failure. Without the module → 403. Standard studio does not require Try-On.

POST · quality=pro

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

Model Library (standalone catalog)

GET curated model stills — read-only, no generation. Buyable alone or included with AI Fashion Studio. Use a returned URL as model_image on Studio or Try-On, or in your own pipeline. Requires model_library.

GET /api/v1/ai/models/catalog

curl -sS "https://www.vinket.eu/api/v1/ai/models/catalog" \
  -H "Authorization: Bearer $KADMILOS_KEY"

Key fields

garment_image / model_image — HTTPS URLs
quality — standard (default) or pro
Response: output_url, quality, api_version
EU AI Act: disclose AI-generated imagery where required — brand owns compliance