ServiceInfo 功能介绍 记录子服务信息。 参数说明 表1 结构格式说明表 名称 类型 说明 subscribe_status Boolean 是否开通该子服务。 create_time String 开通该子服务时间。 父主题： 消息对象结构
使用FRS服务需要的权限 使用FRS服务无需权限配置，在管理控制台开通服务后即可使用。 使用FRS服务时，如果您需要使用华为云对象存储服务（OBS）中的数据，请开通对象存储服务OBS授权，可在控制台进行开通。 FRS服务支持IAM细粒度划分策略。 父主题： 权限类
image_url String 图片的URL路径，目前仅支持华为云上OBS的URL，且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 本地图片文件，图片不能超过8MB，建议小于1MB。
如何获取OBS桶内最近图片的地址URL 将对象权限设置为匿名用户读取权限，通过分享对象URL，匿名用户通过分享的链接地址可访问对象数据。 前提条件 已经设置匿名用户对该对象的读取权限。 权限开启方法请参见对匿名用户授予指定对象的公共读权限。 不能对已加密的对象进行共享。
如何处理未经授权的情况 提交OBS的数据到人脸识别服务进行识别，返回未经授权：The OBS is unauthorized时，您可以通过如下步骤处理： 使用OBS中的数据时，需要授权人脸识别服务能读取OBS数据，检查是否已在人脸识别服务的管理控制台单击过“委托授权”： 如果已经授权
账号需要将OBS权限授予人脸服务，人脸服务才能访问OBS上的图片。 父主题： API使用类
SearchFace 功能介绍 人脸搜索返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸
Landmark 功能介绍 人脸关键点结构。 参数说明 表1 结构格式说明表 名称 类型 说明 nose_contour List [Point] 鼻子轮廓，Point为轮廓坐标值。 mouth_contour List [Point] 嘴巴轮廓，Point为轮廓坐标值。 eyebrow_contour
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 父主题： 消息对象结构
在使用人脸识别服务时需要对OBS的数据进行操作，因此需要先同意服务授权：在开通服务界面，单击右上角“服务授权”，完成OBS授权操作。 获取请求认证 调用人脸识别的API有如下两种认证方式，请任选其中一种进行认证鉴权，鉴权详情请参见《认证鉴权》。
FaceSetFace 功能介绍 人脸库当中的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸
VideoDetectResult 功能介绍 视频活体检测结果结构体。 参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表
云服务之间的关系 如果多个云服务一起搭配使用，需要注意： 不同区域的弹性云服务器、关系型数据库、对象存储服务内网不互通。 不同区域的弹性云服务器不支持跨区域部署在同一负载均衡器下。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。
如果需要存储图片数据可参考以下方法： 可以开通华为云OBS，存储人脸图片。 人脸图片可以存储在客户自己的数据库中。 父主题： API使用类
WarningList 功能介绍 视频活体检测警告信息。 参数说明 表1 结构格式说明 名称 类型 说明 warningCode Integer 警告ID。 warningMsg String 警告消息。 表2 错误提示 warningCode warningMsg 1 人脸没有朝向前方
由于应用可能需要使用对象存储服务（OBS）中的数据，人脸识别服务需要您授权可以操作对象存储服务。单击左侧“委托授权”，完成OBS授权，已授权过的服务，该页面提示“已授权”。 OBS授权时，如果提示委托已达上限，则需要您登录到统一身份认证服务，对委托进行删除或创建新的委托。
BoundingBox 功能介绍 人脸在图像中的位置，坐标系的原点（0,0）在左上角。 参数说明 表1 结构格式说明表 名称 类型 说明 top_left_x Integer 矩形框左上角横坐标。 top_left_y Integer 矩形框左上角纵坐标。 width Integer
与其他云服务的关系 统一身份认证服务 人脸识别使用统一身份认证（Identity and Access Management，简称IAM）服务实现认证和鉴权功能。 对象存储服务 人脸识别支持从对象存储服务（Object Storage Service，简称OBS）读取人脸图片。
通过软件开发工具包（SDK）调用FRS服务API。 如果您是开发工程师，熟悉代码编写，FRS服务为您提供Java版本的SDK，方便您快速集成。 该方式需要编写并调试代码，安装配置开发环境。使用方法请参见调用SDK实现人脸检测。
消息对象结构 AllParam DetectFace Landmark FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult ServiceInfo WarningList 父主题： 公共数据结构
