检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint） 协议类型 部署的服务 华北-北京四 cn-north-4
消息对象结构 AllParam DetectFace Landmark Attributes FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
FRS自定义策略 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。
使用FRS服务需要的权限 使用FRS服务无需权限配置，在管理控制台开通服务后即可使用。 使用FRS服务时，如果您需要使用华为云对象存储服务（OBS）中的数据，请开通对象存储服务OBS授权，可在控制台进行开通。 FRS服务支持IAM细粒度划分策略。 父主题： 权限类
子用户开通服务。 当*(Everyone)特殊用户开通后，其余子账户均可使用当前开通的子服务，不需要单独开通，子用户开通服务后，在调用人脸识别服务期间，调用节点需与开通服务节点保持一致。 子用户缺少某个特定权限 当创建的子用户缺少某个特定权限时，执行开通操作时，会报错误原因和缺少
sort语法 json array形式，排序只支持数值类型，字段重复定义会被覆盖。 例1：单个排序字段 "sort":[ { "location": "desc" } ] 例2：多个排序字段 "sort": [
返回结果 请求发送以后，您会收到响应，包含：状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对
构造请求 本节介绍REST API请求的组成，并以调用人脸检测为例说明如何调用API，您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme}
如何处理未经授权的情况 提交OBS的数据到人脸识别服务进行识别，返回未经授权：The OBS is unauthorized时，您可以通过如下步骤处理： 使用OBS中的数据时，需要授权人脸识别服务能读取OBS数据，检查是否已在人脸识别服务的管理控制台单击过“委托授权”： 如果已经授权，界面将显示为“已授权”。
获取项目ID/账号名/AK/SK 获取项目ID/账号名 获取账号ID 获取AK/SK 父主题： 附录
能超过10000。 face_id 否，与offset二选一 String 人脸ID。 offset+limit值不能超过10000。人脸识别系统非存储系统，暂时不支持数据遍历操作，用户可以自行保存face_id，根据face_id查询导入的人脸信息。 请求参数 表3 请求Header参数
用户登录并验证权限 使用新创建的IAM账户登录FRS控制台，切换至授权区域，进行验证权限。 进入FRS控制台界面，单击“开通服务”，如果无法开通，提示权限不足（假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限），表示“FRS ReadOnlyAccess”已生效。
filter语法 数值类型 数值类型的范围查询，[]包含两端点值，{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例： {
说明 face_id String 是 人脸ID，由系统内部生成的唯一ID。 external_image_id String 否 用户指定的图片外部ID，与当前图像绑定。用户不设置该参数时，系统会自动生成一个。该ID长度范围为[1,36]，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。
因权限造成的调用API失败 问题现象 子用户已经开通了人脸识别服务，但是调用时还是提示未订阅。 解决方法 确认调用API所用的区域，与开通服务区域是否一致。 需要核实主账户赋予的权限，并核实开通服务的子账户与调用API时使用的子账户是否相同。 父主题： 权限类
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证通用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。
如何查看API的使用量 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”，查看API的使用量。 父主题： API使用类
会在使用后1个小时内对上一个结算周期的费用进行扣款。 按小时结算：华为云会每小时根据您的使用量计算费用，并到账户中进行扣费。例如，8:00~9:00期间产生的费用，通常会在10:00以前完成扣费。 按天结算：华为云会根据您的使用量计算费用，每日零点后对前一日使用量进行扣费。例如，2019-05-11
happy：高兴 fear：害怕 surprise：惊讶 sad：伤心 angry：生气 disgust：厌恶 unknown：图片质量问题导致未识别 probability Double 表情置信度，取值范围[0-1]。 父主题： 消息对象结构
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
