# 开始使用 表1参数填写说明 | 参数名称 | 类型 | 是否必填 | 参数解释 | 备注 | |---|---|---|---|---| | actions | String | 是 | 动作代码顺序列表,英文逗号(,)分隔。建议单动作,目前支持的动作有: 1:左摇头 2:右摇头 3:点头 4:嘴部动作（视频录制详见 [表2 动作活体视频采集说明]） 仅当actions的传参顺序和视频中的动作顺序一致时返回true。例如，视频中人物动作顺序为点头、嘴部动作，传参顺序需为3,4。 | 如果上传视频动作顺序与填写动作顺序不一致时，活体检测服务校验失败，服务终止。 | | video_url | String | 是 | 视频的URL路径,目前仅支持华为云上OBS的URL,且人脸识别服务有权限读取该OBS桶的数据。 开通读取权限的操作请参见[服务授权](https://support.huaweicloud.com/api-face/face_02_0006.html)。 视频要求: 视频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动作活体视频采集说明 | 活体检测动作 | 动作示例 | 视频动作说明 | |:---|:---|:---| | 左摇头 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001398786157.png) | √，左摇头幅度正常。 | | 左摇头 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348306016.png) | ×，左摇头幅度过大，超出画面。 | | 左摇头 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348465952.png) | ×，左摇头幅度过大。 | | 右摇头 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348146384.png) | √，右摇头幅度正常。 | | 右摇头 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001398985681.png) | ×，右摇头幅度过大，超出画面。 | | 右摇头 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348465956.png) | ×，右摇头幅度过大。 | | 点头 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348625920.png) | √，点头幅度正常。 | | 点头 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348306024.png) | ×，点头幅度过大，超出画面。 | | 点头 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001398985697.png) | ×，点头幅度过大，检测不出人脸。 | | 嘴部动作 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001398945701.png) | 正确，正常张闭嘴动作。 | | 嘴部动作 | ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001398786165.png) | 错误，嘴巴处于张开状态。 | | 视频采集注意事项： 1、保证光线**正常** ，不要出现**背光** 、**过亮或过暗**等。 2、人脸需尽可能位于手机画面**中央** ，不能**太小** 或**太大**。 3、人脸尽可能与手机**保持水平** ，避免过于**仰视、俯视和侧视**。 4、低头、左转或右转时，动作速度保持正常，不要**过快或过慢，幅度不宜过大** ，整个动作过程中，人脸需要保证在手机画面中，不宜**移出手机画面**。 5、张嘴动作时，开始状态应处于合嘴状态，不宜处于**张嘴** 或**半张嘴**状态。 6、整个动作期间，动作不宜太快和太慢，一个动作需在**2\~5** **秒** 内完成。不要出现**突然动作** ，如**突然转头、突然张大嘴**等。 ||| 1. 打开浏览器输入""网址进入华为云官网，单击进入控制台 图1进入华为云官网打开控制台 ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001398945713.png) 2. 进入控制台页面后，在服务搜索中输入"API网关"进入 图2进入API网关管理页面 ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001398705829.png) 3. 单击共享版，进入共享版API网关管理页面 图3单击进入共享版API网关管理页面 ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001398729713.png) 4. 进入共享版API网关管理页面后，单击左侧导航栏"API管理""API列表"单击已创建的API名称，进入对应API网关管理页面。 图4进入对应API网关管理页面 ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348146392.png) 5. 单击调试，进入调试页面。 图5准备调试 ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348465944.png) 6. 请求方法选择"GET"在查询参数中输入对应参数键和值（[详见 表1 参数填写说明]），单击发起请求，即可看到对应的响应结果。 图6开始调试 ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348146380.png) ![](https://support.huaweicloud.com/sidv-aislt/zh-cn_image_0000001348146388.png) 表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 "被验证人的身份证号码，未传参。 |