人脸识别服务 FRS-添加人脸:请求参数

时间：2024-06-13 11:27:29

人脸识别服务 FRS

表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。不携带ID或格式错误ID（包含特殊字符等），正常使用FRS服务，账单的企业项目会被分类到"default"中。

表3 请求Body参数
参数名	参数类型	是否必选	说明
image_url	String	与image_file、image_base64三选一	图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。
image_file	File	与image_url、image_base64三选一	本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。
image_base64	String	与image_file、image_url三选一	图像数据，Base64编码，要求： Base64编码后大小不超过8MB，建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。
external_image_id	String	否	用户指定的图片外部ID，与当前图像绑定。用户没提供，系统会生成一个。该ID长度范围为1～36位，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。
external_fields	Object	否	根据用户自定义数据类型，填入相应的数值。需在创建人脸库时定义external_fields字段，才可以在添加人脸时使用该字段，参考自定义字段。
single	boolean	否	是否将图片中的最大人脸添加至人脸库。可选值包括： true：传入的单张图片中如果包含多张人脸，则只将最大人脸添加到人脸库中。 false：默认为false。传入的单张图片中如果包含多张人脸，则将所有人脸添加至人脸库中。