VK Cloud logo

Фотосуреттердегі мәтінді тану

Бұл әдіс мыналарды тануға мүмкіндік береді:

  • көшеде түсірілген фотосуреттердегі мәтінді (scene_text);
  • қолжазба мәтінді.

HOST: https://smarty.mail.ru

ENDPOINT: /api/v1/scene_text/recognize

Сұрау

Авторизация деректері сұрау жолында беріледі:

Параметр
Тип
Значение
oauth_token
string
OAuth2 access token (required non-empty)
oauth_provider
string
OAuth2 провайдері (required non-empty)

Қолдау көрсетілетін OAuth2 провайдерлері:

Провайдер
Значение oauth_provider
Получение токена
VK Cloud
mcs
мақаланы қараңыз

Сұрау параметрлері сұрау денесінде JSON форматында беріледі:

Параметр
Тип
Обязательный
Описание
file
string
Фотосуреттердегі мәтінді тану
Файлдар массиві. Файл атаулары әртүрлі болуы тиіс
meta
object
Фотосуреттердегі мәтінді тану
Сұрау денесі

Қалған параметрлер name="meta" ішінде беріледі:

Параметр

Тип

Обязательный

Описание

images

[]image_meta

Фотосуреттердегі мәтінді тану

Берілетін кескіндердің метадеректері

lang

string

Фотосуреттердегі мәтінді тану

Фотодағы мәтіннің күтілетін тілі:

  • rus — орыс,
  • eng — ағылшын.

Параметр көрсетілген жағдайда тану дәлдігі артады

image_meta параметрлері:

Параметр
Тип
Обязательный
Описание
name
string
Фотосуреттердегі мәтінді тану
Сұраудағы және жауаптағы файлдарды сәйкестендіруге арналған файл атаулары

Сұрау үлгісі

curl -X 'POST' curl -X POST "https://smarty.mail.ru/api/v1/scene_text/recognize?oauth_token=<ваш токен>&oauth_provider=mcs"  -H "Accept: application/json"  -H "Content-Type: multipart/form-data"  -F "file=@image3.jpg"  -F "meta={  "images": [    {      "name": "file",      "lang": "eng"    }  ]}"

Жауап

Параметр
Тип
Описание
status
int
Орындалған операцияның күй коды
body
object
Жауап денесі
objects
array
Әрбір файл үшін нәтижелер массиві

Мүмкін status жауаптары:

  • 200 — Vision серверлерімен сәтті өзара әрекеттесу. Қалған статустар үшін қате сипаттамасы body ішінде келтіріледі.
  • 400 — қате сұрау: енгізілген деректер синтаксисінің дұрыстығын тексеріңіз.
  • 403 — қол жеткізуге тыйым салынған: қол жеткізу токенін жаңартыңыз немесе басқа провайдерді таңдаңыз.
  • 500 — сервердің ішкі қатесі.

objects параметрлері:

Параметр
Тип
Обязательный
Описание
status
int
Фотосуреттердегі мәтінді тану
Орындалған операцияның күй коды: 0 — сәтті, 1 — тұрақты қате, 2 — уақытша қате
name
string
Фотосуреттердегі мәтінді тану
Сұраудағы және жауаптағы файлдарды сәйкестендіруге арналған файл атауы
words
array
Фотосуреттердегі мәтінді тану
Жолдағы танылған сөздер массиві

words параметрлері:

Параметр
Тип
Обязательный
Описание
prob
float
Фотосуреттердегі мәтінді тану
Жолды тану сенімділігі
coord
[][]int64
Фотосуреттердегі мәтінді тану
Сөз координаттары — [[x1, y1], [x2, y2], [x3, y3], [x4, y4]]
text
string
Фотосуреттердегі мәтінді тану
Жауаптың танылған сөзі

Жауап үлгісі

{  "status": 200,  "body": {    "objects": [      {        "status": 0,        "name": "file",        "words": [          {            "coord": [              [                314,                395              ],              [                453,                395              ],              [                453,                433              ],              [                314,                433              ]            ],            "prob": 0.9947941769563452,            "text": "SAMSUNG"          }        ]      }    ]  }}

Қосымша мысалдар