检索人员

上传人脸图像，按相似度在人脸库中进行 1:N 检索。

menu_bookAPI 参考：人脸检索（1:N）expand_more

官方文档： docs.verifik.co/biometrics/search （人脸检索 — 以人脸图在已注册人员中检索）。

基础 URL 为 https://api.verifik.co。在 images 中发送同一主体的多张原始 base64 图（无 data URL 前缀）。可选 collection_id 限定范围。公开文档建议 1–3 张图以提高召回。

POST /v2/face-recognition/search

1:N 识别：按相似度分数返回候选人员排序。

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

参数	必填	说明
images	是	base64 人脸图像数组（同一人；建议最多约 3 张）
min_score	是	匹配阈值（例如 0.2–1.0）
search_mode	是	FAST 或 ACCURATE
collection_id	否	将检索限定在单个人脸库
max_results	否	返回匹配数量上限（省略则使用 API 默认）

await fetch("https://api.verifik.co/v2/face-recognition/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    images: ["<base64>", "<base64>"],
    collection_id: "<optionalCollectionMongoId>",
    min_score: 0.75,
    search_mode: "FAST",
  }),
});