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
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…”.
​
apiType
string
API type identifier for the liveness detection service.
​
result.liveness_score
number
Liveness score indicating the probability of a live person (0-100). Higher scores indicate higher confidence that the image is from a live person.
​
transactionId
string
Unique identifier for each request, useful for tracking and debugging purposes.
​
message
string
Information message returned as part of the recognition response, providing additional context about the result.
​
errorCode
number
Identifies the specific error for troubleshooting. Common error codes include:
  • 1016: faceImage is required
  • 1017: Fail to analyze face

Authorizations

​
x-api-key
string
header
required

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

Body

application/json
​
faceImage
string
required

base64 형식의 얼굴 이미지. 페이로드의 base64 인코딩된 문자에는 MIME 타입을 포함하지 않아야 합니다. 예를 들어, 인코딩된 base64 문자가 "image/png;base64,/9j/2wBDABQODxIP..."인 경우 "image/png;base64,"를 제거하고 인코딩된 데이터 "/9j/2wBDABQODxIP..."만 전송하세요.

Example:

"{{faceImage_base64}}"

Response

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

​
apiType
string

API 타입

Example:

"id_live_face"

​
result
object
​
transactionId
string

각 요청에 대한 고유 식별자

Example:

"e0nvom3caiis7"