检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
状态码 表1 状态码 状态码 编码 说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTP的新版本协议。
使用服务 人脸识别提供了Web化的服务管理平台,即管理控制台,以及基于HTTPS请求的API管理方式。人脸识别以开放API的方式提供给用户,用户需要将人脸识别集成到第三方系统后才可使用。
使用FRS服务,是否会保存用户数据 FRS服务坚持“华为云始终把可信作为产品质量的第一要素”的理念,我们基于安全、合规、隐私、韧性、透明,为您提供有技术、有未来、值得信赖的云服务。具体的声明请参考隐私政策声明和法律声明,可信资源请参见白皮书资源。
消息对象结构 AllParam DetectFace Landmark Attributes FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult
申请服务 在调用API之前,必须先申请开通服务,下面是申请服务的相关步骤。 申请服务前,必须先注册云账号,并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求,选择服务部署区域,开通所需服务(例如:人脸检测),单击右侧的“开通服务”。
操作步骤 进入API Explorer平台获取IAM用户Token接口。 选择Region,编辑获取用户Token接口的请求参数,进行具体的API调用。 Region 在Region下拉列表选取您需要访问的区域。
关闭服务 FRS服务开通后,如不使用,可登录控制台进行关闭。 如果您是主账户,也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
返回结果 请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。
400 失败响应样例 { "error_code": "FRS.0018", "error_msg": "The service inner error." } 状态码 状态码请参见状态码。
ServiceResponseException 服务器响应异常 ServerResponseException 服务端内部错误,Http响应码:[500,]。
400 失败响应样例 { "error_code": "FRS.0202", "error_msg": "The service has been freeze." } 状态码 状态码请参见状态码。
ServiceResponseException 服务器响应异常 ServerResponseException 服务端内部错误,Http响应码:[500,]。
Go SDK 本章节介绍人脸识别服务Go SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通,请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。
400 失败响应样例 { "error_code": "FRS.0002", "error_msg": "The authentication token is abnormal." } 状态码 状态码请参见状态码。
400 失败响应样例 { "error_code": "FRS.0002", "error_msg": "The authentication token is abnormal." } 状态码 状态码请参见状态码。
warningMsg String 告警消息。 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。
不携带ID或格式错误ID(包含特殊字符等),正常使用FRS服务,账单的企业项目会被分类到"default"中。 响应参数 状态码:200 表3 响应Body参数 参数 参数类型 描述 face_number Integer 删除的人脸数量。 调用失败时无此字段。
ServiceResponseException 服务器响应异常 ServerResponseException 服务端内部错误,Http响应码:[500,]。
≥ 0 times 人脸识别 失败调用次数 该指标用于统计状态码为5xx的调用API失败的次数。 单位:次(times)。 ≥ 0 times 人脸识别 平均时延 该指标用于统计API的平均时延。 单位:毫秒(ms)。
warningMsg String 告警消息。 状态码: 400 表8 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。