活体检测

活体检测服务有两个步骤。

步骤 1：集成 Android SDK
步骤 2：请求活体检测获取活体分数

1 集成 SDK

Android

2 活体检测 V1

代码示例：

curl --location --request POST 'https://api.ekycpro.com/v1/picturelive' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-API-Key: AbcdEfgh' \
--data-urlencode 'img=BASE64_ENCODE_VALUE'

成功响应示例：

{
  "status": "OK",
  "message": {
    "live_score": 100
  }
}

成功响应示例（detail = 1）：

{
  "status": "OK",
  "message": {
    "is_liveness": true,
    "live_score": 100,
    "reason": "success"
  }
}

多个人脸示例（detail = 1）：

{
  "status": "OK",
  "message": {
    "is_liveness": false,
    "live_score": 0,
    "reason": "multiple faces"
  }
}

无活体人脸示例（detail = 1）：

{
  "status": "OK",
  "message": {
    "is_liveness": false,
    "live_score": 0,
    "reason": "no liveness face"
  }
}

闭眼示例（detail = 1）：

{
  "status": "OK",
  "message": {
    "is_liveness": false,
    "live_score": 0,
    "reason": "eyes closed"
  }
}

年龄不满意示例（detail = 1）：

{
  "status": "OK",
  "message": {
    "is_liveness": false,
    "live_score": 0,
    "reason": "age dissatisfaction"
  }
}

图像错误响应示例：

{
  "status": "FAIL",
  "message": "check input image and retry"
}

请求参数错误响应示例：

{
  "status": "INVALID_REQUEST",
  "message": "check request params"
}

图像格式错误响应示例：

{
  "status": "IMAGE_INVALID_FORMAT",
  "message": "image format not support"
}

图像超过 2M 错误响应示例：

{
  "status": "IMAGE_INVALID_SIZE",
  "message": "image larger than 2M"
}

服务器错误响应示例：

{
  "status": "INNER_ERROR",
  "message": "Inner error, please retry later"
}

请求 URL

POST https://api.ekycpro.com/v1/picturelive

请求参数：

参数	描述
`img`	`string`，Base64 编码的图像，来自实时视频的图片
`country`	`string`，国家缩写。墨西哥：MX，印度：IN，泰国：TH，印度尼西亚：ID
`detail`	`可选`，`string`，当 detail=1 时返回不通过的原因

默认响应描述：

参数	描述
`status`	状态码
`message`	`live_score`：活体检测分数[0-100]

详细响应描述

参数	描述
`status`	状态码
`message`	`is_liveness`：活体检测是否通过
`live_score`：活体分数[0-100]
`reason`：success、eyes closed、no liveness face、face incomplete、face dark、face blur、no face detected、multiple faces

状态码：

状态	消息
`OK`	`charge`，识别成功
`FAIL`	`charge`，图像错误
`INVALID_REQUEST`	`free`，请求参数错误
`IMAGE_INVALID_FORMAT`	`free`，不支持的图像格式，仅支持 PNG、JPG、JPEG、BMP 格式
`IMAGE_INVALID_SIZE`	`free`，图像大小应在 base64 编码后小于 2M
`INNER_ERROR`	`free`，系统错误