活体检测
使用场景
对视频进行活体检测,并与头像做人脸对比,给出视频是否是活体及与证件照的人脸相似度的认证结果
服务返回信息的公共结构
参数名 | 类型 | 是否必有 | 说明 |
---|---|---|---|
signature | String | 是 | 我们采用的数字证书签名算法是:"RSA-SHA256" ,签名输出类型是:"base64" ,首先下载图普科技的公钥证书,然后按如下步骤认证:1、收到的JSON数据经过JSON.parse(),得到JSON对象,记为data; 2、data含两个字段:signature、json;signature是数字签名,json是真正的有效数据的字符串格式; 3、用signature对json进行签名认证,算法: RSA-SHA256 ,输出类型:base64 ,得到认证结果;4、认证通过后,对json进行JSON.parse(),得到JSON数据,详见"json"字段说明。 |
json | String | 是 | json 字段经过JSON.parse(json)后,得到具体的结果,含: message:与code相关的文本信息 timestamp:当前的服务器的Unix时间戳。 nonce:随机数。 |
json内容解析后的结构
参数名 | 类型 | 是否必有 | 说明 |
---|---|---|---|
code | Number | 是 | 请求的状态码,参考服务公共状态码解析 |
message | String | 是 | 请求的状态信息 |
timestamp | Number | 是 | 当前的服务器的Unix时间戳 |
nonce | Number | 是 | 随机数 |
[taskId] | Object | 是 | 识别任务的结果,不同识别任务会有特定的taskId和[taskId]信息结构 |
... | ... | 否 | 其它识别及请求响应结果信息 |
示例
{
"signature": "signature_from_tupu_service",
"json": "{\"code\":0,\"message\":\"success\",\"nonce\":\"0.5442530125172196\",\"timestamp\":1595318082309}"
}
任务结果信息
taskId
5c131f28153a11339add4a91
此接口特殊规定
- 每次请求只处理一组头像与视频认证。
- image字段按顺序区分图片类别,第一个图片是头像,其余是鉴别活体的视频图片组(最多30张,至少6张),文件大小超出 1MB 或 头像无效 或 视频图片数量过少都会返回异常;
响应结果
json字段信息
{
"5c131f28153a11339add4a91": {
"fileList": {
"name": "https://www.tuputech.com/test.jpg",
"label": 0,
"similarity": 0.9379766464233398, // 相似度
"review": false,
"tag": "tag_test"
}
},
"code": 0,
"message": "success",
"nonce": "0.24628431661924322",
"timestamp": 1523765333265
}