技能介绍

解决的问题

TencentCloud FaceID CompareFace 用于在已有两张图片时，快速判断是否为同一人。很多业务链路里，前端或 Agent 已经拿到证件照、活体截图或用户上传图，但缺少可解释的比对结果：到底应该返回“疑似同一人”还是“可认定为同一人”，以及相似度分数对应什么误识率。这个技能把腾讯云 CompareFace 接口封装成命令行调用，避免每次手写 API 签名、Base64 上传和版本参数。

如何工作

技能通过 scripts/main.py 发起 1:1 人脸比对。输入可以是本地图片路径、Base64 字符串或图片 URL；本地文件会自动转成 Base64，URL 参数优先级更高。核心参数包括：

--image-a / --url-a：A 图输入。
--image-b / --url-b：B 图输入。
--face-model-version：选择 2.0 或 3.0 算法版本，默认 3.0。
--quality-control：按低、一般、较高、很高过滤低质量图片。
--need-rotate-detection：开启旋转识别。

调用成功后返回 JSON，通常包含 0~100 的相似度分数。3.0 版本下，>=50 可作为推荐阈值；2.0 版本下，>=80 更适合作为认定阈值。多脸图片默认选取置信度最高的人脸，因此它更适合单张主体清晰的 1:1 验证场景。

适用边界

它不是人脸检测或 1:N 搜索接口，也不会识别姓名、证件号等身份信息。使用前需配置腾讯云 API 密钥，并控制图片格式、大小与分辨率：Base64 后不超过 5MB，JPG 长边不超过 4000 像素，其他格式长边不超过 2000 像素，短边不小于 64 像素。若图片模糊、遮挡、低分辨率或包含多人，结果可能不稳定，需要结合业务风控策略处理。