ShowAPI,自营为主的数据交易市场
立即注册

人脸识别 官方自营 免费使用

 

通过上传的照片,实现人物脸部的识别,通过分析后可以得到脸部的特征信息。根据特征,可以对人物进行识别,比较,分类。

浏览量: 62571

调用量: 17634

使用人数: 22866

¥ 0.00 元起

接入点说明:
相关文档:
接口地址: http://route.showapi.com/61-13 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
返回格式: json
请求方式: HTTP协议,支持GET/POST方法。
调用样式及调试工具: 测试工具

请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):展开收起
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_sign_method String md5 签名生成方式,其值可选为"md5"或"hmac"。如果不传入则默认"md5"。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数):
参数名称 类型 默认值 示例值 必须 描述
imgFile byte[]
上传的文件

返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
showapi_res_error String 用户输入有误! 错误信息的展示
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
face String
脸部信息,数组类型 包括了position\tag\face_id\attribute等,具体值请参考返回示例
position String
脸部特征信息
tag String
文字描述信息
face_id String
脸部信息唯一标识
attribute String
人物相关属性 如年龄 性别 人种等
flag String
true
操作是否成功
session_id String
本次请求的session值
img_id String
所上传的图片的唯一值
...

返回示例/ Return example

{
    "face": [
        {
            "position": {
                "center": {
                    "y": 42.56927,
                    "x": 25.465839
                },
                "mouth_left": {
                    "y": 49.765743,
                    "x": 22.312008
                },
                "mouth_right": {
                    "y": 49.691688,
                    "x": 29.093582
                },
                "height": 20.151134,
                "width": 16.563147,
                "eye_left": {
                    "y": 38.454408,
                    "x": 21.669358
                },
                "nose": {
                    "y": 43.553401,
                    "x": 25.416977
                },
                "eye_right": {
                    "y": 38.028463,
                    "x": 28.816356
                }
            },
            "tag": "",
            "face_id": "5c767a61e52a5fe37xxxxxxxxxxxxx",
            "attribute": {
                "age": {
                    "range": 9,
                    "value": 18
                },
                "gender": {
                    "value": "Male",
                    "confidence": 99.9272
                },
                "race": {
                    "value": "Asian",
                    "confidence": 94.7713
                },
                "smiling": {
                    "value": 2.45113
                }
            }
        },
        {
            "position": {
                "center": {
                    "y": 37.027708,
                    "x": 74.120083
                },
                "mouth_left": {
                    "y": 43.230479,
                    "x": 71.183437
                },
                "mouth_right": {
                    "y": 42.678086,
                    "x": 77.671014
                },
                "height": 18.639798,
                "width": 15.320911,
                "eye_left": {
                    "y": 33.506045,
                    "x": 70.297308
                },
                "nose": {
                    "y": 37.592443,
                    "x": 73.661905
                },
                "eye_right": {
                    "y": 32.967254,
                    "x": 77.557557
                }
            },
            "tag": "",
            "face_id": "74ac17fa2f0ef98320adxxxxxxxxxxx",
            "attribute": {
                "age": {
                    "range": 9,
                    "value": 31
                },
                "gender": {
                    "value": "Male",
                    "confidence": 69.2352
                },
                "race": {
                    "value": "Asian",
                    "confidence": 92.415
                },
                "smiling": {
                    "value": 15.9649
                }
            }
        }
    ],
    "session_id": "aa17febbd79f4fe880xxxxxxxx",
    "flag": true,
    "img_id": "051f21fd2c7e33cffe66a7xxxxxxxx",
    "response_code": 200,
    "img_height": 397,
    "img_width": 483
}