活体创建人员

带活体创建人员

在一次调用中完成注册、活体校验与去重检索。

menu_bookAPI 参考：带活体创建人员expand_more

官方文档（英文）： docs.verifik.co/resources/create-a-person-with-liveness

文档（西班牙语）： docs.verifik.co/verifik-es/resources/personas/crear-una-persona-con-deteccion-de-vida

基础 URL 为 https://api.verifik.co。发送包含档案字段、单个 collection_id（collection _id）、活体与检索阈值，以及 images 中每项至少一张 base64 人脸图（无 data URL 前缀）的 JSON。

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

对提交的人脸运行活体，检索相似注册，然后在目标人脸库中创建或更新人员。

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

参数	必填	说明
name	是	显示名称
images	是	base64 人脸图像数组（原始 base64，非 data URL）
gender	是	M 或 F
date_of_birth	是	YYYY-MM-DD
collection_id	是	单个人脸库唯一 id
liveness_min_score	是	0.5–1
min_score	是	内部检索阈值，0.5–1
search_mode	是	FAST 或 ACCURATE
nationality	否	可选

await fetch("https://api.verifik.co/v2/face-recognition/persons/search-live-face", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    name: "Jane Doe",
    gender: "F",
    date_of_birth: "1990-01-15",
    collection_id: "<collectionMongoId>",
    liveness_min_score: 0.65,
    min_score: 0.8,
    search_mode: "FAST",
    nationality: "CO",
    images: ["<base64>", "<base64>"],
  }),
});