You need to enable JavaScript to run this app. 如何使用Azure认知人脸API在JavaScript中验证两张人脸图像
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 17:54:00