Face Detection API Guide

Face Detection API

Detect and locate every human face in an image and get back high-accuracy bounding boxes, landmark points and a quality score for each one.

Select version

Download document

Postman Swagger

Download sample code

C# Node Laravel Java PHP

Overview

Detect and find human faces within an image. The API returns high-accuracy bounding boxes for every face found, along with landmark points and a quality score you can use to reject unusable captures before they reach your matching pipeline.

Details

Request URL

https://faceapi.mxface.ai/api/v3/Face/detect

Method type

POST

Headers

Content-Type : application/json

Subscriptionkey : xxxxxxxxxxx

Request body

{
  "encoded_image": "/9j/4AAQSkZJRgABAQAAAQA......"
}

Request parameters

encoded_image YesString

base64 encoded string

minimumDistanceBetweenEyeThreshold NoInt

Set distance between eyes

Response body

[
  {
    "faces": [
      {
        "quality": 94.401535,
        "points": [
          { "x": 71.92761, "y": -36.935425 },
          { "x": 1560.9269, "y": -7.7887573 },
          { "x": 35.494263, "y": 1824.3137 },
          { "x": 1524.4935, "y": 1853.4603 }
        ],
        "faceRectangle": {
          "x": 35,
          "y": 0,
          "height": 1853,
          "width": 1525
        }
      }
    ]
  }
]

Response parameters

quality float

Quality score of image between 1 and 100

faceRectangle object

Boundary of the face

height int

Height of face

width int

Width of face

x int

x-edge of face

y int

y-edge of face