6.8 人脸识别:face_compare
功能描述
与已注册图片的 face_id 对比人脸相似度。
图片要求
图片格式 :PNG/JPG/JPEG
注册图尺寸:200*200,正脸注册,光照均匀
识别图尺寸:最小像素8080,最大像素19201920
请求地址
http://api.robotscloud.com/osr/v1/face_compare
请求方法
Post方法。
请求参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
token | String | 是 | 通过调用token接口返回 |
file | String | 是 | 需要检测的图片文件 |
face_id_list | String | 是 | 支持多个face_id, 用英文逗号分隔 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
ret | Int | 0:正常返回;非0时为错误值; |
msg | String | 描述 |
similaritys | Array | 数组结构 |
similaritys 数组的元素定义:
名称 | 类型 | 描述 |
---|---|---|
face_id | String | 系统中人脸的唯一标识 |
similarity | Array(Float) | 相似度 |
错误码
错误代码 | 描述 | 语义 |
---|---|---|
0 | 正确 | 无 |
非0 | 错误 | 详见 msg |
示例
请求示例
curl -X POST "http://api.robotscloud.com/osr/v1/face_compare" \
-F "token=qg9vRfvofK9b4xsWh1kHnEb998lQZYw" \
-F "file=@test.png" \
-F "face_id_list=123,124"
返回示例
{
"ret": 0,
"msg": "ok",
"similaritys": [
{
'face_id': '2m6wnsqkzi4frugpczfkpagyyr5inpsw',
'similarity': [
0.86477719914856488
]
},
{
'face_id': u'6fgv265zk4jxzctfdyjzjb8s796wypkm',
'similarity': [
0.86477719914856488
]
}
]
}