Объектілерді тану
Бұл әдіс фотосуреттегі әртүрлі объектілерді табуға мүмкіндік береді.
HOST: https://smarty.mail.ru
ENDPOINT: /api/v1/objects/detect
Авторизация деректері сұрау жолында беріледі:
Параметр | Тип | Мәні |
|---|---|---|
oauth_token | string | OAuth2 access token (required non-empty) |
oauth_provider | string | OAuth2 провайдері (required non-empty) |
Қолдау көрсетілетін OAuth2 провайдерлері:
Провайдер | oauth_provider мәні | Токенді алу |
|---|---|---|
VK Cloud | mcs | мақаланы қараңыз |
Сұрау параметрлері сұрау денесінде name="meta" арқылы JSON форматында беріледі:
Параметр | Тип | Мәні |
|---|---|---|
mode | []string | Берілген кескіндерден ізделуі керек объектілер түрлері (required non-empty) |
images | []image_meta | Берілетін кескіндердің метадеректері (required non-empty) |
mode мүмкін мәндері:
Параметр | Тип |
|---|---|
object | Кескіннен объектілерді іздеу |
object2 | Кескіннен объектілерді іздеу (v2 модель нұсқасы — көбірек кластарға жататын объектілерді таниды) |
scene | Кескіннен сахналарды іздеу |
car_number | Кескіннен көлік нөмірлерін іздеу |
multiobject | Кескіннен мультиобъектілерді іздеу — объектілерді және табылған барлық объектілердің бокстарының толық жиынын |
pedestrian | Кескіннен адамдарды іздеу (кескіндегі барлық адамдардың бокстарының толық жиынын дәлірек анықтайды) |
mode бір немесе бірнеше режимді қамтуы мүмкін. Мысалы:
"mode":["object"]<-- тек объектілерді іздеу;"mode":["scene"]<-- тек сахналарды іздеу;"mode":["object","scene"]<-- сахналар мен объектілерді іздеу.
image_meta параметрлері:
Параметр | Тип | Мәні |
|---|---|---|
name | string | Сұраудағы және жауаптағы файлдарды сәйкестендіруге арналған файл атаулары (required non-empty) |
Кескіндер сұрау денесінде беріледі, name өрісінің мәндері images ішінде берілген мәндерге сәйкес келуі керек.
curl -X 'POST' \'https://smarty.mail.ru/api/v1/objects/detect?oauth_token=<ваш токен>&oauth_provider=mcs' \-H 'accept: application/json' \-H 'Content-Type: multipart/form-data' \-F 'file=@objects_detect_ok_people_in_theatre.jpg;type=image/jpeg' \-F 'meta={"mode": ["scene","multiobject","pedestrian"],"images": [{"name": "file"}]}'
Параметр | Тип | Мәні |
|---|---|---|
status | int | Vision серверлерімен өзара әрекеттесу сәтті болған жағдайда 200 |
body | response | Жауап денесі |
response параметрлері:
Параметр | Тип | Мәні |
|---|---|---|
scene_labels | []object | Сахналары бар әр файл үшін жауаптар массиві (болмауы мүмкін) |
object_labels | []object | Объектілері бар әр файл үшін жауаптар массиві (болмауы мүмкін) |
car_number_labels | []object | Көлік нөмірлері бар әр файл үшін жауаптар массиві (болмауы мүмкін) |
multiobject_labels | []object | Мультиобъектілері бар әр файл үшін жауаптар массиві (болмауы мүмкін) |
pedestrian_labels | []object | Адамдары бар әр файл үшін жауаптар массиві (болмауы мүмкін) |
object параметрлері:
Параметр | Тип | Мәні |
|---|---|---|
status | enum | Орындау нәтижесі: - 0 — сәтті;- 1 — тұрақты қате;- 2 — уақытша қате |
error | string | Қатенің мәтіндік сипаттамасы (optional) |
name | string | Сұраудағы және жауаптағы файлдарды сәйкестендіруге арналған файл атауы |
labels | []label | Кескіннен табылған объектілердің (белгілердің) тізімі |
count_by_density | int | Тығыздық картасы арқылы есептелген кадрдағы адамдар саны ( mode="pedestrian" үшін ғана) |
label параметрлері:
Параметр | Мәні |
|---|---|
eng | Табылған объектіге арналған белгі (атауы) ағылшын тілінде |
rus | Табылған объектінің белгісі (атауы) орыс тілінде |
eng_categories | Санаттар тізімі (әр санат көптеген белгілерді қамтиды) ағылшын тілінде (optional) |
rus_categories | Санаттар тізімі (әр санат көптеген белгілерді қамтиды) орыс тілінде (optional) |
prob | Кескінде дәл осы объектінің бар екеніне сенімділік дәрежесі |
coord | Табылған объектінің координаттары (optional) |
types_prob | Нөмірлік белгілер типтерінің ықтималдықтар массиві. Қазіргі уақытта келесі типтерге қолдау көрсетіледі: "rus" — Ресей нөмірлерінің барлық типтері; "cis" — ТМД нөмірлері (жекелей және украиналық әскери нөмірлерден басқа); "eu" — Еуропаның бірқатарлы нөмірлері (optional, only for car_number mode) |
Сұрау үлгісі:
curl -X 'POST' \'https://smarty.mail.ru/api/v1/objects/detect?oauth_token=<ваш токен>&oauth_provider=mcs' \-H 'accept: application/json' \-H 'Content-Type: multipart/form-data' \-F 'file=@persons_set_error_no_face.jpg;type=image/jpeg' \-F 'meta={"mode": ["object","scene"],"images": [{"name": "file"}]}'
Сұрау үлгісі (жарамсыз JSON):
curl -X 'POST' \'https://smarty.mail.ru/api/v1/objects/detect?oauth_token=<ваш токен>&oauth_provider=mcs' \-H 'accept: application/json' \-H 'Content-Type: multipart/form-data' \-F 'file=@objects_detect_ok_people_in_theatre.jpg;type=image/jpeg' \-F 'meta={"mode": ["sceneaaaa","multiobjet"],"images": [{"name": "file"}]}'
Сұрау үлгісі (жарамсыз кескін):
curl -X 'POST' \'https://smarty.mail.ru/api/v1/objects/detect?oauth_token=<ваш токен>&oauth_provider=mcs' \-H 'accept: application/json' \-H 'Content-Type: multipart/form-data' \-F 'file=@empty.jpg;type=image/jpeg' \-F 'meta={"mode": ["scene","multiobjeсt"],"images": [{"name": "file"}]}'
Жауап үлгісі:
{"status": 400,"body": "empty image","htmlencoded": false,"last_modified": 0}