/info/get_image

Description

Retrieve information of a given image, including detected faces, etc.

Parameter

Name Description
Required api_key Your registered API Key
api_secret Your registered API Secret
img_id The img_id of the target image.

Return Values

Field Type Description
face array List of faces in this image
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

Parameter

https://apius.faceplusplus.com/v2/info/get_image?img_id=2ef94cb9c4bcb28937014b8812cf0754&api_key=YOUR_API_KEY&api_secret=YOUR_API_SECRET

JSON Response

{
    "face": [
        {
            "face_id": "199d1efd19ce4ee67a7ec7655f859b1a", 
            "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": ""
        }
    ], 
    "img_id": "2ef94cb9c4bcb28937014b8812cf0754", 
    "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+