Integrations / API & Developers
Photo in, fit payload out
For custom, headless and native storefronts. Two endpoints cover the whole flow: create a render, read the confidence payload.
2
Endpoints to integrate
3
SDKs — JS, Python, PHP
99.95%
Rolling 12-month uptime
60/min
Default rate limit per key
Reference
One request, one decision
POST /v1/renders
POST /v1/renders
Authorization: Bearer sk_live_...
Content-Type: application/json
{
"garment_id": "grm_4821",
"photo_url": "https://cdn.store.com/tmp/abc.jpg",
"size_chart_id": "chart_ss26_tops"
}
200 OK
{
"render_url": "https://cdn.omnyfit.com/r/9f2c.jpg",
"render_ms": 1712,
"recommended_size": "M",
"confidence": { "S": 0.22, "M": 0.94, "L": 0.61, "XL": 0.12 }
}Specifics
Implementation notes.
Auth
Bearer secret keys, server-side only. Browser uploads use short-lived signed upload tokens.
Photo handling
Photos are processed in memory and dropped after the render completes; render URLs expire in 24 hours by default.
Webhooks
render.completed, render.failed and session.converted events, signed with HMAC-SHA256.
Latency
Median 1.7s end-to-end from a European or North American edge region.
Sandbox
Test keys return deterministic renders and confidence payloads, free of charge.
CALCULATE YOUR ROI
Stop paying 65% of retail to ship a size back. Calculate your ROI.
No commitment to see your numbers. Takes about 90 seconds.