Yandex.Cloud
  • Services
  • Why Yandex.Cloud
  • Pricing
  • Documentation
  • Contact us
Get started
Yandex Vision
  • Getting started
  • Step-by-step instructions
    • All instructions
    • Text recognition
    • Assessing image quality
    • Image moderation
    • Face detection
    • Base64 encoding
  • Concepts
    • Overview
    • Text recognition
      • Overview
      • Template recognition
      • Supported languages
      • Current version restrictions
    • Image classification
      • Overview
      • Supported models
    • Face detection
    • Quotas and limits
  • Access management
  • Pricing policy
  • API reference
    • Authentication in the API
    • gRPC
      • Обзор
      • VisionService
    • REST
      • Handling errors
      • Troubleshooting
      • Overview
      • Vision
        • Overview
        • batchAnalyze
  • Questions and answers
  1. API reference
  2. REST
  3. Handling errors

Handling errors in Yandex Vision

  • Request errors
  • File processing errors
  • Analysis errors

The Yandex Vision service returns errors for 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 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 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:

  • The image cannot be decoded.
  • The image is too big.
  • The image resolution is too large.
  • Error converting file to JPEG.

Analysis 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:

Error code Error description
3 Invalid request parameters. For example, the configuration specifies an incorrect number of languages.
8 The limit for the given feature has been exceeded.
13 Internal server error. This error means that the operation cannot be performed due to a server-side technical problem. For example, due to insufficient computing resources.
In this article:
  • Request errors
  • File processing errors
  • Analysis errors
Language
Careers
Privacy policy
Terms of use
© 2021 Yandex.Cloud LLC