调用API出错后，将不会返回结果数据。调用方可根据每个API对应的错误码来定位错 误原因。当调用出错时，HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体 中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系客服，并提 供错误码，以便我们尽快帮您解决问题。
当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处 理。
● 异常响应样例
{ "error_code": "FRS.0202",
"error_msg": " The service has been freeze."
}
● 参数说明
参数 是否必选 类型 说明
error_code 否 String 错误码。
error_msg 否 String 错误消息。
● 错误码说明
403 FRS.0002 鉴权token失败，
用户token错误或
400 FRS.0010 缺少请求头或者请 求头为空。
400 FRS.0012 请求参数格式不正 确。
请检查参数输入的 格式是否合法。
400 FRS.0013 输入的人脸图片尺 寸过大或过小。
400 FRS.0014 输入的不是json格 式。
请检查body体的 json格式是否合 法。
400 FRS.0015 图片base64解析错 误。
400 FRS.0016 上传的文件格式不 支持。
请参考约束与限制 章节，上传支持识 别的文件格式。
错误码类别 状态码 错误码 说明 处理措施 400 FRS.0017 上传的body体超出
允许的范围。 上传的body体超出 允许的范围，请检 查图片和分辨率的 大小是否在允许的 范围内。
请参考约束与限制 章节，使用符合规 定的图片。
500 FRS.0018 服务内部错误。 请联系客服提供支 持。
400 FRS.0019 服务未开通。 请登录人脸识别管
理控制台，根据业
务需求，选择需要 开通的服务。400 FRS.0020 子服务未开通。 ● 请登录人脸识
别管理控制 台，根据业务
需求，选择需 要开通的子服 务。● 如果接口已经 开通，请检查 调用接口和开 通接口是否一 致。
400 FRS.0021 无效OBS的url。 请参考请求样例，
检查OBS的url是否 正确。
400 FRS.0022 获取OBS文件失
败。 请检查OBS中文件
是否存在，检查 OBS中文件的访问 权限是否正确。
400 FRS.0023 OBS上的文件大小 超出范围。
请参考约束与限制 章节，检查OBS中 文件的大小是否符 合接口要求 400 FRS.0024 OBS上的文件不存
在。 请检查OBS上的文
件是否存在。
400 FRS.0027 OBS未授权。 请登录人脸识别管
理控制台，点击右
上角“服务授 权”，完成OBS授 权。错误码类别 状态码 错误码 说明 处理措施 403 FRS.0028 Project ID跟Token
不匹配。 请检查获取Token
400 FRS.0031 排序字段不在返回 字段中。
请参考人脸搜素请
求消息章节，检查
排序字段是否定 义。400 FRS.0032 排序字段以及类型 不支持，只支持数
400 FRS.0033 当前请求数太多，
超过流控限制。
400 FRS.0036 从url获取文件失
败。 请使用OBS提供的
400 FRS.0201 此用户已经注册 了。
此用户已经注册 了。
400 FRS.0202 服务已经被冻结。 请联系客服提供支 持。
400 FRS.0203 更新用户信息失 败。
400 FRS.0301 无法创建已经存在 的人脸库。
错误码类别 状态码 错误码 说明 处理措施
400 FRS.0302 人脸库不存在。 请检查输入的人脸 库是否存在。
400 FRS.0304 未检测到人脸，无 法搜索。
请参考约束与限制 章节，上传符合规 范的人脸图片。
400 FRS.0305 超过最大的人脸库 数量，无法创建新 的人脸库。
请检查人脸库数量 是否超出限制联系 客服提供支持。
403 FRS.0306 超过人脸库容量限 制，无法增加更多
400 FRS.0401 找不到对应类型的 值，无法删除。
请参考人脸资源管 理接口说明。
400 FRS.0402 输入的字段不存 在。
请参考人脸资源管 理接口说明。
400 FRS.0403 Face ID不存在。 请检查输入的Face ID是否存在。
400 FRS.0404 未检测到人脸，无 法添加。
请参考约束与限制 章节，上传符合规 范的人脸图片。
400 FRS.0405 未定义的自定义字 段，无法添加。
请检查添加的自定 义字段是否存在，
创建自定义字段后 再进行添加。
400 FRS.0406 导入的数据类型与 定义不匹配。
请检查导入的数据 类型是否与定义的 数据类型一致。
400 FRS.0407 批量删除未找到匹 配数据。
400 FRS.0501 照片未检测到人 脸。
错误码类别 状态码 错误码 说明 处理措施
400 FRS.0702 不支持的动作。 请参考动作活体检
测的请求参数，检
查输入的动作是否 存在。400 FRS.0703 Action time非 法。
请检查输入是否合 法。
400 FRS.0704 传入的action数量
超过10个。 传入的action数量 超过10个。
400 FRS.0705 匹配模式不支持。 请参考约束与限制 章节，检查输入是 否合法。
400 FRS.0706 视频时长不支持，
限制[1-15]秒。 视频时长超过限制 [1-15]秒，请使用 符合时长要求的视 频。
400 FRS.0707 照片未检测到人 脸。
400 FRS.0708 检查输入的人脸图 片质量是否满足要
400 FRS.0709 检查输入的人脸图 片包含多张人脸。
错误码类别 状态码 错误码 说明 处理措施 413/50
4 APIG.
0201 请求体超过范围 或者后端超时。
请检查请求的大 小是否合法，请 联系客服检查后 端服务是否运行 正常。
401 APIG.
0301 鉴权失败。 请参考认证鉴权 章节，进行认证 鉴权。
401 APIG.
0307 Token需要更新 ● Token有效期 为24小时，请 使用重新获取 Token调用 API。
● 检查接口URL 中的终端节点 是否填写正 确。部署在不 同区域间的服 务，不可以跨 区域调用。如 果调用了不同 区域的接口，
导致判断为 Token失效，
显示APIG.
0307错误码。