如何使用Azure认知人脸API在JavaScript中验证两张人脸图像
Azure 认知服务人脸验证 API JavaScript 实现
请求体参数规则
人脸验证接口(/v1.0/verify)用于比对两个人脸的匹配度,请求体必须是合法JSON格式,常见的两张独立人脸验证场景下,需要传入两个提前从人脸检测接口获取的faceId,核心结构为:
- 必填字段:
faceId1:第一张人脸的唯一标识(从人脸检测接口返回值中获取)faceId2:第二张人脸的唯一标识(从人脸检测接口返回值中获取)
- 可选字段:
confidenceThreshold:匹配置信度阈值,取值范围0-1,低于该阈值会返回明确的不匹配判定
注意:该接口不支持直接在请求体中传入图像链接、图像二进制流,必须先将待验证的两张图像分别调用人脸检测接口,拿到对应
faceId后再发起验证请求。
可直接参考的完整代码示例
原示例代码存在几处需要修正的问题:
- 原代码中请求头的订阅密钥字段存在多余换行、空格,会导致鉴权失败
- 请求体位置写死占位符
{body},需要替换为序列化后的合法JSON字符串 - 缺少对返回结果的结构化解析
修正后的完整实现代码如下:
<!DOCTYPE html> <html> <head> <title>人脸验证示例</title> <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script> </head> <body> <script type="text/javascript"> $(function() { // 替换为你的实际配置 const SUBSCRIPTION_KEY = '你的Azure人脸服务订阅密钥'; // 替换为两个从人脸检测接口获取的faceId const faceIdFromImageA = '第一张图像检测返回的faceId'; const faceIdFromImageB = '第二张图像检测返回的faceId'; // 构造符合接口要求的请求体 const verifyRequestBody = { faceId1: faceIdFromImageA, faceId2: faceIdFromImageB }; $.ajax({ url: "https://westus.api.cognitive.microsoft.com/face/v1.0/verify", beforeSend: function(xhrObj){ xhrObj.setRequestHeader("Content-Type","application/json"); xhrObj.setRequestHeader("Ocp-Apim-Subscription-Key", SUBSCRIPTION_KEY); }, type: "POST", // 将JSON对象序列化为字符串作为请求体 data: JSON.stringify(verifyRequestBody) }) .done(function(res) { // 接口返回值结构: // isIdentical: 布尔值,标识两张人脸是否判定为同一人 // confidence: 0-1的浮点值,值越高代表两张人脸的匹配度越高 const matchTip = res.isIdentical ? `验证通过,匹配置信度 ${res.confidence.toFixed(2)}` : `验证不通过,匹配置信度 ${res.confidence.toFixed(2)}`; alert(matchTip); }) .fail(function(err) { alert(`请求出错:${err.responseText}`); }); }); </script> </body> </html>
落地注意事项
- 人脸检测接口返回的
faceId有24小时有效期,超时后需要重新检测图像获取新的faceId - 前端直接调用API会造成订阅密钥暴露,存在被盗用产生费用的风险,生产环境建议将请求代理到自有后端,由后端完成Azure接口的调用
- 若待验证的图像是本地文件,需要先将文件上传到可公网访问的地址,或调用支持二进制流输入的检测接口拿到
faceId后,再执行验证流程
内容的提问来源于stack exchange,提问作者James Mapa
相关产品推荐
相关产品推荐

