人脸识别服务 FRS-人脸比对:请求参数

时间:2024-04-29 09:55:57

请求参数

表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参数

参数名

参数类型

是否必选

说明

image1_url

String

与image1_file、image1_base64三选一

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

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

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

image1_file

File

与image1_url、image1_base64三选一

本地图片文件,要求:

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

image1_base64

String

与image1_file、image1_url三选一

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

image2_url

String

与image2_file、image2_base64三选一

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

image2_file

File

与image2_url、image2_base64三选一

本地图片文件,要求:

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

image2_base64

String

与image2_file、image2_url三选一

图像数据,Base64编码,要求:
  • Base64编码后大小不超过8MB,建议小于1MB
  • 图片为JPG/JPEG/BMP/PNG格式。
support.huaweicloud.com/api-face/face_02_0085.html