检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
省略。 请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。
错误码类 调用API报错时怎么处理 账密报错“The username or password is wrong.” 调用API操作APIG.0301怎么办 调用API报错FRS.0028怎么办 调用API报错FRS.0020怎么办 调用API报错"APIG.0101","API
Explorer调试API。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。 操作步骤 登录API Explorer。 登录后，“X-Auth-Token”和“project_id”参数会自动填充，无需填写。 填写待检测图片数据。
对人脸库和人脸资源进行管理。 开通人脸识别服务是否需要授权 由于应用可能需要使用对象存储服务（OBS）中的数据，人脸识别服务需要您授权可以操作对象存储服务。 调用人脸识别服务API不需要额外权限。 服务支持IAM服务细粒度划分策略。 父主题： API使用类
、曼谷区域API，请联系客服获取开通支持。 图1 开通服务 由于应用可能需要使用对象存储服务（OBS）中的数据，人脸识别服务需要您授权可以操作对象存储服务。单击左侧“委托授权”，完成OBS授权，已授权过的服务，该页面提示“已授权”。 OBS授权时，如果提示委托已达上限，则需要您登
Token（使用密码）。使用Token前请确保Token离过期有足够的时间，防止调用API的过程中Token过期导致调用API失败。 重新获取Token，不影响已有Token有效性。如果在Token有效期内进行如下操作，当前Token将立即失效： 删除/停用IAM用户。 修改IAM用户密码、访问密钥。
的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。 操作步骤 获取并安装FRS Python SDK。 以PyCharm为例，介绍如何安装SDK。 在PyCharm中新建一个项目，并单击左下方“
image_url String 图片的URL路径，目前仅支持华为云上OBS的URL，且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。
查询当前用户所有人脸库的状态信息。 查询人脸库 查询人脸库当前的状态。 删除人脸库 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。 人脸资源管理 添加人脸 添加人脸到人脸库中，检测到传入的单张图片中存在多少张人脸，则增加多少张人脸到人脸库当中。 查询人脸 查询指定人脸库中人脸信息。
似度。如果两张图片中包含多张人脸，则在两张图片中选取最大的人脸进行相似度比对。 图2 人脸比对示意图 人脸搜索 人脸搜索给用户提供了人脸集操作相关的API。用户可以通过创建人脸集合接口创建属于用户的人脸集；通过添加人脸接口向人脸集中添加图片；通过查询人脸搜索接口，返回与输入人脸相
Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 username、domainname、project name可登录控制台“我的凭证”页面获取。password为用户密码。
高频报错处理办法 操作场景 本节内容介绍了调用API时，常见的报错及处理办法。 表1 调用API高频报错处理办法 常见报错 处理办法 FRS.0020子服务未开通 开通该服务，检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致，检查API的URL是否拼写正确。 APIG
支持多人脸图片，当图片中有多个人脸时，会检测其中最大的人脸是否为活体。新老用户均可用该接口。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
存储系统，暂时不支持数据遍历操作，用户可以自行保存face_id，根据face_id查询导入的人脸信息。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。
客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码，表明请求的资源已被永久删除。 411 Length Required
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。
已购买资源包的额度，超出部分将自动转为按需计费。 续费 资源包到期后，您可以进行续费以延长资源包的有效期，也可以设置到期自动续费。续费相关操作，请参见续费管理。 父主题： 计费说明
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。
huaweicloud-sdk-cpp-v3 mkdir build cd build cmake .. make sudo make install 完成上述操作后，C++ SDK 安装目录为 /usr/local。 在Windows系统上安装SDK 安装 vcpkg 并使用 vcpkg 安装所需软件包
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
