Error Codes

If an error occurs during API calling, no result will be returned. You can locate the cause of an error using the error code of each API. When an API call fails, HTTPS status code 4xx or 5xx is returned. The returned message body contains a specific error code and error message. If you fail to identify the cause of an error, contact technical support and provide the error code for quick troubleshooting.

Format of an Error Response Body

If an error occurs during API calling, an error code and a message will be displayed. The following shows an error response body.

{ 
    "error_msg": "The input parameter is invalid.", 
    "error_code": "AIS.0101" 
}

In the response body, error_code indicates the error code, and error_msg provides information about the error.

Error Codes

OCR is deployed on ModelArts and uses API Gateway (APIG). Therefore, OCR error codes may start with ModelArts, APIGW, or APIG.

If an error code starting with APIGW is returned after you call an API, resolve the problem by referring to the instructions provided in . If an error code starts with APIG, rectify the fault by referring to this table.

Module	Error Code	Error Message.	Description	Solution
OCR	AIS.0101	The input parameter is invalid.	The input parameter does not meet the requirements.	Check the entered parameter. For details about the input parameter format of each API, see the request parameters in section "APIs" in Optical Character Recognition API Reference.
	AIS.0102	The image format is not supported.	The image format is not supported.	Check the image format.
	AIS.0103	The image size does not meet the requirements.	The image size does not meet the requirements.	Check the image size.
	AIS.0104	The image is not supported or the image quality is poor.	The image is not supported or is of poor quality.	Check the image type and quality. Check whether the called API is correct.
	AIS.0105	Recognition failed.	Algorithm calculation failed.	Contact technical support.
Platform	ModelArts.0203	Invalid token.	The token is invalid.	Check whether the token is correct.
	ModelArts.4101	Token header cannot be empty.	The token is empty.	The HTTP request header does not contain the token request authentication information of x-auth-token. Check the request.
	ModelArts.4102	Parse Token error.	The token failed to be parsed.	The token request authentication information of x-auth-token in the HTTP request header is incorrect. Check the sent request and token.
	ModelArts.4103	Invalid Token header.	The token is invalid.	The token request authentication information of x-auth-token in the HTTP request header is incorrect. Check the sent request and token.
	ModelArts.4104	Invalid Request Content Length.	The length of the request body is invalid.	Check the request body length. The size cannot exceed 10 MB.
	ModelArts.4105	The JSON format of the input data is incorrect.	The JSON format of the request body is incorrect.	Check the JSON format of the request body.
	ModelArts.4106	Invalid authorization request.	The account is restricted.	Check the user's resources.
	ModelArts.4107	Get user temp ak sk error.	An exception occurred when obtaining the temporary AK/SK.	Contact technical support.
	ModelArts.4201	Request url need service id.	The request URL does not contain the service ID.	Check the service ID in the request URL.
	ModelArts.4202	Request url format invalid.	The request URL format is invalid.	Check the request URL format.
	ModelArts.4203	Access denied! You do not have permission.	Access permission is unavailable.	Check the access permission.
	ModelArts.4204	Request api error! The API XXX is not subscribed.	Failed to request the service because the service has not been subscribed.	Go to the console, select an appropriate region, and subscribe to the API you need. If the service has been subscribed to, check whether the region (or account) where the service is subscribed to is the same as the region (or account) where the service is called. If they are the same, check whether the URL of the API is spelled correctly.
	ModelArts.4301	Have error when get ai-service admin token.	Failed to obtain the admin token of the service.	Contact technical support.
	ModelArts.4302	Gateway forwarding error.	The serviced failed to be accessed.	Contact technical support.
	ModelArts.4401	Max concurrency error.	The number of concurrent requests exceeds the upper limit.	Contact technical support.
	ModelArts.4402	Backend service timeout error.	Service processing timed out.	Contact technical support.
	ModelArts.4403	Backend service unavailable error.	The service is unavailable because it failed to respond or its failure rate is high.	Contact technical support.
	ModelArts.4502	Backend service response error.	The service failed to respond.	Contact technical support.
	ModelArts.4503	Backend service found error.	The service does not exist.	Contact technical support.
	ModelArts.4504	Backend service api not found.	The API to be accessed does not exist.	Contact technical support.
	ModelArts.4505	Backend service internal error.	The internal service error occurs.	Contact technical support.
	ModelArts.4506	SubService service found error.	The subservice corresponding to the API does not exist.	Contact technical support.
	ModelArts.4508	Service not start.	The service does not exist or is stopped.	Contact technical support.
	ModelArts.4601	The URL is not allowed.	The external URL is invalid.	Check the format of the entered download address.
	ModelArts.4603	Obtaining the file from the URL failed.	The file failed to be downloaded from the external URL.	Check the network and URL.
	ModelArts.4702	Query Obs agency failed.	The OBS agency failed to be queried.	Check whether the OBS agency has been enabled for the service.
	ModelArts.4703	The Obs URL is invalid.	The OBS URL is invalid.	Check the OBS URL.
	ModelArts.4704	Obtaining the file from the OBS failed.	The OBS file failed to be obtained.	Check the OBS file.
	ModelArts.4705	The file stored on the OBS is oversized.	The OBS file is oversized.	Check the size of the OBS file and ensure that the file does not exceed the size limit.
	ModelArts.4706	The Obs file is not exist.	The OBS file does not exist.	Check whether the corresponding file exists.
APIG	APIG.0101	The API does not exist or has not been published in the environment.	The API does not exist or has not been published.	Check whether the API URL is correct. For example, check whether the project ID is included in the URL. Check whether the region in the URI is the same as that configured for calling the service by referring to Endpoints. Check whether the HTTP request method (such as POST and GET) is correct. For details about the URI, see the corresponding API page.
	APIG.0201	Backend timeout.	Request timed out.	Contact technical support.
	APIG.0301	Incorrect IAM authentication information.	The IAM authentication information is incorrect. decrypt token fail: The token fails to be parsed. token expires: The token expires. verify aksk signature fail: The AK/SK authentication fails. x-auth-token not found: The x-auth-token parameter is not found.	If the token fails to be parsed, check the method for obtaining the token, whether the request body is correct, whether the token is correct, and whether the environment for obtaining the token is the same as the environment for calling the token. If the token expires, obtain a new token that is valid permanently. Check whether the AK/SK pair is correct. For example, the SK corresponding to the AK is incorrect; an extra space is entered in the AK/SK pair. AK/SK-based authentication errors occur frequently. If an AK/SK pair fails to be authenticated for more than five consecutive times, the AK/SK pair is locked for 5 minutes (the AK/SK-based authentication is considered as an abnormal authentication request within 5 minutes). After 5 minutes, the AK/SK pair is unlocked and re-authenticated. Check whether the spelling of X-Auth-Token in the request header is correct.
	APIG.0308	The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 minute.	The request exceeds the default rate limit of the service.	Contact technical support.