检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
登录API Explorer。 登录后，“X-Auth-Token”和“project_id”参数会自动填充，无需填写。 填写待检测图片数据。 输入数据image_file为本地文件。attributes为希望检测的人脸属性，如胡须、发型、表情等。 单击“调试”按钮，获取识别结果。 父主题：
如何获取图片的base64编码 人脸搜索接口中关于top_n参数如何设置 为什么使用人脸识别返回数据为空 人脸识别所需最低带宽是多少 如何获取OBS桶内最近图片的地址URL 人脸识别上传的人脸图片还可以查询到图片数据吗 人脸搜索是否需要使用OBS服务 如何查看API的使用量
查询所有人脸库 查询当前用户所有人脸库的状态信息。 查询人脸库 查询人脸库当前的状态。 删除人脸库 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。 人脸资源管理 添加人脸 添加人脸到人脸库中，检测到传入的单张图片中存在多少张人脸，则增加多少张人脸到人脸库当中。
与image1_file、image1_base64三选一 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 OBS URL格式如下，可在OBS控制台获取。 https://BucketName.obs.xxxx
object 活体检测结果，video-result数据结构请见VideoDetectResult。 调用失败时无此字段。 warning-list Array of WarningList objects 警告信息列表，warning-list数据结构请见WarningList。 调用失败时无此字段。
与image_file、image_base64三选一 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 与image_url、image_base64三选一 本地图片文件，
如您需要使用国际站账号开通香港、曼谷区域API，请联系客服获取开通支持。 图1 开通服务 由于应用可能需要使用对象存储服务（OBS）中的数据，人脸识别服务需要您授权可以操作对象存储服务。单击左侧“委托授权”，完成OBS授权，已授权过的服务，该页面提示“已授权”。 OBS授权时，
请求Body参数 参数 是否必选 参数类型 描述 external_fields 否 Map<String,TypeInfo> 用户自定义数据，自定义字段不能以vector、bounding_box、external_image_id、face_id、create_time、_i
与image_file、image_base64三选一 String 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见申请服务。 image_file 与image_url、image_base64三选一 File 本地图片文件，要求：
申请服务 在使用服务之前，您需要先登录人脸识别管理控制台开通服务，服务开通一次即可，后续使用时无需再开通。 在使用人脸识别服务时需要对OBS的数据进行操作，因此需要先同意服务授权：在开通服务界面，单击右上角“服务授权”，完成OBS授权操作。 获取请求认证 调用人脸识别的API有如下两
安装。 获取通用表格识别SDK示例代码。 登录API Explorer，在“代码示例”中选择“Python”。 填写请求Body参数。输入数据选择image_url，例如填写https://support.huaweicloud.com/productdesc-face/zh-cn_image_0108824834
error 服务端返回的数据格式不符合json格式，导致sdk侧解析json数据报错。 服务端返回的json 数据 不符合json反序列化的规则，和sdk定义的数据结构不一致，导致反序列化失败。 sdk json 数据解析问题。 建议排查服务端返回的数据是否和服务SDK设计的结构、字段一致。
户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
步骤3：获取示例代码 获取人脸检测SDK示例代码。 登录API Explorer，在“代码示例”中选择“Python”。 填写请求Body参数。输入数据可选image或url，本示例使用url，例如https://support.huaweicloud.com/productdesc-fa
与image_file、image_base64三选一 String 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 OBS URL格式如下，可在OBS控制台获取。 https://BucketName.obs.xxxx
与image_file、image_base64、face_id四选一 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 与image_url、image_base64、face_id四选一
face_id 否，与offset二选一 String 人脸ID。 offset+limit值不能超过10000。人脸识别系统非存储系统，暂时不支持数据遍历操作，用户可以自行保存face_id，根据face_id查询导入的人脸信息。 请求参数 表3 请求Header参数 参数 是否必选 参数类型
关于token有效期的详细说明请参见获取IAM用户Token（使用密码）。 图6 获取Token 步骤4：调用服务 人脸识别API的请求Body参数中输入数据支持图片的Base64编码、图片文件和图片URL路径，本示例中使用图片文件。 在Postman左侧导航栏中单击“03 face-detect
NODE_TLS_REJECT_UNAUTHORIZED = "0" 配置认证信息 配置AK、SK、project_id信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。AK、SK和project_id获取方法请参见准备工作。 const ak
query-string 查询参数，可选，查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如，您需要在“华北-北京四”区域调用人脸检测API，URI如下所示。其中face.cn-north-4.myhuaweicloud.
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
