Handling errors in Vision OCR

Vision OCR returns errors for these three levels:

• Request error.
• File processing error.
• Error performing a specific type of analysis.

This section lists possible errors and provides descriptions for each of these levels.

Request errorRequest error

A standard error returned by Yandex Cloud if an operation fails. For a list of error codes and descriptions, see the API concepts.

File processing errorFile processing error

An error that occurs if the service failed to process some of the files received. For example, if it failed to decode an image:

{
         "results": [
          {
           "error": {
            "code": 3,
            "message": "Can't decode Image"
           }
          },
          {
            "results": [{ ... }] // Results of analyzing a different file.
          }
         ]
        }
        

In case of a file processing error, the gRPC error code will always be 3, and message will indicate the error cause. Here are some examples:

• Image cannot be decoded.
• Image too big.
• Image resolution too high.
• Error converting to JPEG.

Analysis errorAnalysis error

This error occurs if the service failed to analyze the file for a requested Feature. For example, it failed to recognize text due to an incorrect configuration:

{
         "results": [
          {
           "results": [
            {
             "error": {
              "code": 3,
              "message": "Incorrect feature configuration: Incorrect number of language codes: 0"
             }
            }
           ]
          },
          {
            "results": [{ ... }] // Results of analyzing a different file.
          }
         ]
        }
        

The possible errors include: