VK Cloud logo

Распознавание данных с видео

Для распознавания данных с видео используются три метода API:

  • Get;
  • Subscribe;
  • Unsubscribe.

Рассмотрим подробнее каждый из них.

GET

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

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

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

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

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

Параметры запроса передаются в формате JSON в теле.

ПараметрТипПо умолчаниюЗначение
video
[]video_meta
--
Метаданные для получения результатов обработки видео (required non-empty)

video_meta

ПараметрТипЗначение
name
string
Идентификатор, возвращаемый клиенту в ответе на получение результатов (required non-empty)
id
int
ID задачи (required)
from
int
Запросить результаты с меткой времени (ms) от from (включая from) (optional)
to
int
Запросить результаты с меткой времени (ms) до to (включая to) (optional)
limit
int
Запросить кол-во результатов не больше чем limit (<=) (optional)

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

POST /api/v1/video/get?oauth_provider=mcs&oauth_token=123 HTTP/1.1

....
Content-Type: application/json
{"video":[{"name":"test_name", "id":37, "from":1000, "to":2000, "limit":2}]}

Subscribe

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

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

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

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

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

Параметры запроса передаются в формате JSON в теле.

ПараметрТипПо умолчаниюЗначение
video
[]video_meta
--
Метаданные передаваемых видео (required non-empty)

video_meta

ПараметрТипЗначение
name
string
Идентификатор, возвращаемый клиенту в ответе на постановку данной задачи (required non-empty)
link
string
Ссылка на видео файл (http://,https://) , rtsp поток (rtsp://) (required non-empty)
rtsp_login
string
RTSP авторизация
rtsp_password
string
actions
[]string
Список методов visapi, которыми будет обработано видео

actions

ПараметрЗначение
fd
Детектирование лиц
sd
Детектирование сцены
od
Детектирование объектов
ad
Детектирование достопримечательностей
pd
Детектирование людей

Важно

Максимальный размер видео файла - 2 Gb.

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

POST /api/v1/video/subscribe?oauth_provider=mcs&oauth_token=123 HTTP/1.1

....
Content-Type: application/json
{ "video":[{"name":"1", "link":"http://172.27.28.228/internal/hash/video.short.mp4", "actions":["od"]}]}

Unsubscribe

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

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

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

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

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

Параметры запроса передаются в формате JSON в теле.

ПараметрТипПо умолчаниюЗначение
vide
[]video_met
--
Метаданные передаваемых видео для остановки  (required non-empty)

video_meta

ПараметрТипЗначение
name
string
Идентификатор, возвращаемый клиенту в ответе на остановку данной задачи (required non-empty)
id
int
ID задачи (required)

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

POST /api/v1/video/unsubscribe?oauth_provider=mcs&oauth_token=123 HTTP/1.1

....
Content-Type: application/json
{ "video":[{"name":"1", "id":6}, {"name":"2", "id":39}]}