Face Recognize

Body Params

image

file

required

Multipart form 메시지, 이름 image 로 파일 형태로 전달(자바의 경우 MulipartFile)

Headers

app-id

string

required

Defaults to AWA57KSRXT

마이페이지>앱>앱키(appKey) 탭에서 확인 가능

group-id

string

required

Defaults to 4NG7RZZNTG

조회 대상 group-id

appKey

string

required

마이페이지>앱>앱키(appKey) 탭에서 확인 가능

multi

int32

0: Default, 가장 대표적인 하나의 결과를 return
1: 사진 속 모든 얼굴에 대한 얼굴인식 결과를 return

threshold

float

threshold : 0 인 경우 동일인물, 1 인 경우 다른 인물에 가까움
Default : 0.32
특정 Site 마다 threshold 를 조절하여 precision, recall tuning 가능
threshold 가 작은 값일수록 precision이 높아지지만, recall 이 낮아짐
threshold 가 높은 값일수록 precision이 낮아지지만, recall 이 높아짐(다양한 얼굴의 variation 인식이 필요한 경우 조절)

request-id

string

호출하는 쪽에서 현재 요청하는 transaction id 를 설정하면, 결과 리턴 시에 request-id 값이 포함되어 리턴됨

key

string

이미지를 암호화하여 전달할 경우 해당 키 값을 전달해야 함. 키 값은 호출하는 쪽에서 AES-128 로 생성하고 이 키를 /api/v1/key 에서 얻어온 Public key 로 암호화 하여 전송

use-spoof

string

헤당 헤더가 존재할 경우, Face Anti Spoofing 엔진이 얼굴 등록 시 동작함(값은 관계 없음)
위변조 영상이 입력으로 들어오면 에러 코드를 리턴

xxxxxxxxxx
curl --request POST \
     --url https://apis.openapi.sk.com/nugufacecan/v1/recognize \
     --header 'accept: application/json' \
     --header 'app-id: AWA57KSRXT' \
     --header 'appKey: e8wHh2tya84M88aReEpXCa5XTQf3xgo01aZG39k5' \
     --header 'content-type: application/json' \
     --header 'group-id: 4NG7RZZNTG'

200200

400400