更新时间:2023-12-08 GMT+08:00
分享

开始使用

表1 参数填写说明

参数名称

类型

是否必填

参数解释

备注

actions

String

动作代码顺序列表,英文逗号(,)分隔。建议单动作,目前支持的动作有: 1:左摇头 2:右摇头 3:点头 4:嘴部动作(视频录制详见 表2 动作活体视频采集说明

仅当actions的传参顺序和视频中的动作顺序一致时返回true。例如,视频中人物动作顺序为点头、嘴部动作,传参顺序需为3,4。

如果上传视频动作顺序与填写动作顺序不一致时,活体检测服务校验失败,服务终止。

video_url

String

视频的URL路径,目前仅支持华为云上OBS的URL,且人脸识别服务有权限读取该OBS桶的数据。 开通读取权限的操作请参见服务授权

视频要求: 视频Base64编码后大小不超过8MB。 限制视频时长1~15秒。

建议帧率10fps~30fps。

封装格式:mp4、avi、flv、webm、asf、mov。 视频编码格式: h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。

格式:https://访问域名/文件名(带后缀)

verification_name

String

被验证人的姓名。

  

verification_id

String

被验证人的身份证号码。

  
表2 动作活体视频采集说明

活体检测动作

动作示例

视频动作说明

左摇头

√,左摇头幅度正常。

×,左摇头幅度过大,超出画面。

×,左摇头幅度过大。

右摇头

√,右摇头幅度正常。

×,右摇头幅度过大,超出画面。

×,右摇头幅度过大。

点头

√,点头幅度正常。

×,点头幅度过大,超出画面。

×,点头幅度过大,检测不出人脸。

嘴部动作

正确,正常张闭嘴动作。

错误,嘴巴处于张开状态。

视频采集注意事项:

1、保证光线正常,不要出现背光过亮或过暗等。

2、人脸需尽可能位于手机画面中央,不能太小太大

3、人脸尽可能与手机保持水平,避免过于仰视、俯视和侧视

4、低头、左转或右转时,动作速度保持正常,不要过快或过慢,幅度不宜过大,整个动作过程中,人脸需要保证在手机画面中,不宜移出手机画面

5、张嘴动作时,开始状态应处于合嘴状态,不宜处于张嘴半张嘴状态。

6、整个动作期间,动作不宜太快和太慢,一个动作需在2~5内完成。不要出现突然动作,如突然转头、突然张大嘴等。

  1. 打开浏览器输入“https://www.huaweicloud.com”网址进入华为云官网,单击进入控制台

    图1 进入华为云官网打开控制台

  1. 进入控制台页面后,在服务搜索中输入“API网关”进入

    图2 进入API网关管理页面

  1. 单击共享版,进入共享版API网关管理页面

    图3 单击进入共享版API网关管理页面

  2. 进入共享版API网关管理页面后,单击左侧导航栏“API管理”“API列表”单击已创建的API名称,进入对应API网关管理页面。

    图4 进入对应API网关管理页面

  3. 单击调试,进入调试页面。

    图5 准备调试

  4. 请求方法选择“GET”在查询参数中输入对应参数键和值(详见 表1 参数填写说明),单击发起请求,即可看到对应的响应结果。

    图6 开始调试

    表3 请求响应说明

    响应示例

    响应说明

    [{'meta': {'uuid': '2022-05-16T09:57:00.539597'}, 'result': {'service_name': 'ivs-standard', 'count': 1, 'resp_data': [{'verification_result': 'valid', 'verification_message': 'Successful certification', 'verification_code': 1000, 'similarity': '94'}]}}, {'video-result': {'alive': True, 'actions': [{'action': 2, 'confidence': 0.9420696496963501}, {'action': 1, 'confidence': 0.918700635433197}, {'action': 3, 'confidence': 0.9200282096862793}], 'picture': '/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsKCwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFB...'}'warning-list': []}]

    成功响应。

    Failed to invoke the FRS service

    活体检测服务调用失败,需检查“video_url”视频路径和“actions”动作参数是否输入正确。

    living body verification failed

    人脸识别活体检测服务校验未通过,服务终止。

    Failed to invoke the IVS service

    人证核身服务调用失败,需检查“verification_name”姓名和“verification_id”身份证号参数是否输入正确。

    Failed to verify the certificate of the applicant

    人证核身服务校验未通过,服务终止。

    video_url or actions not obtained

    “video_url ”视频的URL路径,或者 “actions ”动作代码顺序列表,未传参。

    verification_name or verification_id not obtained

    “verification_name ”被验证人的姓名,或者“verification_id ”被验证人的身份证号码,未传参。

相关文档