人脸核验

按 ID 对已注册人员进行 1:1 核验。

menu_bookAPI 参考：人脸核验（1:1）expand_more

官方文档（英文）： docs.verifik.co/biometrics/verify-face. 西班牙语： docs.verifik.co/verifik-es/verificar-cara.

基础 URL 为 https://api.verifik.co。在 id 中发送已注册人员的 MongoDB id，在 images 中发送一张或多张原始 base64 人脸图（无 data URL 前缀）。可选 collection_id 限定范围。

POST /v2/face-recognition/verify

针对已知已注册人员的 1:1：达到阈值时返回带分数的 data.match。

字段	值
Content-Type	application/json
Authorization	Bearer <token>

参数	必填	说明
id	是	已注册人员 MongoDB id
images	是	base64 人脸图像数组（同一主体）
min_score	是	匹配阈值（0.5–1）
search_mode	是	FAST 或 ACCURATE
collection_id	否	可选人脸库范围

await verifyFace(
  {
    id: "<personMongoId>",
    images: ["<base64>", "<base64>"],
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  },
  accessToken,
);