活体人脸核身

最近更新时间:2024-07-16 09:32:01

我的收藏

简介

本文档提供关于活体人脸核身的相关 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