Handling errors in Vision OCR

Vision OCR returns errors for these three levels:

• Request errors.
• File processing errors.
• Errors performing a specific type of analysis.

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

Request errorsRequest errors

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 errorsFile processing errors

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 another file.
  }
 ]
}

If a file processing error occurs, the gRPC error code is always 3, and the error cause is specified in the message. Here are some examples:

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

Analysis errorsAnalysis errors

An error that occurs if the service failed to analyze one of the requested features for the file. 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 another file.
  }
 ]
}

Possible errors: