POST
/
liveness
얼굴 이미지에서 실시간 감지
curl --request POST \
  --url https://idverify-api.argosidentity.com/modules/liveness \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "faceImage": "{{faceImage_base64}}"
}'
{
  "apiType": "id_live_face",
  "result": {
    "liveness_score": 95
  },
  "transactionId": "e0nvom3caiis7"
}
​
faceImage
string
required
base64 형식의 얼굴 이미지. 페이로드의 base64 인코딩된 문자에는 MIME 타입을 포함하지 않아야 합니다. 예를 들어, 인코딩된 base64 문자가 “image/png;base64,/9j/2wBDABQODxIP…”인 경우 “image/png;base64,“를 제거하고 인코딩된 데이터 “/9j/2wBDABQODxIP…”만 전송하세요.
​
apiType
string
실시간 감지 서비스의 API 타입 식별자.
​
result.liveness_score
number
살아있는 사람의 확률을 나타내는 실시간 점수 (0-100). 높은 점수는 이미지가 살아있는 사람으로부터 온 것일 가능성이 높음을 나타냅니다.
​
transactionId
string
각 요청에 대한 고유 식별자로, 추적 및 디버깅 목적으로 유용합니다.
​
message
string
인식 응답의 일부로 반환되는 정보 메시지로, 결과에 대한 추가 컨텍스트를 제공합니다.
​
errorCode
number
문제 해결을 위한 특정 오류를 식별합니다. 일반적인 오류 코드는 다음과 같습니다:
  • 1016: faceImage가 필요합니다
  • 1017: 얼굴 분석에 실패했습니다

Authorizations

​
x-api-key
string
header
required

인증 및 접근 제어 목적으로 필수적인 API 키, 권한 부여에 필요합니다.

Body

application/json

Response

200
application/json

모든 것이 예상대로 작동했습니다.

The response is of type object.