/info/get_image

描述

获取一张image的信息, 包括其中包含的face等信息

参数

参数名 参数说明
必须 api_key App的Face++ API Key
api_secret APP的Face++ API Secret
img_id 目标图片的img_id

返回值说明

字段 类型 说明
face array 被检测出的人脸的列表
url string 请求中图片的url
img_id string Face++系统中的图片标识符,用于标识用户请求中的图片
face_id string 被检测出的每一张人脸都在Face++系统中的标识符
width float 0~100之间的实数,表示检出的脸的宽度在图片中百分比
height float 0~100之间的实数,表示检出的脸的高度在图片中百分比
center object 检出的人脸框的中心点坐标, x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数)
eye_left object 相应人脸的左眼坐标,x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数)
eye_right object 相应人脸的右眼坐标,x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数)
mouth_left object 相应人脸的左侧嘴角坐标,x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数)
mouth_right object 相应人脸的右侧嘴角坐标,x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数)
nose object 相应人脸的鼻尖坐标,x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数)
attribute object 包含一系列人脸的属性分析结果
gender object 包含性别分析结果,value的值为Male/Female, confidence表示置信度
age object 包含年龄分析结果,value的值为一个非负整数表示估计的年龄, range表示估计年龄的正负区间
race object 包含人种分析结果,value的值为Asian/White/Black, confidence表示置信度

调用示例

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

JSON 示例

{
    "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"
}

错误列表

错误代码 HTTP 状态代码 错误信息
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