# 错误码 调用API出错后，将不会返回结果数据。调用方可根据每个API对应的错误码来定位错误原因。当调用出错时，HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系客服，并提供错误码，以便我们尽快帮您解决问题。 - 异常响应样例 ``` { "error_code": "FRS.0202", "error_msg": " The service has been freeze." } ``` - 参数说明 | 参数 | 是否必选 | 类型 | 说明 | |:---|:---|:---|:---| | error_code | 否 | String | 错误码。 | | error_msg | 否 | String | 错误消息。 | - 错误码说明 | 错误码类别 | 状态码 | 错误码 | 说明 | 处理措施 | |:---|:---|:---|:---|:---| | 服务类公共错误 （错误码区间：1～99） | 403 | FRS.0002 | 鉴权token失败，用户token错误或者已过期。 | 请参考[认证鉴权](https://support.huaweicloud.com/api-face/face_02_0004.html)章节，重新获取您的token信息，并使用获取的token来调用人脸识别服务的接口。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0010 | 缺少请求头或者请求头为空。 | 请参考[构造请求](https://support.huaweicloud.com/api-face/face_02_0054.html)章节，检查公共消息头是否配置。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0011 | 缺少参数。 | 请检查请求参数必填参数是否遗漏。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0012 | 请求参数格式不正确。 | 请检查参数输入的格式是否合法。 - 检查必填参数是否填写完整。 - 检查输入数据规格是否符合约束限制。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0013 | 输入的人脸图片尺寸过大或过小。 | 请上传符合规范的人脸图片。 人脸图片分辨率需小于4096\*4096，图片中人脸像素大于80\*80，建议120\*120以上。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0014 | 输入的不是json格式。 | 请检查body体的json格式是否合法。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0015 | 图片base64解析错误。 | - 使用Base64图像数据时，注意编码格式要与API文档中的请求示例保持一致。图片转base64方法可参考[如何获取图片的base64编码](https://support.huaweicloud.com/face_faq/face_06_0035.html) - 使用本地图片文件时，请检查文件是否为图片，且图片类型满足约束。 - 使用图片URL地址时，请检查URL是否为OBS地址，且地址为图片文件的路径。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0016 | 上传的文件格式不支持。 | 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，上传支持识别的文件格式。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0017 | 上传的body体超出允许的范围。 | 上传的body体超出允许的范围，请检查图片和分辨率的大小是否在允许的范围内。 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，使用符合规定的图片。 | | 服务类公共错误 （错误码区间：1～99） | 500 | FRS.0018 | 服务内部错误。 | 请联系客服提供支持。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0019 | 服务未开通。 | 请登录[人脸识别管理控制台](https://console.huaweicloud.com/frs/?locale=zh-cn#/frs/management/faceRecognized)，根据业务需求，选择需要开通的服务。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0020 | 子服务未开通。 | - 请登录[人脸识别管理控制台](https://console.huaweicloud.com/frs/?locale=zh-cn#/frs/management/faceRecognized)，根据业务需求，选择需要开通的子服务。 - 如已开通服务，请检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致；若一致请检查API的URL是否拼写正确。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0021 | 无效OBS的url。 | 请参考请求样例，检查OBS的url是否正确。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0023 | OBS上的文件大小超出范围。 | 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，检查OBS中文件的大小是否符合接口要求 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0024 | OBS上的文件不存在。 | 请检查OBS上的文件是否存在。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0027 | OBS未授权。 | 请登录[人脸识别管理控制台](https://console.huaweicloud.com/frs/?locale=zh-cn#/frs/management/faceRecognized)，单击右上角"服务授权"，完成OBS授权。 | | 服务类公共错误 （错误码区间：1～99） | 403 | FRS.0028 | Project ID跟Token不匹配。 | 请检查获取Token的Project ID是否和请求url上的Project ID一致。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0032 | 排序字段以及类型不支持，只支持数字类型。 | 排序字段以及类型不支持，只支持数字类型。请参考[sort语法](https://support.huaweicloud.com/api-face/face_02_0013.html)章节查看示例。 | | 服务类公共错误 （错误码区间：1～99） | 429 | FRS.0033 | 当前请求数太多，超过流控限制。 | 建议控制请求策略或者进行重试，建议扩容以增加QPS配额。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0035 | 下载地址不合法。 | 请参考请求样例，检查OBS的url是否正确。 | | 服务类公共错误 （错误码区间：1～99） | 400 | FRS.0036 | 从url获取文件失败。 | 请使用OBS提供的url上传图片，并检查url是否正确。 | | 服务管理错误 （错误码区间：201～300） | 400 | FRS.0201 | 此用户已经注册了。 | 此用户已经注册了。 | | 服务管理错误 （错误码区间：201～300） | 400 | FRS.0202 | 服务已经被冻结。 | 请联系客服提供支持。 | | 服务管理错误 （错误码区间：201～300） | 400 | FRS.0203 | 更新用户信息失败。 | 请检查输入的用户信息。 | | 人脸库资源错误 （错误码区间：301～400） | 400 | FRS.0301 | 无法创建已经存在的人脸库。 | 请检查输入的人脸库名称，创建的人脸库已存在，请更换人脸库名称后重新创建。 | | 人脸库资源错误 （错误码区间：301～400） | 400 | FRS.0302 | 人脸库不存在。 | 请检查输入的人脸库是否存在。 | | 人脸库资源错误 （错误码区间：301～400） | 400 | FRS.0304 | 未检测到人脸，无法搜索。 | 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，上传符合规范的人脸图片。 | | 人脸库资源错误 （错误码区间：301～400） | 400 | FRS.0305 | 超过最大的人脸库数量，无法创建新的人脸库。 | 请检查人脸库数量是否超出限制联系客服提供支持。 | | 人脸库资源错误 （错误码区间：301～400） | 403 | FRS.0306 | 超过人脸库容量限制，无法增加更多的人脸。 | 请新增人脸库，重新添加人脸到新的人脸库中。 | | 人脸资源错误 （错误码区间：401～500） | 400 | FRS.0401 | 找不到对应类型的值，无法删除。 | 请参考人脸资源管理接口说明。 | | 人脸资源错误 （错误码区间：401～500） | 400 | FRS.0402 | 输入的字段不存在。 | 请参考人脸资源管理接口说明。 | | 人脸资源错误 （错误码区间：401～500） | 400 | FRS.0403 | Face ID不存在。 | 请检查输入的Face ID是否存在。 | | 人脸资源错误 （错误码区间：401～500） | 400 | FRS.0404 | 未检测到人脸，无法添加。 | 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，上传符合规范的人脸图片。 | | 人脸资源错误 （错误码区间：401～500） | 400 | FRS.0405 | 未定义的自定义字段，无法添加。 | 请检查添加的自定义字段是否存在，创建自定义字段后再进行添加。 | | 人脸资源错误 （错误码区间：401～500） | 400 | FRS.0406 | 导入的数据类型与定义不匹配。 | 请检查导入的数据类型是否与定义的数据类型一致。 | | 人脸资源错误 （错误码区间：401～500） | 400 | FRS.0407 | 批量删除未找到匹配数据。 | 请检查需要删除的数据信息是否存在。 | | 人脸比对错误 （错误码区间：501～600） | 400 | FRS.0501 | 照片未检测到人脸。 | 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，上传符合规范的人脸图片。 | | 人脸搜索错误码 （错误码区间：29～31） | 400 | FRS.0029 | 过滤格式错误。 | 请参考人脸搜索[请求参数](https://support.huaweicloud.com/api-face/face_02_0086.html#face_02_0086__section17729015173610)章节，检查输入格式是否合法。 | | 人脸搜索错误码 （错误码区间：29～31） | 400 | FRS.0030 | 返回字段未定义。 | 请参考人脸搜索[请求参数](https://support.huaweicloud.com/api-face/face_02_0086.html#face_02_0086__section17729015173610)章节，检查return_fields是否定义。 | | 人脸搜索错误码 （错误码区间：29～31） | 400 | FRS.0031 | 排序字段不在返回字段中。 | 请参考人脸搜索[请求参数](https://support.huaweicloud.com/api-face/face_02_0086.html#face_02_0086__section17729015173610)章节，检查排序字段是否定义。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0701 | 视频解析错误。 | 请检查视频是否有损坏。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0702 | 不支持的动作。 | 请参考[动作活体检测 - DetectLive](https://support.huaweicloud.com/api-face/face_02_0100.html)的请求参数，检查输入的动作是否存在。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0703 | Action time非法。 | 请检查输入是否合法。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0704 | 传入的action数量超过10个。 | 传入的action数量超过10个。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0705 | 匹配模式不支持。 | 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，检查输入是否合法。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0706 | 视频时长不支持，限制\[1-15\]秒。 | 视频时长超过限制\[1-15\]秒，请使用符合时长要求的视频。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0707 | 照片未检测到人脸。 | 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，检查照片中是否有人脸或者人脸是否满足约束限制。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0708 | 检查输入的人脸图片质量是否满足要求。 | 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，检查输入的人脸图片质量是否满足要求。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0751 | 视频数据解析失败。 | 请参考[约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.html)章节，检查输入的视频是否满足要求。 | | 活体检测错误 （错误码区间：701～800） | 400 | FRS.0709 | 检查输入的人脸图片包含多张人脸。 | 请检查输入的人脸图片是否包含多张人脸，静默活体检测仅支持单人脸照片。 | - 网关错误码 | 错误码类别 | 状态码 | 错误码 | 说明 | 处理措施 | |:---|:---|:---|:---|:---| | 网关类错误 （错误码区间：1～400） | 404 | APIG.0101 | 访问的API不存在或尚未在环境中发布。 | - 请检查API的URL是否拼写正确，例如，URL中是否缺少project_id。 - 检查URI中的区域信息是否和调用服务配置的区域是否对应。 ![](https://support.huaweicloud.com/api-face/zh-cn_image_0000001223716298.png "点击放大") - HTTP请求方法（POST，GET等）是否正确。 - 具体的URI信息请在各接口的API页面查看。 | | 网关类错误 （错误码区间：1～400） | 413/504 | APIG.0201 | 请求体超过范围或者后端超时。 | 请检查请求的大小是否合法，请联系客服检查后端服务是否运行正常。 | | 网关类错误 （错误码区间：1～400） | 401 | APIG.0301 | IAM身份验证信息不正确： - decrypt token fail：token解析失败。 - token expires：token过期。 - verify aksk signature fail：AK/SK认证失败。 | - token解析失败，请检查获取token的方法，请求体信息是否填写正确，token是否正确；检查获取token的环境与调用的环境是否一致。 - token超时（token expires） ，请重新获取token，使用不过期的token。 - 请检查AK/SK是否正确（AK对应的SK错误，不匹配；AK/SK中多填了空格）。 - AK/SK频繁出现鉴权出错，连续错误5次以上，被锁定5分钟（5分钟内，则一直认为其是异常的鉴权请求），5分钟后解锁重新认证。 - 检查账号权限，是否欠费，被冻结等。 | | 网关类错误 （错误码区间：1～400） | 401 | APIG.0307 | Token需要更新 | - Token有效期为24小时，请使用重新获取Token调用API。 - 检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务，不可以跨区域调用。如果调用了不同区域的接口，导致判断为Token失效，显示APIG.0307错误码。 | 当您调用API时，如果遇到"APIGW"开头的错误码，请参见[API网关错误码](https://support.huaweicloud.com/devg-apisign/api-sign-errorcode.html)进行处理。