Face Attributes API Guide

Face Attributes API

Detect and measure facial attributes such as estimated age and gender, returned together with the bounding box and quality score for every face found.

Select version

Download document

Postman Swagger

Download sample code

C# Node Laravel Java PHP

Overview

Detect and measure soft biometric attributes from a face — estimated age and gender — returned alongside the bounding box, landmark points and quality score in one call.

Details

Request URL

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

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": [
      {
        "faceAnalytics": {
          "age": "36.91389",
          "gender": "Female"
        },
        "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

faceAnalytics object

Facial analytics in the image

age string

Estimated age of face

gender string

Estimated gender of face

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