얼굴 감지
경계 상자와 점수를 사용하여 이미지에서 얼굴을 찾습니다(Verifik 감지 파이프라인).
menu_bookAPI 참조: 얼굴 감지expand_more
공식 문서: docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (얼굴 감지 개요, 샘플 페이로드 및 응답 형태)
이 데모는 현재 API 검증에서 요구하는 min_score 및 search_mode를 사용하여 동일한 POST /v2/face-recognition/detect 경로를 호출합니다. 선택적 collection_id 및 max_results는 클라이언트에서 지원되지만 아래 형식으로 노출되지 않습니다.
POST /v2/face-recognition/detect
감지된 얼굴을 형상 및 점수와 함께 반환합니다. 게시된 얼굴 감지 가이드에는 지원되는 경우 return_landmarks와 같은 선택적 플래그도 문서화되어 있습니다.
| 헤더 | 값 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| 매개변수 | 요청 | 설명 |
|---|---|---|
| image | 예 | Base64 프로브 이미지(API당 원시 base64 또는 데이터 URI) |
| min_score | 예 | 임계값, 일반적으로 0.5-1 |
| search_mode | 예 | 빠르고 정확함 |
| collection_id | 아니요 | 선택적 범위(이 데모 UI에서는 사용되지 않음) |
| max_results | 아니요 | 선택적 한도(이 데모 UI에서는 사용되지 않음) |
await fetch("https://api.verifik.co/v2/face-recognition/detect", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
image: "<base64>",
min_score: 0.75,
search_mode: "FAST",
}),
});- 이 데모에서는 세션 토큰과 함께 @humanauthn/api-client의 discoverFace를 사용합니다.
- 캡쳐 후 1:N 식별을 위해서는 관련 문서에서 얼굴 검색 또는 실시간 얼굴 검색을 이용하세요.
menu_book
관련 문서
docs.verifik.co 공식 가이드