Написать в техподдержку Позвонить нам
Админпанель Выход

Содержание статьи:

    Распознавание текста

    Данный метод позволяет распознавать текст на изображении.

    Запрос

    Авторизационные данные передаются в строке запроса:

    Параметр

    Тип

    Значение

    oauth_token

    string

    OAuth2 access token (required non-empty)

    oauth_provider

    string

    провайдер OAuth2 (required non-empty)

    Поддерживаемые провайдеры OAuth2:

    ровайдер

    Значение oauth_provider

    Получение токена

    Проекты

    Mail.Ru

    mr

    https://help.mail.ru/biz/vision/api/v1/oauth_token

    только внутренние проекты

    MCS

    mcs

    https://mcs.mail.ru/help/vision-auth/vision-token

    все клиенты MCS

     Параметры запроса передаются в формате JSON в теле запроса с name="meta":

    Параметр

    Тип

    Значение

    images

    []image_meta

    метаданные передаваемых изображений (required non-empty)

     image_meta

    Параметр

    Тип

    Значение

    name

    string

    имена файлов для сопоставления файлов в запросе и ответе (required non-empty)

    Изображения передаются в теле запроса, значения поля name должны соответствовать переданным в images. 

    Максимальное количество изображений в одном запросе равняется 100. Максимальный размер каждого изображения не должен превышать 4МБ.

     Пример запроса:

    POST /api/v1/text/recognize?oauth_provider=mr&oauth_token=123 HTTP/1.1

    Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryfCqTBHeLZlsicvMp
     
    ------WebKitFormBoundaryfCqTBHeLZlsicvMp
    Content-Disposition: form-data; name="file_0"; filename=""
    Content-Type: image/jpeg
     
    000000000000000000000000000
    000000000000000000000000000
    000000000000000000000000000
    ------WebKitFormBoundaryfCqTBHeLZlsicvMp
    Content-Disposition: form-data; name="file_1"; filename=""
    Content-Type: image/jpeg
     
    111111111111111111111111111
    111111111111111111111111111
    111111111111111111111111111
    ------WebKitFormBoundaryfCqTBHeLZlsicvMp
    Content-Disposition: form-data; name="meta"
     
    {"images":[{"name":"file_0"},{"name":"file_1"}]}
    ------WebKitFormBoundaryfCqTBHeLZlsicvMp--

    Ответ

    Параметр

    Тип

    Значение

    status

    int

    200 в случае успеха, иначе описание ошибки будет в body


    body

    string | response

    тело ответа

    response

    Параметр

    Тип

    Значение

    objects

    []object

    массив ответов для каждого файла

    object

    Параметр

    Тип

    Значение

    status

    enum

    результат выполнения

    error

    string

    текстовое описание ошибки (optional)

    name

    string

    имя файла для сопоставления файлов в запросе и ответе

    text

    string

    распознанный текст

     status

    Параметр

    Значение

    0

    успешно

    1

    перманентная ошибка

    2

    временная ошибка

     Пример ответа:

    {
         "status":200,
         "body":
         {         
          "objects":[
          {
              "status":0,
               "name":"file_0",
               "text":"some text"
          }
    }

     Пример ответа, когда не удалось выполнить запрос:

    {
        "status":500,
        "body":"Internal Server Error",
        "htmlencoded":false,
        "last_modified":0
    }

     

    Полезна ли была эта статья?