SnapMeasure API Docs — Bespoke Fashion Technology

Overview

SnapMeasure accepts a front-facing full-body photo (plus a side photo) and returns 9 body measurements in centimetres. Before returning results, Agent 2 (our Gemini Vision quality auditor) inspects the photo and rejects poor-quality images with specific, actionable advice.

9

Body measurements returned

< 3s

Typical response time

£0.15

Per call after free trial

Authentication

All requests must include an X-API-Key header. Generate your key at /api-portal.

X-API-Key: sk_live_your_api_key_here

Trial policy: Every new API key receives 2 free calls (admin-configurable, max 5). Subsequent calls require purchased credits. Credits never expire.

POST /measure/upload

Submit body photos. Returns measurements or a photo quality error. Use multipart/form-data encoding.

Request Parameters

Field	Type	Required	Description
front	File	Required	Front-facing full-body photo. JPG or PNG. Person must be fully visible head to ankle, fitted clothing, plain background, even lighting.
left_side	File	full shot	Side-profile photo (same conditions). Improves circumference accuracy by providing depth information.
height_cm	Float	full shot	Subject's height in centimetres (e.g. 178.5). Strongly recommended — significantly improves measurement accuracy.

curl -X POST https://snap2wear.xyz/measure/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "front=@/path/to/front_photo.jpg" \
  -F "left_side=@/path/to/side_photo.jpg" \
  -F "height_cm=178"

import requests

response = requests.post(
    "https://snap2wear.xyz/measure/upload",
    headers={"X-API-Key": "YOUR_API_KEY"},
    files={
        "front":     open("front_photo.jpg", "rb"),
        "left_side": open("side_photo.jpg",  "rb"),   
    },
    data={"height_cm": 178},
)

data = response.json()
if response.ok:
    print(data["measurements"])
else:
    print(data["error"], data.get("advice", ""))

const form = new FormData();
form.append("front",     frontFileInput.files[0]);
form.append("left_side", sideFileInput.files[0]);  
form.append("height_cm", 178);

const res = await fetch("https://snap2wear.xyz/measure/upload", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY" },
  body: form,
});

const data = await res.json();
if (res.ok) {
  console.log(data.measurements);
} else {
  console.error(data.error, data.advice);
}

$ch = curl_init("https://snap2wear.xyz/measure/upload");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    "front"      => new CURLFile("/path/to/front.jpg"),
    "left_side"  => new CURLFile("/path/to/side.jpg"),   
    "height_cm"  => 178,
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = json_decode(curl_exec($ch), true);
print_r($response["measurements"]);

Response Schema

200 OK — Success

{
  "measurements": {
    "shoulder_width":       44.3,   // cm — shoulder point to shoulder point
    "chest_circumference":  98.2,   // cm — around fullest part of chest
    "waist_circumference":  81.5,   // cm — natural waist
    "hip_circumference":    95.0,   // cm — fullest part of hips
    "neck_circumference":   38.6,   // cm — base of neck
    "arm_length":           62.1,   // cm — shoulder to wrist
    "shirt_length":         71.4,   // cm — shoulder to hem
    "trouser_length":      103.2,   // cm — waist to floor
    "thigh_circumference":  57.8    // cm — fullest part of upper thigh
  },
  "scale_factor":    0.042,
  "user_height_cm":  178.0,
  "side_depth_used": true,          // true if left_side was provided and improved accuracy
  "audit": {
    "pass": true,
    "issues": [],
    "advice": ""
  },
  "api_usage": {
    "trial_calls_used":      1,
    "trial_calls_remaining": 1,
    "paid_credits":          0
  }
}

Error Responses

HTTP	error field	When	Action
401	invalid_key	Key missing, wrong, or revoked	Check your API key
400	front image required	No front photo in request	Add front field
400	no_person_detected	Pose not detected in photo	Show full body, head to ankle
402	payment_required	Trial exhausted, no credits	Buy credits at /api-portal
422	photo_quality	Agent 2 flagged photo issues	Read issues + advice fields; re-upload
500	libraries_unavailable	AI libs not installed on server	Contact support

422 Photo Quality Error

{
  "error":   "photo_quality",
  "issues":  ["heavy shadow on left side", "baggy clothing hiding waist"],
  "advice":  "Please re-upload in fitted clothing under bright, even lighting.",
  "measurements": { ... }   // still returned for reference, but may be inaccurate
}

Photo Guidelines

✓ Front Photo

✓ Full body visible — head to ankle
✓ Facing camera directly
✓ Fitted clothing (not baggy)
✓ Arms slightly away from body
✓ Plain background
✓ Bright, even lighting
✓ JPG or PNG, max 10MB

◈ Side Photo

◈ Left or right profile view
◈ Full body visible
◈ Same lighting conditions as front
◈ Improves chest, waist & hip accuracy
◈ Especially useful for larger sizes
◈ Same file format restrictions

Pricing

Tier	Calls	Cost	Notes
Free Trial	2 per key	£0.00	Automatically applied to every new key
Starter	10 credits	£1.50	£0.150/call
Growth	50 credits	£6.00	£0.120/call — 20% off
Scale	200 credits	£20.00	£0.100/call — 33% off
Enterprise	500 credits	£40.00	£0.080/call — 47% off

Credits never expire. Failed calls (400/422 errors) are not charged if the failure was caused by photo quality — only successful 200 responses consume a credit.

SnapMeasure API

Top Up Circle Wallet