# 错误码
调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
#### 错误响应Body体格式说明
当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。
```
{
     "error_code": "IVS.0003",
     "error_msg": "Some necessary request parameters in req_data is null."
}
```
其中，error_code表示错误码，error_msg表示错误描述信息。
#### 错误码说明
表1错误码 
| 状态码 | 错误码      | 错误信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 处理措施                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|:---|
| 400 | IVS.0001 | Request parameter meta is null or empty.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 请求体参数为null或空。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 请参考API文档填写请求Body信息，并检查请求body格式是否正确。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 400 | IVS.0002 | Request parameter req_data is redundant.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 请求体参数冗余，req_data的元素数量大于1。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | req_data列表中当前仅支持1个元素。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 400 | IVS.0003 | Some necessary request parameters in req_data is null.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 请求参数有一些必要的参数为null。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 请参考API文档填写必要的参数后重试。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 400 | IVS.0004 | Image base64 size is more than 4MB or less than 10KB.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 图像的base64数据量大于4MB或小于10KB。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 要求base64编码后大小不超过4MB。图像各边的像素大小在300到8000px之间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 400 | IVS.0005 | Video base 64 size is more than 10MB or less than 10KB.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 视频的base 64数据量大于10MB或小于10KB。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 要求base 64编码后大小不超过10MB。建议客户端压缩至200KB至2MB。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 400 | IVS.0006 | The input face image is invalid.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 输入的人脸图像不合法。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 要求base64编码后大小不超过4MB。图像各边的像素大小在300到4000px之间，支持JPG格式。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 400 | IVS.0007 | Id card image error: %s. Please try another image.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 输入的身份证图像错误，请换张图像重试。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 请检查身份证图片是否正常，图片中文字清晰，并根据具体错误信息更换图片。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 400 | IVS.0008 | live detect error: %s. Please check your input.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 活体检测失败，请检查输入。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 请检查视频是否正常，视频中的人的头部和脸部符合动作要求，并根据具体错误信息更换视频或修改动作列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 400 | IVS.0009 | face detect error: %s. Please check your input.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 人脸检测失败，请检查输入。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 请检查人脸图片是否正常，图片中有清晰的人脸，并根据具体错误信息更换图片。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 400 | IVS.0010 | face compare error: %s. Please check your input.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 人脸比对失败，请检查输入。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 请检查输入图片base64中是否包含人脸。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 400 | IVS.0011 | - The request param has wrong format, the length of %s exceeds %s bytes.    - The request param has wrong format, error in parsing %s, %s type expected.  - The request param has wrong format, %s is null or empty.  - The request param has wrong format, verification_name contain invalid characters.  - The request param has wrong format, verification_id length must equal 15 or 18.  - The request param has wrong format, verification_id is invalid.   | - 请求参数格式错误，参数长度超出范围。  - 请求参数格式错误，解析参数出现错误。  - 请求参数格式错误，参数的值为null或空。  - 请求参数格式错误，verification_name 包含了无效字符。  - 请求参数格式错误，verification_id长度需为15位或18位。  - 请求参数格式错误，verification_id无效。   | - 请将参数长度设置在相应范围内。  - 请参考API文档，修改对应参数的类型。  - 请检查参数名是否填写正确，以及参数名对应的值是否有填写。  - 请检查verification_name是否为有效的姓名。  - 请检查verification_id的长度。  - 请检查verification_id是否为有效的身份证号码。   |
| 400 | IVS.0012 | Lack Header or Header Content-Type is empty.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 缺少请求头或请求头为空。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 请参考API文档填写请求头。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 400 | IVS.0013 | The authentication token is abnormal.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Token异常。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 请参考[认证鉴权](https://support.huaweicloud.com/api-ivs/ivs_02_0011.html)重新获取Token。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 400 | IVS.0014 | The service has been frozen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 服务已冻结。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 请检查是否有欠费。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 400 | IVS.0015 | The subservice has not been subscribed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 服务未开通。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | - 请登录[控制台](https://console.huaweicloud.com/ivs)开通人证核身服务。  - 已开通情况下，检查服务的开通区域和调用API时，url中填写的区域是否一致。 ![](https://support.huaweicloud.com/api-ivs/zh-cn_image_0000001274149236.png "点击放大")                                                                                                                                                                                 |
| 500 | IVS.0101 | Service inner error.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 服务内部错误。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
当您调用API时，如果遇到"APIGW","APIG"开头的错误码，请参见[API网关错误码](https://support.huaweicloud.com/devg-apisign/api-sign-errorcode.html)进行处理。