3D Visualizer API

Product 3D mesh

Reconstruct a GLB mesh from one product photo. Requires the ai_3d module. POST returns a job; poll until model_url is a GLB on the KadmilOS CDN. Not multi-view stills. Typical 25–60s.

← Docs overview · Product page

Pass your kos_live_* key. The ai_3d module must be enabled on the key.

header

Authorization: Bearer kos_live_YOUR_KEY

Authentication

Pass your kos_live_* key. The ai_3d module must be enabled on the key.

header

Authorization: Bearer kos_live_YOUR_KEY

Submit a photo

POST a public HTTPS image_url (alias: product_image_url). Clean-background product shots produce the best geometry. Response is async: job_id + poll_url. No vendor names in JSON.

POST /api/v1/ai/3d

curl -sS -X POST https://www.vinket.eu/api/v1/ai/3d \
  -H "Authorization: Bearer $KADMILOS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "image_url": "https://cdn.yourbrand.com/sku-001.jpg" }'

Poll until GLB

status=processing — wait and retry
status=succeeded + model_url — GLB on KadmilOS CDN
format is always glb

GET /api/v1/ai/3d?job_id=

curl -sS "https://www.vinket.eu/api/v1/ai/3d?job_id=JOB_ID" \
  -H "Authorization: Bearer $KADMILOS_KEY"

Limits & errors

Monthly generation caps per plan. Over quota → 429. Missing image → 400. Module missing → 403. Failed reconstruct → 502 (generic — no vendor string).