메인 콘텐츠로 건너뛰기
POST
/
liveness
Detect liveness in facial image
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"
}

Documentation Index

Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt

Use this file to discover all available pages before exploring further.

faceImage
string
필수
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: 얼굴 분석에 실패했습니다

인증

x-api-key
string
header
필수

API key essential for authentication and access control purposes, required for authorization.

본문

application/json
faceImage
string
필수

Face image in base64 format. Base64 encoded characters in the payload must not include the MIME type. For example, if the encoded base64 characters are "image/png;base64,/9j/2wBDABQODxIP...", then remove "image/png;base64," and send only the encoded data "/9j/2wBDABQODxIP...".

예시:

"{{faceImage_base64}}"

응답

Everything worked as expected.

apiType
string

API type

예시:

"id_live_face"

result
object
transactionId
string

Unique identifier for each request

예시:

"e0nvom3caiis7"