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.

Select version

Download document

Postman Swagger

Download sample code

C# Node Laravel Java PHP

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