约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万个人脸特征
SDK接口示例 SDK示例 构造服务客户端 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 String ak = System.getenv("HUAWEICLOUD_SDK_AK"); String sk = System.getenv
调用SDK实现人脸检测 人脸识别服务软件开发工具包（FRS SDK）是对人脸识别服务提供的REST API进行的封装，以简化用户的开发工作。 本章节提供了通过Java SDK调用人脸检测API服务的样例，用户直接调用接口函数即可使用SDK功能。 使用FRS SDK的详细步骤如下所示
查询人脸 功能介绍 查询指定人脸库中人脸信息。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 URI GET /v2/{project_id}/face-sets/{face_set_name}/faces?offset=xxx&limit=xxx 或者 GET
删除人脸 功能介绍 根据指定字段删除人脸库中人脸。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 URI DELETE /v2/{project_id}/face-sets/{face_set_name}/faces?field_name=field_value
终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint
为什么会请求响应过慢 问题现象 用户发送https请求，需要经过tcp握手以及https证书交换，这个过程如果出现丢包情况，操作系统会进行数据包重传，重传间隔根据系统不同可能会3s或者5s。 解决方案 使用https长连接的方式进行请求，这样不必要每次请求都进行http建连。考虑到
Landmark 功能介绍 人脸关键点结构。 参数说明 表1 结构格式说明表 名称 类型 说明 nose_contour List [Point] 鼻子轮廓，Point为轮廓坐标值。 mouth_contour List [Point] 嘴巴轮廓，Point为轮廓坐标值。 eyebrow_contour
AllParam 功能介绍 涉及到的所有参数类型的详细说明。 参数说明 表1 结果格式说明表 名称 类型 说明 project_id String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 image_url String 图片的URL路径，目前仅支持华为云上OBS
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 父主题： 消息对象结构
SearchFace 功能介绍 人脸搜索返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸
BoundingBox 功能介绍 人脸在图像中的位置，坐标系的原点（0,0）在左上角。 参数说明 表1 结构格式说明表 名称 类型 说明 top_left_x Integer 矩形框左上角横坐标。 top_left_y Integer 矩形框左上角纵坐标。 width Integer
添加人脸 功能介绍 添加人脸到人脸库中，检测到传入的单张图片中存在多少张人脸，则增加多少张人脸到人脸库当中。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的
更新人脸 功能介绍 根据人脸ID（face_id）更新单张人脸信息。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 application/json请求的body中，请使用标准Json格式。 URI PUT /v2/{project_id}/face-sets
WarningList 功能介绍 视频活体检测警告信息。 参数说明 表1 结构格式说明 名称 类型 说明 warningCode Integer 警告ID。 warningMsg String 警告消息。 表2 错误提示 warningCode warningMsg 1 人脸没有朝向前方
因权限造成的调用API失败 问题现象 子用户已经开通了人脸识别服务，但是调用时还是提示未订阅。 解决方法 确认调用API所用的区域，与开通服务区域是否一致。 需要核实主账户赋予的权限，并核实开通服务的子账户与调用API时使用的子账户是否相同。 父主题： 权限类
VideoDetectResult 功能介绍 视频活体检测结果结构体。 参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表
ServiceInfo 功能介绍 记录子服务信息。 参数说明 表1 结构格式说明表 名称 类型 说明 subscribe_status Boolean 是否开通该子服务。 create_time String 开通该子服务时间。 父主题： 消息对象结构
自定义字段 数据类型 支持String，Integer，Float，Double，Boolean，Long。 external_image_id，bounding_box，similarity，face_id，create_time，vector，_id，_all，_source为内置字段
FaceSetFace 功能介绍 人脸库当中的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸
