检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 欢迎使用人脸识别服务（Face Recognition Service，简称FRS），该服务能够在图像中快速检测人脸、分析人脸关键点信息、获取人脸属性、实现人脸的比对和检索。 人脸识别服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。
使用Base64图像数据时，注意编码格式要与API文档中的请求示例保持一致。图片转base64方法可参考如何获取图片的base64编码 使用本地图片文件时，请检查文件是否为图片，且图片类型满足约束。 使用图片URL地址时，请检查URL是否为OBS地址，且地址为图片文件的路径。
通过获取到的人脸位置信息，从原图中将人脸图片截出，可以参考多人脸识别Demo。 再调用人脸识别接口，实现多人脸的比对/搜索。 父主题： 产品咨询类
对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。
填写待检测图片数据。 输入数据image_file为本地文件。attributes为希望检测的人脸属性，如胡须、发型、表情等。 单击“调试”按钮，获取识别结果。 父主题： 调用API或SDK
上传文件时，请求格式为multipart。 image1_base64 String 与image1_file、image1_url三选一 图像数据，Base64编码，要求： Base64编码后大小不超过8MB，建议小于1MB。 图片为JPG/JPEG/BMP/PNG格式。
人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
image_file File 与image_url、image_base64三选一 本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。
image_file 与image_url、image_base64三选一 File 本地图片文件，要求： 图片不能超过8MB。 上传文件时，请求格式为multipart。
上传文件时，请求格式为multipart。 image_base64 与image_file、image_url三选一 String 图像数据，Base64编码，要求： Base64编码后大小不超过8MB，建议小于1MB。 图片为JPG/JPEG/BMP/PNG格式。
在使用人脸识别服务时需要对OBS的数据进行操作，因此需要先同意服务授权：在开通服务界面，单击右上角“服务授权”，完成OBS授权操作。 获取请求认证 调用人脸识别的API有如下两种认证方式，请任选其中一种进行认证鉴权，鉴权详情请参见《认证鉴权》。
image_file File 与image_url、image_base64、face_id四选一 本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。
忘记密码 通过登录页面的“忘记密码”功能自行修改密码，详情请参考：忘记密码怎么办。 如果您是IAM用户，还可以请管理员修改密码，适用于您没有绑定邮箱或者手机，无法自行修改密码，详情请参考：管理员重置密码。 父主题： 错误码类
用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。
项目ID的获取方法请参见获取项目ID。 URL请参考构造请求构造请求章节。 账密报错The username or password is wrong 获取Token时出现“The username or password is wrong.”。
数据传入方式 使用FRS API或SDK时，数据主要通过以下三种方法传入。 image_url 传入图片的OBS桶路径。图片上传至OBS服务后，生成的图片路径。 image_file 传入本地文件。 image_base64 传入图片的base64编码数据。
动作活体检测 目前支持检测视频文件，或视频的Base64编码，不支持直接检测视频流，需要用户客户端自己获取视频流并保存成文件，然后调用活体检测接口。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。 建议帧率10fps～30fps。
动作活体检测 目前支持检测视频文件，或视频的Base64编码，不支持直接检测视频流，需要用户客户端自己获取视频流并保存成文件，然后调用活体检测接口。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。 建议帧率10fps～30fps。
人脸识别系统非存储系统，暂时不支持数据遍历操作，用户可以自行保存face_id，根据face_id查询导入的人脸信息。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。
表4 TypeInfo 参数 是否必选 参数类型 描述 type 否 String 数据类型支持string、integer、double、long等。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
