视频活体检测

上传人脸视频进行活体检测

  • 接口文档

    接口文档
  • 视频活体检测

  • 错误码
  • 错误码列表
  • 资源下载
  • 接口文档下载
视频活体检测
接口地址:http://apis.juhe.cn/face_vedio/verify
请求方式:http post
返回类型:json
接口描述:通过用户上传的视频检测是否为真人
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  videoBase64 string 用于活体检测的视频,视频的BASE64值;BASE64编码后的大小不超过8M,支持mp4、avi、flv格式。视频的 videoUrl、videoBase64必须提供一个,如果都提供,只使用 videoBase64。
  videoUrl string 用于活体检测的视频Url 地址。视频下载后经Base64编码不超过 8M,视频下载耗时不超过4S,支持mp4、avi、flv格式。视频的 videoUrl、videoBase64必须提供一个,如果都提供,只使用 videoBase64。
  livenessType string 活体检测类型,取值:0/1/2。
说明
0为静默模式
1为数字模式
2为动作模式
三种模式选择一种传入,不传默认为静默模式
  validateData string
说明
livenessType为1数字模式传参:传4位数字验证码
livenessType为2动作模式传参:传动作顺序(1,2或2,1),1代表张嘴,2代表闭眼
静默模式不用传
  bestBase64 int 是否需要返回视频最佳截图
说明
1:需要
其他或不传不返回
  bestFrameNum int 需要返回多张最佳截图,取值范围2-10,不传不返回

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i -d "key=key&videoBase64=&videoUrl=&livenessType=&validateData=&bestBase64=&bestFrameNum=" "http://apis.juhe.cn/face_vedio/verify"

返回参数说明:

名称 类型 说明
  error_code int 返回码(0,267509收费,其余不收费)
  reason string 返回说明
  result jsonObject 返回结果集
  orderid string 属result,聚合订单号
  res jsonObject 属result,只有传入betBase64或者bestFrameNum时且error_code为0时返回
  bestBase64 string 属res,只有传入参数bestBase64为1时返回,验证通过后的视频最佳截图照片,照片为BASE64编码后的值,jpg格。注意:此字段可能返回 null,表示取不到有效值。
  bestList array of string 属res,最佳截图列表,仅在传入bestFrameNum时返回结果,否则不返回。

JSON返回示例:JSON在线格式化工具 >

      {
    "reason": "成功",
    "result": {
        "orderid": "JH802241024100028TZko2",
        "bestBase64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBg...省略..."
	"bestList": [
	"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBg...省略...",
	"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBg...省略..."
        ]
    },
    "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明
  267549 视频录制时间过短,请录制2秒以上的视频
  280201 网络错误
  280202 videoBase64和videoUrl不可同时为空
  280206 请输入4位数字的数字验证码
  280207 请传入正确的动作顺序参数
  280208 其他错误
  280210 bestFrameNum取值在2-10范围内
  280219 未能检测到完整人脸
  280220 未检测到张嘴动作
  280223 解密失败
  280224 文件下载失败
  280225 文件下载超时
  280229 检测到多张人脸
  280231 未能检测到完整人脸
  280236 视频为空,或大小不合适,请控制录制时长在6s左右
  280237 视频格式有误
  280240 视频声音太小
  280241 声音识别失败
  280243 活体检测没通过
  280244 疑似非真人录制

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码
视频活体检测
0
申请次数
802
ID
0
收藏次数

推荐API

  • 活体人脸实名认证H5版

    本服务搭载真人检测和人脸比对等生物识别技术,配合权威数据源验证,可快速校验自然人的真实身份。支持PC和移动端H5网页接入。
  • 视频活体核验

    传入视频和身份信息,先判断视频中是否为真人,判断为真人后,再判断该视频中的人与公安权威库的证件照是否属于同一个人
  • 涉农贷款地址识别

    涉农贷款地址识别,支持对私和对公两种方式。输入地址的行政区划越完整,识别准确度越高。
  • 人脸四要素

    根据给定的手机号、姓名、身份证、人像图片核验是否一致
  • 个人/企业涉诉查询

    通过企业关键词查询企业涉讼详情,如裁判文书、开庭公告、执行公告、失信公告、案件流程等等。

API资讯

数 据 驱 动 未 来
Data Drives The Future
0512-88869195
数 据 驱 动 未 来
Data Drives The Future