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

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

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

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

Стандартная ошибка, возвращаемая Яндекс.Облаком в ответе, если операция не была выполнена. Список кодов ошибок с описаниями см. в концепциях 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": [{ ... }] // Результаты анализа другого файла.
  }
 ]
}

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

Код ошибки Описание ошибки
3 Некорректные параметры запроса. Например, в конфигурации указано неправильное количество языков.
8 Превышена квота для заданной возможности.
13 Внутренняя ошибка сервера. Ошибка означает, что операция не может быть выполнена из-за технического состояния сервера. Например, из-за нехватки вычислительных ресурсов.