Facial Keypoint Detection

Last Updated on : 2021-07-16 08:04:31download

Identify the Base64 encoded data to detect the information about facial keypoints.

API address

POST: /v1.0/iot-03/ai-vision/face-keypoints/actions/detect

Request parameter

Return parameter

Parameter name	Type	Description
result	List	Reference for human key points

Description of result

Parameter name	Type	Description
cheek_right	List	The information about coordinates of the right cheek.
chin	FaceKeyPointRes	The information about coordinates of the chin tip.
cheek_left	List	The information about coordinates of the left cheek.
eyebrow_right	List	The information about coordinates of the right eyebrow.
eyebrow_left	List	The information about coordinates of the left eyebrow.
nose_bridge	List	The information about coordinates of the nose bridge.
nose_contour	List	The information about coordinates of the nose tip contour.
eye_right_corner_right	List	The information about coordinates of the top contour of the right eyelid.
eye_right_eyelid_lower	List	The information about coordinates of the bottom contour of the right eyelid.
eye_left_eyelid_upper	List	The information about coordinates of the top contour of the left eyelid.
eye_left_eyelid_lower	List	The information about coordinates of the bottom contour of the left eyelid.
mouth_lip_upper_outer	List	The information about coordinates of the external contour of the upper lip.
mouth_lip_lower_outer	List	The information about coordinates of the external contour of the lower lip.
mouth_lip_upper_inner	List	The information about coordinates of the internal contour of the upper lip.
mouth_lip_lower_inner	List	The information about coordinates of the internal contour of the lower lip.
eye_eyeball_center	List	The information about coordinates of the eyeball center.

Description of nose_bridge

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of eye_right_eyelid_lower

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of eye_right_corner_right

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of cheek_left

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of eye_eyeball_center

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of eye_left_eyelid_upper

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of chin

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of mouth_lip_upper_inner

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of eye_left_eyelid_lower

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of nose_contour

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of mouth_lip_upper_outer

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of eyebrow_left

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of cheek_right

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of eyebrow_right

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of mouth_lip_lower_outer

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Description of mouth_lip_lower_inner

Parameter name	Type	Description
x	Float	The latitudinal coordinate.
y	Float	The longitudinal coordinate.
point	String	The name of a specific point.

Request example

POST: /v1.0/iot-03/ai-vision/face-keypoints/actions/detect

{
  "image": "/9j/4AAQSkxxxxxxxxxxxxxxxx"
}

Return example

{
    "result": {
        "chin": {
            "point": "chin_16",
            "x": 0,
            "y": 0
        },
        "cheekRight": [
            {
                "point": "cheek_right_0",
                "x": 0,
                "y": 0
            }
        ]
    },
    "success": true
}

Error code

For more information, see error code.