사람 검색

등록된 사람을 유사성(1:N)으로 검색하려면 얼굴 이미지를 업로드하세요.

menu_bookAPI 참조: 얼굴 검색(1:N)expand_more

공식 문서: docs.verifik.co/biometrics/search (얼굴 검색 - 등록된 사람을 대상으로 얼굴 이미지로 검색)

Base URL https://api.verifik.co. Send one or more raw base64 images of the same subject in images (no data URL prefix). Optionally scope with collection_id. The public docs recommend 1–3 images for better recall.

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	예	빠르고 정확함
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",
  }),
});