Обработка ошибок в 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": [{ ... }] // Результаты анализа другого файла.
  }
 ]
}

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