Face Landmarks API Guide

Face Landmark Detection API

Locate the key points of every face component in an image — eyes, nose and mouth corners — with the bounding box and quality score for each face.

Overview

Find and return the key points of every face component in an image, along with the face profile, bounding box and a quality score.

Details

Request URL

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

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": [
      {
        "faceLandmark": {
          "mouthLeft": { "x": 998.9764404296875, "y": 1182.6712646484375 },
          "mouthRight": { "x": 617.4220581054688, "y": 1166.3719482421875 },
          "nose": { "x": 781.2542724609375, "y": 1103.4720458984375 },
          "eye_left": { "x": 1097.0299072265625, "y": 820.4296875 },
          "eye_right": { "x": 519.978271484375, "y": 794.6395874023438 }
        },
        "quality": 94.401535,
        "points": [
          { "x": 58.2854, "y": -42.453003 },
          { "x": 1562.8524, "y": -20.026917 },
          { "x": 30.252747, "y": 1838.2557 },
          { "x": 1534.8197, "y": 1860.6819 }
        ],
        "faceRectangle": {
          "x": 0,
          "y": 0,
          "height": 0,
          "width": 0
        }
      }
    ]
  }
]

Response parameters

faceLandmark object

Facial landmarks in the image

mouthLeft object

x and y position of the left mouth corner

mouthRight object

x and y position of the right mouth corner

nose object

x and y position of the nose

eye_left object

x and y position of the left eye

eye_right object

x and y position of the right eye

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