Обработка ошибок в Vision OCR

Сервис Vision OCR возвращает ошибки для трех уровней:

• ошибка запроса;
• ошибка обработки файла;
• ошибка выполнения определенного типа анализа.

В этом разделе приведены возможные ошибки и описания для каждого из этих уровней.

Ошибка запросаОшибка запроса

Стандартная ошибка, возвращаемая Yandex Cloud в ответе, если операция не была выполнена. Список кодов ошибок с описаниями см. в концепциях API.

Ошибка обработки файлаОшибка обработки файла

Ошибка, возникающая, если сервис не смог обработать какой-то из переданных файлов. Например, если сервис не смог декодировать изображение:

{
         "results": [
          {
           "error": {
            "code": 3,
            "message": "Can't decode Image"
           }
          },
          {
            "results": [{ ... }] // Результаты анализа другого файла.
          }
         ]
        }
        

При ошибке обработки файла gRPC-код ошибки всегда 3, а в message указывается причина ошибки. Вот некоторые примеры:

• Невозможно декодировать изображение.
• Размер изображения слишком большой.
• Разрешение изображения слишком большое.
• Ошибка конвертации в JPEG.

Ошибка выполнения анализаОшибка выполнения анализа

Ошибка, возникающая, если сервис не смог выполнить анализ для какой-то из запрошенных возможностей (Feature) для файла. Например, не смог распознать текст из-за неправильной конфигурации:

{
         "results": [
          {
           "results": [
            {
             "error": {
              "code": 3,
              "message": "Incorrect feature configuration: Incorrect number of language codes: 0"
             }
            }
           ]
          },
          {
            "results": [{ ... }] // Результаты анализа другого файла.
          }
         ]
        }
        

Возможные ошибки: