人脸识别服务 FRS-人脸检测:请求参数

时间:2024-10-17 15:48:19

请求参数

表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

与image_file、image_base64三选一

String

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

OBS URL格式如下,可在OBS控制台获取。

https://BucketName.obs.xxxx.com/ObjectName

image_file

与image_url、image_base64三选一

File

本地图片文件,要求:

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

image_base64

与image_file、image_url三选一

String

图像数据,Base64编码,要求:
  • Base64编码后大小不超过8MB,建议小于1MB
  • 图片为JPG/JPEG/BMP/PNG格式。

attributes

String

是否返回人脸属性,希望获取的属性列表,多个属性间使用逗号(,)隔开。目前支持的属性有:
  • 2:年龄
  • 4:装束(帽子、眼镜)
  • 6:口罩
  • 7:发型
  • 8:胡须
  • 11:图片类型
  • 12:质量
  • 13:表情
  • 21:人脸图片旋转角(顺时针偏转角度),支持0°、90°、180°和270°图片旋转。
support.huaweicloud.com/api-face/face_02_0084.html