唇语活体检测
接口描述
唇语识别通过唇部的动作来解读、校验数字验证码来验证是否为真人。 该接口用于第三方系统先从平台获取唇语的数字验证码内容和令牌,之后进行APP的唇语视频录制,再将唇语录制的视频,唇语的数字验证,以及令牌,和视频的类型上传到平台进行活体验证
请求说明
HTTP 方法:
POST
请求 URL:
/ai-cloud-cweis/lip/lipreading
Header如下:
参数名称 | 值 |
Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
获取唇语数字码和令牌Token:
参数名称 | 数据类型 | 参数描述 |
len | int | 唇语数字码长度 |
唇语活体验证:
参数名称 | 数据类型 | 必填 | 参数描述 |
appKey | String | Y | 应用生成的appkey |
sign | String | Y | 签名 |
nonceStr | String | Y | 随机字符串 |
video | String | Y | 唇语视频base64编码内容 |
token | String | Y | 唇语令牌token |
label | String | Y | 唇语数字码内容 |
type | String | Y | 唇语视频类型如mp4等 |
busFlowId | String(1,64) | N | 业务流水号,业务系统唯一序列号(对账用,建议传入) |
返回说明
返回参数:
获取唇语数字码和令牌Token:
返回值名称 | 类型 | 描述 |
---|---|---|
code | int | 返回码,0成功,非0失败 |
data | object | 返回的数据 |
message | String | 返回码描述 |
token | String | 唇语令牌token |
label | String | 唇语数字码 |
唇语活体验证:
返回值名称 | 类型 | 描述 |
---|---|---|
code | int | 返回码,0成功,非0失败 |
data | object | 返回的数据 |
message | String | 返回码描述 |
code | int | 0为正确并且有最佳人脸照片,非 0为对应错误码 |
faceImage | String | 唇语最佳人脸照片base64编码, code为0时,会返回该值 |
errorInfo | String | 错误信息 |
flowId | bigint | 交易流水ID,建议保存 |
返回示例:
{
"code": 0,
"message": "请求成功",
"data": {
"errorInfo": null,
"faceImage": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCg",
"code": 0
}
}
`