1
源图仅作参考2
目标图此处做活体3
分析源图 · 仅参考
源图作为人脸比对的 gallery 发送。
活体不使用源图。仅在下一步对目标图运行。
menu_bookAPI 参考:带活体的比对expand_more
官方文档: docs.verifik.co/biometrics/compare-with-liveness
POST /v2/face-recognition/compare-with-liveness
先比对;若人脸分数达到 compare_min_score(或省略),再对探针图按 liveness_min_score 运行活体。
| 字段 | 值 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
本演示中,源图为 gallery(第 1 步)。目标图为 probe(第 2 步)。您可选在浏览器中检测源图最大人脸并在发送前裁剪。目标图此处不裁剪。服务端集成也可通过 cropFace 等方式支持裁剪。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| probe | string | 是 | base64 实时采集 |
| gallery | string[] | 是 | 参考图像(base64;服务端支持 https URL) |
| liveness_min_score | number | 否 | 省略时默认 0.6 |
| compare_min_score | number | 否 | 0.67 至 0.95,可选阈值 |
// 200 OK, example response shape
{
"data": {
"comparison": { "score": 0.88 },
"liveness": {
"liveness_score": 0.91,
"min_score": 0.6,
"passed": true
}
}
}- 先运行比对;仅当比对通过您的阈值(或省略阈值)时,才对探针运行活体。
- 未发送时 liveness_min_score 默认为 0.6。
- gallery 可使用 https URL;服务会拉取并转换。