Detect Face
Server-to-Server
Detect Face
Detect a face in an image and return bounding box and landmarks
POST
Detect Face
/v1/face/compare or /v1/face/estimate-age — for example, to give the user immediate feedback that their selfie is too dark or off-frame.
Request
Headers
Body parameters
See the overview for the shared image rules.
Example request
Response
200 — Success
boundingBox shape: { top, left, width, height }, each normalized to 0–1 against the source image dimensions.
landmarks[] shape: { type, x, y }, where type is the landmark name (e.g. eyeLeft, nose, mouthRight) and x/y are normalized to the image dimensions.
Error responses
When no face is detected the endpoint still returns
200 OK with
faceDetected: false. Treat that as a UX-level failure (prompt the user
to retake) rather than an integration error. Only the highest-confidence
face is returned.