실시간 사람 검색

실시간 인물 검색

하나의 프로브 이미지에 활성을 부여한 후 1:N 얼굴 검색(라이브)을 수행합니다.

menu_bookAPI 참고자료: 얼굴 검색 1:N (라이브)expand_more

공식 문서: docs.verifik.co/biometrics/search-live-face (프로브 이미지의 활성 상태를 확인한 후 1:N 검색).

Base URL https://api.verifik.co. Send a single raw base64 probe in image (no data URL prefix), required os (ANDROID, IOS, or DESKTOP), liveness and match thresholds, and search_mode. This demo uses DESKTOP.

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

스푸핑 방지/활성화를 먼저 실행합니다. 통과하면 등록된 얼굴에 대해 유사성 검색을 수행합니다.

헤더	값
Content-Type	application/json
Authorization	Bearer <token>

매개변수	요청	설명
image	예	단일 base64 프로브 이미지
os	예	안드로이드, IOS, 데스크탑
liveness_min_score	예	활성 임계값(0.5–1.0)
min_score	예	일치 임계값(문서당 0.5~1.0)
search_mode	예	빠르고 정확함
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>",
  }),
});