Developer Docs
Three REST endpoints, authenticated with the API key from your dashboard. The explorers below make real requests — paste in a real key from API Keys in your dashboard and try them live.
Status
All three endpoints are live and fully functional today, including POST /api/v1/tryon, which renders real images via Google’s Virtual Try-On model.
Authentication
Every request needs an x-api-key header set to a key from your dashboard. Keys are SHA-256 hashed at rest; we never store or display the raw value again after creation.
GET /v1/size-chart
Free — doesn’t consume credits. Pass chest_cm (and optionally waist_cm, hips_cm) to get back an alpha size and regional labels. Omit chest_cm to get the raw alpha-band table.
/api/v1/size-chartPOST /v1/scan
1 credit per call. Computes chest/waist/hip circumference from a front-view width and side-view depth at each level, calibrated against a visible A4 sheet in each photo (Ramanujan’s ellipse-perimeter approximation). Your client does the photo capture and pose/landmark extraction (e.g. MediaPipe) and sends the resulting pixel measurements here — this endpoint does the calibration math and sizing.
/api/v1/scanPOST /v1/tryon
3 credits per call. Renders your garment on the shopper’s photo using Google’s Virtual Try-On model. Both images are base64-encoded (no data: URI prefix) — swap the placeholders below for real image data to get a real render back.
/api/v1/tryon