简介
本文档提供关于活体人脸核身的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
活体人脸核身 |
活体人脸核身
功能说明
集成了活体检测和跟权威库进行比对的能力，传入一段视频和姓名、身份证号信息即可进行验证。对录制的自拍视频进行活体检测，从而确认当前用户为真人，可防止照片、视频、静态3D建模等各种不同类型的攻击。检测为真人后，再判断该视频中的人与权威库的证件照是否属于同一个人，实现用户身份信息核实。
示例代码
def cos_liveness_recognition():# 活体人脸核身response, data = client.cos_liveness_recognition( Bucket=bucket_name, ObjectKey="objectKey", IdCard="123456", Name="测试", LivenessType="LIP", ValidateData="1234", BestFrameNum=5 )print(response)print(data)return response, data
参数说明
调用 cos_liveness_recognition 函数，具体请求参数如下：
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 存储桶名称 | String | 是 |
ObjectKey | 设置对象名称 | String | 是 |
IdCard | 身份证号 | String | 是 |
Name | 姓名。中文请使用 UTF-8编码 | String | 是 |
LivenessType | 活体检测类型，取值：LIP/ACTION/SILENT LIP 为数字模式，ACTION 为动作模式，SILENT 为静默模式，三种模式选择一种传入 | String | 是 |
ValidateData | 数字模式传参：数字验证码（1234），需先调用接口获取数字验证码 动作模式传参：传动作顺序（2，1 or 1，2），需先调用接口获取动作顺序 静默模式传参：空 | String | 否 |
BestFrameNum | 需要返回多张最佳截图，取值范围1 - 10，不设置默认返回一张最佳截图 | Integer | 否 |
返回结果说明
response 为响应头，data 为活体人脸核身结果，数据类型都为 dict。
response内容
响应体data
响应体具体数据内容如下：
参数名称 | 参数描述 | 类型 |
BestFrameBase64 | 验证通过后的视频最佳截图照片，照片为 BASE64 编码后的值，JPG 格式 注意：此字段可能返回 null，表示取不到有效值 | String |
Sim | 相似度，取值范围 [0.00, 100.00]。推荐相似度大于等于70时可判断为同一人，可根据具体场景自行调整阈值（阈值70的误通过率为千分之一，阈值80的误通过率是万分之一） 检测成功返回 | float |
BestFrameList | 最佳截图列表，仅在配置了返回多张最佳截图时返回 注意：此字段可能返回 null，表示取不到有效值 | String Array |
