开始使用
参数名称 |
类型 |
是否必填 |
参数解释 |
备注 |
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 |
是 |
被验证人的身份证号码。 |
活体检测动作 |
动作示例 |
视频动作说明 |
|---|---|---|
左摇头 |
|
√，左摇头幅度正常。 |
|
×，左摇头幅度过大，超出画面。 |
|
|
×，左摇头幅度过大。 |
|
右摇头 |
|
√，右摇头幅度正常。 |
|
×，右摇头幅度过大，超出画面。 |
|
|
×，右摇头幅度过大。 |
|
点头 |
|
√，点头幅度正常。 |
|
×，点头幅度过大，超出画面。 |
|
|
×，点头幅度过大，检测不出人脸。 |
|
嘴部动作 |
|
正确，正常张闭嘴动作。 |
|
错误，嘴巴处于张开状态。 |
|
视频采集注意事项： 1、保证光线正常，不要出现背光、过亮或过暗等。 2、人脸需尽可能位于手机画面中央，不能太小或太大。 3、人脸尽可能与手机保持水平，避免过于仰视、俯视和侧视。 4、低头、左转或右转时，动作速度保持正常，不要过快或过慢，幅度不宜过大，整个动作过程中，人脸需要保证在手机画面中，不宜移出手机画面。 5、张嘴动作时，开始状态应处于合嘴状态，不宜处于张嘴或半张嘴状态。 6、整个动作期间，动作不宜太快和太慢，一个动作需在2~5秒内完成。不要出现突然动作，如突然转头、突然张大嘴等。 |
||
- 打开浏览器输入“https://www.huaweicloud.com”网址进入华为云官网，单击进入控制台
图1 进入华为云官网打开控制台
- 进入控制台页面后，在服务搜索中输入“API网关”进入
图2 进入API网关管理页面
- 单击共享版，进入共享版API网关管理页面
图3 单击进入共享版API网关管理页面
- 进入共享版API网关管理页面后，单击左侧导航栏“API管理”“API列表”单击已创建的API名称，进入对应API网关管理页面。
图4 进入对应API网关管理页面
- 单击调试，进入调试页面。
图5 准备调试
- 请求方法选择“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 ”被验证人的身份证号码，未传参。
