人脸识别服务 FRS-动作活体检测:请求参数

时间:2025-01-26 10:47:50

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

用于获取操作API的权限。获取方法请参见认证鉴权

Content-Type

String

发送的实体的MIME类型,参数值为“application/json”。

Enterprise-Project-Id

String

企业项目ID。FRS支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账,当前仅支持按需计费模式。

获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。

说明:

创建企业项目后,在传参时,有以下三类场景。

  • 携带正确的ID,正常使用FRS服务,账单归到企业ID对应的企业项目中。
  • 携带错误的ID,正常使用FRS服务,账单的企业项目会被分类为“未归集”。
  • 不携带ID,正常使用FRS服务,账单的企业项目会被分类为“default”。
表3 请求Body参数

参数名

是否必选

参数类型

说明

video_url

与video_file、video_base64三选一

String

视频的URL路径,目前仅支持华为云上OBS的URL,使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权

视频要求:
  • 视频Base64编码后大小不超过8MB,建议客户端压缩到200KB~2MB
  • 限制视频时长1~15秒。
  • 建议帧率10fps~30fps。
  • 封装格式:mp4、avi、flv、webm、asf、mov。
  • 视频编码格式: h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。

video_file

与video_url、video_base64三选一

File

本地视频文件。上传文件时,请求格式为multipart。视频要求:
  • 视频文件大小不超过8MB,建议客户端压缩到200KB~2MB
  • 限制视频时长1~15秒。
  • 建议帧率10fps~30fps。
  • 封装格式:mp4、avi、flv、webm、asf、mov。
  • 视频编码格式: h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。

video_base64

与video_file、video_url三选一

String

视频数据,Base64编码,要求:
  • Base64编码后大小不超过8MB,建议客户端压缩到200KB~2MB
  • 限制视频时长1~15秒。
  • 建议帧率10fps~30fps。
  • 封装格式:mp4、avi、flv、webm、asf、mov。
  • 视频编码格式: h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。

actions

String

动作代码顺序列表,英文逗号(,)分隔。建议单动作,目前支持的动作有:
  • 1:左摇头
  • 2:右摇头
  • 3:点头
  • 4:嘴部动作
  • 5:眨眼
说明:

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

左右摇头动作建议角度15-30度,嘴部动作建议张嘴距离大于3厘米。

action_time

String

该参数为动作时间数组拼接的字符串,数组的长度和actions的数量一致,每一项代表了对应次序动作的起始时间和结束时间,单位为距视频开始的毫秒数。

nod_threshold

double

该参数为点头动作幅度的判断门限,取值范围:[1,90],默认为10,单位为度。该值设置越大,则越难判断为点头。

support.huaweicloud.com/api-face/face_02_0100.html