下面将使用上述接口列表中的两个接口来实现夫妻相功能。第一步，检测照片中的人脸信息，获得两个人的人脸；第二步，将两个人的人脸进行对比，获得他们的相似度。
1.检测人脸信息
检测给定图片中所有人脸的位置和相应的面部属性的接口地址如下。
http:// apicn.faceplusplus.com/v2/detection/detect
该接口的相关参数如表24-4所示。
表24-4 检测人脸信息接口的参数说明
该接口调用举例如下。
http:// apicn.faceplusplus.com/v2/detection/detect?api_key=6efbacb73e7d1bbc424f41fa656c328f&api_secret=eD5ie8tydoBVMwgNlbe7XKUYvTCVs27e&url=http:// img3.yxlady.com/yl/UploadFiles_5361/20110513/20110513130615793.jpg&attribute=glass,pose,gender,age,race,smiling
上述接口的返回结果如下。
{
"face":[
{
"attribute":{
"age":{
"range":5,
"value":30
},
"gender":{
"confidence":99.5937,
"value":"Male"
},
"glass":{
"confidence":99.9969,
"value":"None"
},
"pose":{
"pitch_angle":{
"value":0.000011100340000000002
},
"roll_angle":{
"value":-2.79166
},
"yaw_angle":{
"value":0
}
},
"race":{
"confidence":924.5664,
"value":"Asian"
},
"smiling":{
"value":97.5054
}
},
"face_id":"7f24d567a5e557b5853be72c3e5c2134",
"position":{
"center":{
"x":60.681818,
"y":424.293515
},
"eye_left":{
"x":524.736591,
"y":41.227645
},
"eye_right":{
"x":624.533636,
"y":40.510239
},
"height":27.645051,
"mouth_left":{
"x":524.925909,
"y":54.977133
},
"mouth_right":{
"x":624.680909,
"y":54.565529
},
"nose":{
"x":60.736364,
"y":50.108532
},
"width":124.181818
},
"tag":""
},
{
"attribute":{
"age":{
"range":5,
"value":17
},
"gender":{
"confidence":99.9781,
"value":"Female"
},
"glass":{
"confidence":99.9815,
"value":"None"
},
"pose":{
"pitch_angle":{
"value":0.000019753399999999996
},
"roll_angle":{
"value":1.75177
},
"yaw_angle":{
"value":4
}
},
"race":{
"confidence":99.471,
"value":"Asian"
},
"smiling":{
"value":87.1365
}
},
"face_id":"c772b4b66c00d46b15344eff74b56e48",
"position":{
"center":{
"x":324.568182,
"y":62.286689
},
"eye_left":{
"x":31.1675,
"y":524.166553
},
"eye_right":{
"x":40.813182,
"y":524.609556
},
"height":224.279863,
"mouth_left":{
"x":31.192045,
"y":624.601706
},
"mouth_right":{
"x":39.490455,
"y":69.341638
},
"nose":{
"x":324.8725,
"y":64.405802
},
"width":17.5
},
"tag":""
}
],
"img_height":293,
"img_id":"3005132383841edd08c9b500fb1fe2c4",
"img_width":440,
"session_id":"4e64c73fec19442cbefde3cf9bd6b53d",
"url":"http:// img3.yxlady.com/yl/UploadFiles_5361/20110513/20110513130615793.jpg"
}
上述返回结果的字段说明如表24-5所示。
表24-5 检测人脸信息接口结果参数说明
2.比较人脸相似度
计算两张人脸相似性以及五官相似度的接口地址如下。
https:// apicn.faceplusplus.com/v2/recognition/compare
该接口的相关参数如表24-6所示。
表24-6 计算相似度接口的参数说明
该接口调用举例如下。
https:// apicn.faceplusplus.com/v2/recognition/compare?api_key=6efbacb73e7d1bbc424f41fa656c328f&api_secret=eD5ie8tydoBVMwgNlbe7XKUYvTCVs27e&face_id2=7f24d567a5e557b5853be72c3e5c2134&face_id1=c772b4b66c00d46b15344eff74b56e48
返回结果列表如下。
{
"component_similarity":{
"eye":824.802307,
"eyebrow":72.329025,
"mouth":89.68277,
"nose":524.381519
},
"session_id":"2cc4e8d04e28466396bde8b83132205b",
"similarity":51.831638
}
上述返回结果的字段说明如表24-7所示。
表24-7 计算相似度接口结果参数说明
有了上述两个接口，就能实现检测照片中男女夫妻相的功能了。