检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。
调用API操作APIG.0301怎么办 问题现象 在调用人脸识别接口时，报错“APIG.0301”。 该报错显示认证鉴权失败，Token或AK/SK填写错误导致该报错。 解决方法 调用接口时有两种认证方式。Token认证或AK/SK认证。
该报错表示调用接口时使用的请求地址或者URL不存在或没有发布。 解决办法 例如，调用人脸识别中查询服务状态接口时报错APIG.0101，解决方法如下所示。 参考API使用说明获取正确的请求样例。
调用API或SDK 在线调试 本地调用
如何调用API 申请服务 构造请求 认证鉴权 返回结果
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
） 如何获取图片的base64编码 人脸搜索接口中关于top_n参数如何设置 为什么使用人脸识别返回数据为空 人脸识别所需最低带宽是多少 如何获取OBS桶内最近图片的地址URL 人脸识别上传的人脸图片还可以查询到图片数据吗 人脸搜索是否需要使用OBS服务 如何查看API的使用量
步骤3：Token认证鉴权 Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 在Postman左侧导航栏中单击“get-token”配置文件。 单击“Body”配置项。填写用户名、密码、账号名。
调用API报错时怎么处理 检查原因 根据API调用返回结果或者错误码查找原因。 检查访问密钥AK/SK是否获取成功。 检查Token是否填写正确或者已过期。 检查API调用方法是否正确。
如何查看API的使用量 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”，查看API的使用量。 父主题： API使用类
操作步骤 进入API Explorer平台获取IAM用户Token接口。 选择Region，编辑获取用户Token接口的请求参数，进行具体的API调用。 Region 在Region下拉列表选取您需要访问的区域。
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
因权限造成的调用API失败 问题现象 子用户已经开通了人脸识别服务，但是调用时还是提示未订阅。 解决方法 确认调用API所用的区域，与开通服务区域是否一致。 需要核实主账户赋予的权限，并核实开通服务的子账户与调用API时使用的子账户是否相同。 父主题： 权限类
调用API报错FRS.0028怎么办 问题现象 在调用人脸识别接口时，报错“FRS.0028”。 该报错表示Project ID跟Token不匹配。 解决方法 获取准确的Project ID。 在华为云首页右上角，单击“控制台”。 在右上角的用户名中选择“我的凭证”。
调用API报错FRS.0020怎么办 问题现象 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。 该报错表示您的子服务没有开通。 产生该报错的原因有以下两种： API没有开通，就直接调用，导致报错。 开通的API与实际调用的不一致，导致报错。
人脸识别服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人脸识别服务API之前，请确保已经充分了解人脸识别服务相关概念，详细信息请参见人脸识别产品介绍。 父主题： 使用前必读
当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 父主题： 附录
调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
获取Token Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。
图1 检查区域信息 APIG.0101 在调用人脸识别接口时，报错“APIG.0101”，“The API does not exist or has not been published in the environment”。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
