AllParam

project_id

String

项目ID，获取方法请参见获取项目ID/账号名/AK/SK。

image_url

String

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

image_file

File

本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。

image_base64

String

similarity

Double

人脸相似度，1表示最大，0表示最小，值越大表示越相似。一般情况下超过0.93即可认为是同一个人。

face_set_name

String

人脸库名称，1位到64位之间，可以包含字母、数字、中划线或者下划线，不能包含其他的特殊字符。

face_set_capacity

Integer

人脸库最大的容量，填写1万整数倍的数字，例如30000。默认为100000，最大值为100000，可通过创建新的人脸库进行扩容，每个用户可使用10个人脸库，每个人脸库容量为10万个人脸特征。如需扩容单个人脸库规模，请联系华为云客服确认扩容规模与价格。

face_id

String

导入人脸时，系统返回的人脸编号，为8个随机生成的大小写字母组成。

external_image_id

String

用户指定的图片外部ID，与当前图像绑定。用户没提供，系统会生成一个。该ID长度范围为1～36位，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。

external_fields

Json

根据用户自定义数据类型，填入相应的数值。创建人脸库时，定义该字段。具体参见自定义字段。

top_n

Integer

返回查询到最相似的N张人脸，N默认为10。如果返回前5个，则该变量N的值为5。

取值范围1～1000。

threshold

Double

人脸相似度阈值，低于这个阈值则不返回，取值范围[0,1]，一般情况下建议取值0.93，默认为0。

offset

Integer

从第几条数据读起，默认为0。

limit

Integer

读取多少条，默认为5。

video_url

String

video_file

File

video_base64

String

actions

String

action_time

String

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

error_code

String

调用失败时的错误码。

error_msg

String

调用失败时的错误信息。

attributes

String

是否返回人脸属性，希望获取的属性列表，多个属性用逗号隔开。目前支持的属性有：

• 0：人脸姿态
• 2：年龄
• 3：人脸关键点
• 4：装束（帽子、眼镜）
• 5：笑脸