E-Commerce & Virtual Try-on — KeenTools Cloud API

E-Commerce & Virtual Try-on

3D head from ordinary photos at scale – for E-commerce and virtual try-on.

Help customers make the right decision with geometrically accurate fitting.

Loading preview...

What It Does

Send 3–7 photos of a person to the API. Get back a clean, accurate 3D head model – full head shape, facial structure, proportions, base texture – ready to render any product on.

Once generated, every product in the catalog is rendered on the head instantly, from any angle, at any fidelity.

The API

REST API, cloud-hosted.

Two data modes:

POST /v1/head

input:  3–7 photos (URLs or upload)
output: 3D head base mesh + photoreal texture
time:   1–3 min

Ephemeral — photos pulled from your URLs, model pushed to your destination, zero retention on KeenTools servers
Managed — model storage and account management on KeenTools infrastructure

What You Get

Geometry: Full head – face, temples, crown, sides, neck, shoulders. Clean, uniform mesh topology. Every model has the same vertex layout – no retopology, no cleanup, production-ready.
Texture: Photorealistic, derived from the input photos. Accurate to the person's skin tone and facial features.
Accuracy: Multi-photo optimization extracts real head shape rather than estimating it. Correct frame width. Correct hat sizing. Correct headphone fit. Products sit where they should.
Persistence: The model is generated once and reused. Subsequent try-on sessions require no KeenTools processing, rendering happens entirely on your side.

Applications

Eyewear: True 3D head for frame width, nose bridge, temple length, ear placement.
Hats & Headwear: Perfect crown coverage and side fit.
Helmets & Protective Headgear: Visual size preview based on true head geometry, integrated with size recommendation logic.
Headphones: Over-ear and on-ear proportion and fit, on the customer's actual head.
Hair: Accurate base mesh for virtual hairstyle and color preview. Pair with your hair asset library.
Makeup & Skincare: Life-like skin texture on geometrically correct face surface for contouring, shading, and treatment visualization.

How it works

Send a set of photos to the API and get back a clean, accurate 3D head with uniform topology and photoreal texture — generated once and reused for instant, any-angle rendering of your whole catalog.

# 1. Open a session — returns an avatar id and photo upload URLs
curl -X POST https://api.cloud.keentools.io/v1/avatar/init \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "image_count": 5 }'

# 2. Upload each photo to its pre-signed URL
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo-1.jpg

# 3. Start reconstruction on the session
curl -X POST https://api.cloud.keentools.io/v1/avatar/$AVATAR_ID/process \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "focal_length_type": { "focal_length_type": "estimate_common" } }'

# 4. Download the result — OBJ + texture, delivered as a ZIP
curl -L -X GET "https://api.cloud.keentools.io/v1/avatar/$AVATAR_ID/get-3d-model?mesh_format=obj&texture=jpg" \
  -H "Authorization: Bearer $API_KEY" \
  -o head.zip

Render your catalog on a real head

Try in Playground Talk to us about your application

No hardware. No subscription. Start with a free credit allocation. Questions about user data handling or integration architecture? Reach the team directly.