活体检索人员

对单张探针图做活体，然后进行 1:N 人脸检索（实时）。

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

官方文档： docs.verifik.co/biometrics/search-live-face （对探针图做活体，然后进行 1:N 检索）。

基础 URL 为 https://api.verifik.co。在 image 中发送单张原始 base64 探针图（无 data URL 前缀），必填 os（ANDROID、IOS 或 DESKTOP）、活体与匹配阈值，以及 search_mode。本演示使用 DESKTOP。

POST /v2/face-recognition/search-live-face

先运行防伪/活体；通过后对已注册人脸进行相似度检索。

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

参数	必填	说明
image	是	单张 base64 探针图
os	是	ANDROID、IOS 或 DESKTOP
liveness_min_score	是	活体阈值（0.5–1.0）
min_score	是	匹配阈值（文档为 0.5–1.0）
search_mode	是	FAST 或 ACCURATE
collection_id	否	将检索限定在单个人脸库

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