활성 사용자 검색

활성 사용자 검색

활성 사용자 및 세션 스타일 흐름(단일 프로브 이미지)을 위한 활성 없는 1:N 얼굴 검색입니다.

menu_bookAPI 참조: 얼굴 검색 1:N(활성 사용자)expand_more

공식 문서: docs.verifik.co/biometrics/search-active-user (활성성 없는 1:N 검색 - 활성 사용자/세션 흐름).

Base URL https://api.verifik.co. Send one raw base64 probe in image, required os (ANDROID, IOS, or DESKTOP), plus min_score and search_mode. This demo uses DESKTOP.

POST /v2/face-recognition/search-active-user

실시간 검색과 유사하지만 활성 게이트가 없습니다. 사용자가 이미 인증되었거나 신뢰할 수 있는 세션에 있을 때 사용합니다.

헤더
Content-Typeapplication/json
AuthorizationBearer <token>
매개변수요청설명
image단일 base64 프로브 이미지
os안드로이드, IOS, 데스크탑
min_score일치 임계값(0.5–1.0)
search_mode빠르고 정확함
collection_id아니요하나의 컬렉션으로 검색 범위 지정
await fetch("https://api.verifik.co/v2/face-recognition/search-active-user", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    image: "<base64>",
    os: "DESKTOP",
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  }),
});
  • 이 데모에서는 세션 토큰과 함께 @humanauthn/api-client의 searchActiveUser를 사용합니다.
  • 활성도 + 1:N의 경우 대신 search-live-face를 사용하세요(문서에서 Face Search 1:N Live 참조).
menu_book

docs.verifik.co 공식 가이드