Troubleshoot error messages

Available in Classic and VPC

You might run into the following problems when using CLOVA OCR. Find out causes and possible solutions.

"API are limited to API calls per domain at the same time." Troubleshoot error messages

"Calls to this api have exceeded the rate limit: API are limited to API calls per domain at the same time." error message is displayed.

Cause

It exceeded the number of simultaneous requests available in the CLOVA OCR model.

Solution

If you need to increase the number of simultaneous requests of the General OCR model, forward your domain ID, monthly expected usage, and the purpose of the flow increase to Customer Support. However, for the Document OCR model, it may not be possible to increase the number of simultaneous requests depending on the available capacity.

"NOT_FOUND: not found matched template" error message

When calling APIs with multiform data, the "NOT_FOUND: not found matched template" error message is displayed.

Cause

• This error may occur when the used image does not match with the registered template.
• This error may occur when you have specified templateIds to the request body incorrectly.
• When the template matching with the image used in Template OCR cannot be found, this error may occur.

Solution

• Check the templateIds value of the request body.
• Check if the image used for the template in use and calling is in the same format.
• If this problem continues, forward the image used in the template, the template configuration screen, and the image actually used for calling to Customer Support.

"Not Found Deploy Info: Please confirm the template is released" error message

"Not Found Deploy Info: Please confirm the template is released." error message is displayed.

Cause

This error occurs when the deployment was not successful.

Solution

To use the template registered in Template OCR, you need to deploy the beta deployment and service deployment for the template you registered in the Manage deployment menu on the top left of the screen, in order. Check if you have conducted the beta deployment.
For more information, see Manage deployment.

"Recognition failure" error message

"Recognition failure" error message is displayed.

Cause

This error message appears when the image recognition fails.

Solution

• Edit the image you used for calling. If the image has a background, cut off the image so that only the area to recognize is left and call again.
• If this problem continues, change the extension of the image used for calling and forward it to Customer Support.

"Request invalid: Request data is invalid" error message

"Request invalid: Request data is invalid." error message is displayed.

Cause

This error occurs when you call APIs with an incorrect request body.

Solution

• Check the code to call and edit the request body properly.
• Since the NAVER Cloud Platform does not support code reviews, see CLOVA OCR API guides and check if there is any difference between the API request examples and the code you used.

"Request invalid. unsupported file format" error message

"code": "0011" error message is displayed.
"message": "Request invalid. unsupported file format." error message is displayed.

Cause

• If it is an external URL, it has to be a public URL that image information can be imported.
• This error occurs when there is an error in the format of the field value.

Solution

• If it is an external URL, check if it is a public URL that image information can be imported.
• If the Content-Type is application/json, call with the image field. The image field consists of format, name, and data. Apply the image data encoded with Base64 in the data field. Call in accordance with the format provided in the CLOVA OCR API guides.

"Please confirm the template is released" error message

"Not Found Deploy Info: Please confirm the template is released" error message is displayed.

Cause

This error occurs when the beta deployment has completed but not the service deployment, for the template.

Solution

API calling is available only when the service deployment is completed. Conduct the service deployment.

"Secret validate failed" error message

"Secret validate failed" error message is displayed.

Cause

This error occurs when the entered Secret Key has not been validated.

Solution

• Check if the header information provided when calling matches with the header information created in the Domain template builder > [API Gateway integrations] > [Integrations] tab.
• Check if the header information is forwarded properly in the client environment.
• For descriptions of response status codes, see CLOVA OCR API guides.