/info/get_face

Description

Given a list of faces, return corresponding information of the faces (information includes source image, associated person, etc).

Parameter

Name Description
Required api_key Your registered API Key
api_secret Your registered API Secret
face_id A comma-separated list of face ids.

Return Values

Field Type Description
url string Image url as specified in the request
img_id string Unique id of an image on Face++ platform
face_id string Unique id of a detected Face on Face++ platform
img_width integer Image width in pixels
img_height integer Image height in pixels
faces array A list of detected faces, each element is a description of Face
width float The width of detected face (as 0-100% of image width)
height float The height of detected face (as 0-100% of image width)
center object x & y coordinates of the center point of the detected face rectangle, as 0-100% of photo width and height
nose object x & y coordinates of nose, as 0-100% of photo width and height
eye_left object x & y coordinates of left eye, as 0-100% of photo width and height
eye_right object x & y coordinates of right eye, as 0-100% of photo width and height
mouth_left object x & y coordinates of left edge of mouth, as 0-100% of photo width and height
mouth_right object x & y coordinates of right edge of mouth, as 0-100% of photo width and height
attribute object List of detected facial attributes (currently gender and age)
gender object Male/Female value and confidence
age object Estimated age value and range
race object Asian/Black/White value and confidence
person array information of persons which this face assigned to
faceset array information of facesets which this face assigned to

Parameter

https://apius.faceplusplus.com/v2/info/get_face?api_secret=YOUR_API_SECRET&face_id=1b132a77fd3ad83a5f83fd3541d31831&api_key=YOUR_API_KEY

JSON Response

{
    "face_info": [
        {
            "attribute": {
                "age": {
                    "range": 5, 
                    "value": 12.5
                }, 
                "gender": {
                    "confidence": 60.6197, 
                    "value": "Female"
                }, 
                "race": {
                    "confidence": 99.9178, 
                    "value": "Asian"
                }
            }, 
            "face_id": "1b132a77fd3ad83a5f83fd3541d31831", 
            "faceset": [
                {
                    "faceset_id": "1b9d0352843065b26de42dfccc751cc0", 
                    "faceset_name": "f1", 
                    "tag": ""
                }
            ], 
            "img_id": "892280e2a4b36175fea0b4377d635c51", 
            "person": [
                {
                    "person_id": "5c6da14aef83ff44529770346ff81f4a", 
                    "person_name": "p1", 
                    "tag": ""
                }, 
                {
                    "person_id": "380f9d13348c658acd303f228e117828", 
                    "person_name": "p2", 
                    "tag": ""
                }, 
                {
                    "person_id": "d2fb2aad055518c3b3d78f31e8360540", 
                    "person_name": "p3", 
                    "tag": ""
                }
            ], 
            "position": {
                "center": {
                    "x": 49.285714, 
                    "y": 18.5
                }, 
                "eye_left": {
                    "x": 44.718571, 
                    "y": 15.424933
                }, 
                "eye_right": {
                    "x": 53.37881, 
                    "y": 14.9466
                }, 
                "height": 11.666667, 
                "mouth_left": {
                    "x": 45.677381, 
                    "y": 22.597167
                }, 
                "mouth_right": {
                    "x": 51.64, 
                    "y": 22.462333
                }, 
                "nose": {
                    "x": 48.300714, 
                    "y": 19.778667
                }, 
                "width": 16.666667
            }, 
            "tag": "", 
            "url": "http://faceplusplus.com/static/img/demo/6.jpg"
        }
    ]
}

Error Code List

Error Code HTTP Status Code Error Message
1001 500 INTERNAL_ERROR
1003 403 AUTHORIZATION_ERROR
1003 403 INSUFFICIENT_PRIVILEGE_OR_QUOTA_LIMIT_EXCEEDED
1004 400 MISSING_ARGUMENTS
1005 400 INVALID_ARGUMENTS
1006 403 ILLEGAL_USE_OF_DEMO_KEY
1202 502 SERVER_TOO_BUSY
Google+