喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>
点击这里申请百度智能云特邀VIP帐号，立即体验人脸识别>>>
百度人脸识别使用指南-视频活体检测API文档
如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：
在百度云控制台内 提交工单，咨询问题类型请选择人工智能服务；
如有需要讨论的疑问，欢迎进入 AI社区 与其他开发者们一同交流。
一、视频活体检测
能力介绍
业务能力
视频活体检测产品，是由两个接口（视频活体检测+随机校验码）组合而成，可实现动作视频活体、数字视频活体两种活体检测方式。主要应用在H5场景下，通过用户新录制并上传一个视频，来进行活体检测的判断，同时比单张图片活体检测方式更加安全。其主要功能如下所示：
质量检测（可选）：判断图片中是否包含人脸，以及人脸在姿态、遮挡、模糊、光照等方面是否符合识别条件。
视频多帧活体检测：录制并上传的视频，会在云端进行随机抽帧分析，并得出最终的活体检测分数。
随机校验码：（用于在语音/动作活体检测中生成随机数字/动作）
为防止用户提交非当前操作的视频，选择随机验证码后，即可在录制视频时，随机生成数字/动作，用户需要读出数字/做出相应动作，在后续识别时校验，以判断视频是否为现场录制。
随机校验码作为辅助性质的验证条件，是一个可选项，可根据业务具体应用场景来选择是否使用，以及根据业务场景决定选择语音/动作活体检测方式。如业务场景比较嘈杂或方言口音比较重，可不使用语音活体检测方式，选择动作活体检测方式进行校验。
唇语识别Beta版：
对用户上传的视频进行唇语识别，返回唇语识别是否通过，返回结果为单独字段，与视频活体与语音/动作校验不冲突。
若需要使用唇语识别，需要先使用随机校验码和视频活体检测接口，且活体检测方式应配置为语音活体检测。
唇语识别能力当前为Beta版本，识别准确率较低，仅用于辅助 语音活体检测方式 进行验证，您可以通过接口的入参来设置是否使用该能力
合成图识别Beta版：
对用户上传的视频抽帧进行合成图像识别，能识别出AI变脸、AI换脸等合成图，让业务更加安全。
合成图识别能力当前为Beta版本，仅用于辅助验证，您可以通过接口的入参来设置是否使用该能力
以上四项能力，分为两个接口，使用顺序为随机校验码接口->视频活体检测接口，具体调用逻辑可以参考文档 接口文档
主要适用场景
微信服务号：用于对操作用户真实性要求严格的场景，用于依托于微信服务号的金融开户、实名认证、账户信息变更二次验证等服务。
APP内Webview：对于如Cordova架构开发的APP，或者APP内变更频繁的身份信息页等情况，可以采用此方案完成活体检测。
浏览器：如果仅是一个H5宣传页，或者Wap版本网页等，可以通过此方法快速集成更加安全的活体检测功能。
此方案的优劣势
优势：相对于APP有动作校验、单张图片静默判断，此方法在没有APP情况下，可以更快速、轻量级地实现活体检测，同时保障一定安全性。
劣势：由于视频较大，上传时间可能较长，另由于不同手机的浏览器内核差异较大，容易出现兼容性问题。
调用方式
请求URL数据格式
向API服务地址使用POST发送请求，必须在URL中带上参数access_token，可通过后台的API Key和Secret Key生成，具体方式请参考“Access Token获取”。
示例代码
#!/bin/bash curl -i -k 'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=【百度云应用的AK】&client_secret=【百度云应用的SK】'
注意：access_token的有效期为30天，切记需要每30天进行定期更换，或者每次请求都拉取新token；
例如此接口，使用HTTPS POST发送：
https://aip.baidubce.com/rest/2.0/face/v1/merge?access_token=24.f9ba9c5341b67688ab4added8bc91dec.2592000.1485570332.282335-8574074
POST中Body的参数，按照下方请求参数说明选择即可。
提示：如果您为百度云老用户，正在使用其他非AI的服务，可以参考百度云AKSK鉴权方式发送请求，虽然请求方式和鉴权方法和本文所介绍的不同，但请求参数和返回结果一致。
1.1 随机校验码接口（原语音验证码接口）
接口描述
此接口主要用于生成随机码，用于视频的语音/动作识别校验使用，以判断视频的即时性，而非事先录制的，提升作弊的难度。
在线调试
您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP方法：POST
请求URL： https://aip.baidubce.com/rest/2.0/face/v1/faceliveness/sessioncode
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header：
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数，参数详情如下：
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| type | 否 | int | 0为语音验证和唇语验证步骤， 1为视频动作活体 默认0 |
| min_code_length | 否 | int | 当type=0时，语音和唇语生成的验证码最小长度：最大6 最小3 默认3 当type=1时，视频动作活体 的验证码最小长度：最大3 最小1 默认1 |
| max_code_length | 否 | int | 当type=0时，语音和唇语生成的验证码最大长度：最大6 最小3 默认6 当type=1时，视频动作活体 的验证码最大长度：最大3 最小1 默认3 |
说明：
当传参为1-1-3时，代表随机生成1-3个动作进行核验；
当传参为1-1-1时，代表随机生成1个动作进行核验；
当传参为1-2-2时，代表随机生成2个动作进行核验；
当传参为1-3-3时，代表随机生成3个动作进行核验。
返回说明
返回参数
| 字段 | 必选 | 类型 | 说明 |
|---|---|---|---|
| session_id | 是 | string | 随机校验码会话id，有效期5分钟，请提示用户在五分钟内完成全部操作 验证码使用过即失效，每次使用视频活体前请重新拉取验证码 |
| code | 是 | string | 随机验证码，数字形式，1~6位数字； 若为动作活体时，返回数字表示的动作对应关系为：0:眨眼 4:抬头 5:低头 7:左右转头（不区分先后顺序，分别向左和向右转头），注：『7：左右转头』为2022年4月底上线的新动作，此后接入的新客户默认开放该动作，老客户默认不触发该动作，可提交工单要求配置触发 |
返回示例
{
"err_no": 0,
"err_msg": "SUCCESS",
"result": {
"session_id": "S59faeeebb9111890355690", //会话ID
"code": "045" //当为视频动作活体时，返回值的代表所需动作和动作顺序。 0:眨眼 4:抬头 5:低头
},
"timestamp": 1509617387,
"cached": 0,
"serverlogid": "0587756642",
"error_code": 0,
"error_message": "SUCCESS"
}error_code为0即代表成功, 其他情况则为失败
1.2 视频活体检测接口
接口描述
此接口一方面通过随机验证码接口获取语音/动作校验码，通过session code来判断视频是否作弊。另一方面进行视频抽帧，判断是否为活体。
在线调试
您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP方法：POST
请求URL： https://aip.baidubce.com/rest/2.0/face/v1/faceliveness/verify
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header：
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数，参数详情如下：
请求参数
湘公网安备43019002001857号
备案号：
客服1 