Face Recognition API
얼굴 인식 API
1:1 검증부터 1:N 식별, 라이브니스 탐지까지. 딥러닝 기반 벡터 검색으로 빠르고 정확한 얼굴 인식을 제공합니다.
API 엔드포인트
RESTful API 6종으로 모든 얼굴 인식 기능을 제공합니다.
얼굴 등록
POST
/face/register사용자 얼굴을 등록합니다. 인증 시 자동 증강으로 정확도가 지속 개선됩니다.
{
"userCode": "user_001",
"name": "홍길동",
"image": "base64..."
}1:1 검증
POST
/face/verify등록된 얼굴과 현재 얼굴을 비교합니다. 라이브니스 검사를 함께 수행할 수 있습니다.
{
"userCode": "user_001",
"image": "base64...",
"withLiveness": true
}1:N 식별
POST
/face/identifypgvector HNSW 벡터 검색으로 등록된 전체 사용자 중 가장 유사한 얼굴을 식별합니다.
{
"image": "base64...",
"withLiveness": true
}얼굴 비교
POST
/face/compare두 이미지의 얼굴을 직접 비교하여 유사도 점수를 반환합니다.
{
"image1": "base64...",
"image2": "base64..."
}얼굴 카운트
POST
/face/count이미지 내 얼굴 수와 위치(좌표)를 반환합니다.
{
"image": "base64..."
}삭제
DELETE
/face/{userCode}등록된 사용자의 얼굴 데이터를 삭제합니다.
핵심 기능
정확도와 성능을 높이는 고급 기능을 기본 제공합니다.
라이브니스 탐지
verify/identify 요청 시 딥페이크, 사진 공격, 마스크 위조를 실시간으로 탐지합니다.
자동 증강
인증 성공 시 템플릿을 자동 추가하여 헤어, 메이크업 변화에도 정확도를 유지합니다.
벡터 검색 (HNSW)
pgvector 기반 HNSW 인덱스로 대규모 사용자 풀에서도 빠른 1:N 식별이 가능합니다.