/info/get_face

描述

给定一组Face,返回相应的信息(包括源图片, 相关的person等等)。

参数

参数名 参数说明
必须 api_key App的Face++ API Key
api_secret APP的Face++ API Secret
face_id 一组用逗号分割的face_id

返回值说明

字段 类型 说明
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表示置信度
person array 包含该face的Person信息
faceset array 包含该face的faceset信息

调用示例

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

JSON 示例

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

错误列表

错误代码 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