更新时间：2025-12-16 GMT+08:00

错误码

调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，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异常。	请参考认证鉴权重新获取Token。
400	IVS.0014	The service has been frozen.	服务已冻结。	请检查是否有欠费。
400	IVS.0015	The subservice has not been subscribed.	服务未开通。	请登录控制台开通人证核身服务。已开通情况下，检查服务的开通区域和调用API时，url中填写的区域是否一致。
500	IVS.0101	Service inner error.	服务内部错误。	请联系华为云支持人员。