Настройка модели пользователя с помощью API сайта Видеоанализатора Azure для медиа

Видеоанализатор Azure для медиа (прежнее название — Индексатор видео) поддерживает распознавание в видеоконтенте лиц обычных людей и знаменитостей. Функция распознавания знаменитостей охватывает около миллиона лиц, выбранных по таким популярным источникам данных, как IMDB, Википедия и влиятельные лица LinkedIn. Лица, которые не распознаются функцией распознавания знаменитостей, определяются, но для них не указывается имя. После отправки видео в Видеоанализатор Azure для медиа и получения результатов вы можете вернуться к лицам, которые не удалось распознать, и ввести для них имена. После того как вы введете имя для определенного лица, это лицо и назначенное имя будут добавлены в модель пользователя вашей учетной записи. Затем Видеоанализатор Azure для медиа будет распознавать это лицо в будущих и предыдущих видео.

API Видеоанализатора Azure для медиа можно использовать для изменения обнаруженных в видео лиц, как описано в этом разделе. Также можно использовать веб-сайт Видеоанализатора Azure для медиа, как описано в статье Настройка модели действующих лиц с помощью веб-сайта Видеоанализатора Azure для медиа.

Управление несколькими моделями пользователя

Видеоанализатор Azure для медиа поддерживает несколько моделей действующих лиц для каждой учетной записи. В настоящее время эта функция доступна только с помощью API-интерфейсов Видеоанализатора Azure для медиа.

Если ваша учетная запись поддерживает разные сценарии ввода-вывода, вам может потребоваться создать несколько моделей пользователя на одну учетную запись. Например, если ваше содержимое связано со спортом, вы можете создать отдельную модель Person для каждого вида спорта (футбола, баскетбола и т. д.).

После создания модели вы можете использовать ее указав идентификатор конкретной модели пользователя при отправке, индексации или переиндексации видео. Обучение нового лица для видео обновляет определенную настраиваемую модель, с которой это видео было связано.

Для каждой учетной записи стоит ограничение в 50 моделей пользователя. Если вам не требуется поддержка нескольких моделей Person, не назначайте идентификатор модели Person при отправке, индексации или переиндексации видео. В этом случае Видеоанализатор Azure для медиа применит пользовательскую модель, используемую по умолчанию для вашей учетной записи.

Создание новой модели пользователя

Чтобы создать модель Person в указанной учетной записи, используйте API создания модели Person.

Ответ предоставляет имя и идентификатор модели пользователя, которую вы создали используя формат из примера приведенного ниже.

{
    "id": "227654b4-912c-4b92-ba4f-641d488e3720",
    "name": "Example Person Model"
}

Позднее вы примените значение id для параметра personModelId во время отправки видео в индекс или переиндексации видео.

Удаление модели пользователя

Чтобы удалить пользовательскую модель Person из указанной учетной записи, используйте API удаления модели Person.

После успешного удаления модели пользователя, индекс ваших видео, который использовал удаленную модель, измениться только после переиндексации. После переиндексации лица, имена которых находились в удаленной модели, будут обнаруживаться, но не будут распознаваться Видеоанализатором Azure для медиа в текущих видео, индексированных с помощью этой модели. Ваши видео, индексирование с помощью удаленной модели, будут использовать модель пользователя вашей учетной записи по умолчанию. Если имена лиц с удаленной модели также подсоединены к вашей модели учетной записи по умолчанию, то они все же будут распознаваться в видео.

При успешном удалении модели Person содержимое не возвращается.

Получение всех моделей пользователя

Чтобы получить все модели Person из указанной учетной записи, используйте API получения модели Person.

В ответе вы получите список всех моделей Person в указанной учетной записи (включая модель Person по умолчанию) с именами и идентификаторами в приведенном ниже формате.

[
    {
        "id": "59f9c326-b141-4515-abe7-7d822518571f",
        "name": "Default"
    }, 
    {
        "id": "9ef2632d-310a-4510-92e1-cc70ae0230d4",
        "name": "Test"
    }
]

Вы можете выбрать модель для использования с видео, указав значение id модели Person в параметре personModelId во время отправки видео в индекс или переиндексации видео.

Обновление информации о лицах

Эта команда позволяет обновлять информацию о лицах в вашем видео добавлением имени с помощью идентификатора видео и идентификатора лица. Затем это действие обновляет модель Person, с которой было связано видео, при отправке, индексации или переиндексации. Если не было указано модель пользователя, тогда обновляется модель учетной записи по умолчанию.

Затем система распознает это же лицо в других ваших видео, которые используют одну модель Person. Распознавание лиц в других имеющихся видео может занять некоторое время, так как этот процесс представляет собой пакетную обработку.

Лицу, которое Видеоанализатор Azure для медиа распознал как знаменитость, можно присвоить новое имя. Новое имя, которое вы присвоите, будет иметь приоритет над именами, встроенными в функцию распознавания знаменитостей.

Чтобы обновить лицо, используйте API обновления лиц для видео.

Имена в моделях пользователя являются уникальными, то есть если вы присваиваете одинаковое значение параметра name двум разным лицам в одной модели, Видеоанализатор Azure для медиа будет считать их одним человеком и объединит лица при повторной индексации видео.

Дальнейшие шаги

Настройка модели пользователя с помощью веб-сайта Видеоанализатора Azure для медиа