{"openapi":"3.1.0","info":{"title":"Face Detection API","version":"1.0.0","description":"Detect human faces in an image and analyse each one with on-device machine learning: get the bounding box and a detection confidence, an estimated age, the predicted gender with its probability, and the dominant facial expression together with the full per-expression breakdown (neutral, happy, sad, angry, fearful, disgusted and surprised). A lightweight count endpoint returns just the number of faces and their boxes for fast gating. Supply an image by public URL, base64 or a raw binary request body; only public http/https URLs are accepted and private or internal hosts are blocked, and large images are downscaled automatically. Runs locally on TensorFlow (face-api) — no third-party upstream and no per-image cloud cost — with warm models that keep inference fast. Ideal for photo and avatar apps, audience analytics, smart cameras, auto-cropping and accessibility.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/facedetect-api","description":"oanor gateway"}],"tags":[{"name":"Face"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/count":{"get":{"operationId":"get_v1_count","tags":["Face"],"summary":"Count faces (detection only)","description":"","parameters":[{"name":"url","in":"query","required":false,"description":"Image URL (or base64/raw body)","schema":{"type":"string"}},{"name":"base64","in":"query","required":false,"description":"Base64 image data","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/detect":{"get":{"operationId":"get_v1_detect","tags":["Face"],"summary":"Detect faces with age/gender/expression","description":"","parameters":[{"name":"url","in":"query","required":false,"description":"Image URL (or base64/raw body)","schema":{"type":"string"},"example":"https://example.com/photo.jpg"},{"name":"base64","in":"query","required":false,"description":"Base64 image data","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1500,"rps_limit":1,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1500,"monthly_call_quota":30000,"rps_limit":3,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4200,"monthly_call_quota":220000,"rps_limit":8,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":10900,"monthly_call_quota":1000000,"rps_limit":20,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/facedetect-api"}