Распознавание лиц с помощью API индексатора видео Azure AI

Индексатор видео Azure AI можно использовать для обнаружения и идентификации лиц в видео. Чтобы изменить видео на размытие (редактировать) лица конкретных лиц, можно использовать API.

Несколько минут видеоматериала, содержащего несколько лиц, может занять несколько часов для удаления вручную, но использование настроек в API индексатора видео позволяет сократить процесс удаления лиц до нескольких простых шагов.

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

В следующем видео показано, как отредактировать видео с помощью API индексатора видео Azure.

Соблюдение нормативных требований, конфиденциальность и безопасность

Как важное напоминание, вы должны соблюдать все применимые законы при использовании аналитики или аналитических данных, получаемых с помощью Video Indexer.

Доступ к службе распознавания лиц ограничен на основе критериев соответствия требованиям и использованию для поддержки принципов ответственного искусственного интеллекта Майкрософт. Служба распознавания лиц доступна только для управляемых корпорацией Майкрософт клиентов и партнеров. Используйте форму подачи заявки на распознавание лиц для получения доступа. Дополнительные сведения см. на странице с ограниченным доступом для лиц.

Терминология и иерархия редактирования лиц

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

Чтобы редактировать видео, необходимо сначала загрузить видео в Индексатор видео и завершить анализ с помощью стандартных или расширенных предустановок видео. Это можно сделать с помощью веб-сайта или API Индексатора видео Azure. Затем вы можете использовать API сокрытия лиц для ссылки на это видео, используя значение videoId. Мы создадим новое видео, в котором отредактированы указанные лица. Анализ видео и редактирование лиц являются отдельными оплачиваемыми заданиями. Дополнительные сведения см. на странице с ценами.

Типы размытия

Вы можете выбрать разные типы размытия при редактировании лиц. Чтобы выбрать тип, используйте имя или представительный номер параметра blurringKind в тексте запроса:

тип размытия числа	размытое имяKind	Пример
0	MediumBlur
1	HighBlur
2	LowBlur
3	BoundingBox
4	Чёрный

Тип размытия в тексте запроса можно указать с помощью blurringKind параметра.

Ниже приведен пример:

{
    "faces": {
        "blurringKind": "HighBlur"
    }
}

Или используйте число, представляющее тип размытия, как описано в предыдущей таблице:

{
    "faces": {
        "blurringKind": 1
    }
}

Фильтры

Можно применять фильтры, чтобы настроить, какие идентификаторы лиц будут размыты. Идентификаторы лиц можно указать в массиве, разделенном запятыми, в тексте JSON-файла. scope Параметр позволяет исключить или включить эти лица для редактирования. Указав идентификаторы, вы можете скрыть все лица, кроме тех, что вы указали, или скрыть только эти идентификаторы. Примеры см. в следующих разделах.

Исключить область

В следующем примере, чтобы скрыть все лица, кроме лиц с идентификаторами 1001 и 1016, используйте область Exclude:

{
    "faces": {
        "blurringKind": "HighBlur",
        "filter": {
            "ids": [1001, 1016],
            "scope": "Exclude"
        }
    }
}

Включить объём

В следующем примере, чтобы редактировать только идентификаторы лиц 1001 и 1016, используйте область Include.

{
    "faces": {
        "blurringKind": "HighBlur",
        "filter": {
            "ids": [1001, 1016],
            "scope": "Include"
        }
    }
}

Замажьте все лица

Чтобы замаскировать все лица, удалите фильтр области.

{
    "faces": {
        "blurringKind": "HighBlur",
    }
}

Чтобы получить идентификатор лица, можно перейти к индексированным видеофайлам и извлечь файл артефакта. Артефакт содержит файл faces.json и файл миниатюры .zip, который включает все лица, обнаруженные в видео. Вы можете сопоставить лицо с идентификатором и решить, какие идентификаторы лиц нужно скрыть.

Создание задачи редактирования

Чтобы создать задание редактирования, можно вызвать следующий вызов API:

POST https://api.videoindexer.ai/{location}/Accounts/{accountId}/Videos/{videoId}/redact[?name][&priority][&privacy][&externalId][&streamingPreset][&callbackUrl][&accessToken]

Требуются следующие значения:

Ниже приведен пример запроса:

https://api.videoindexer.ai/westeurope/Accounts/{id}/Videos/{id}/redact?priority=Low&name=testredaction&privacy=Private&streamingPreset=Default 

Маркер можно указать в качестве заголовка авторизации с типом значения ключа bearertoken:{token}, или указать его как параметр запроса, используя ?token={token}.

Кроме того, необходимо добавить тело запроса в формате JSON с параметрами задания редактирования для применения. Ниже приведен пример:

{
    "faces": {
        "blurringKind": "HighBlur"
    }
}

При успешном выполнении запроса вы получите ответ HTTP 202 ACCEPTED.

Отслеживать состояние задания

В ответе запроса на создание задания вы получите заголовок Location HTTP с URL-адресом задания. Вы можете использовать тот же маркер для отправки запроса GET к этому URL-адресу, чтобы просмотреть состояние задания редактирования.

Ниже приведен пример URL-адреса:

https://api.videoindexer.ai/westeurope/Accounts/<id>/Jobs/<id>

Ниже приведен пример ответа:

{
    "creationTime": "2023-05-11T11:22:57.6114155Z",
    "lastUpdateTime": "2023-05-11T11:23:01.7993563Z",
    "progress": 20,
    "jobType": "Redaction",
    "state": "Processing"
}

Если вы вызываете тот же URL-адрес после завершения задания по редакции, в заголовке Location вы получите подписанный URL-адрес общего доступа к хранилищу (SAS) к отредактированному видео. Рассмотрим пример.

https://api.videoindexer.ai/westeurope/Accounts/<id>/Videos/<id>/SourceFile/DownloadUrl 

Этот URL-адрес перенаправляется в файл .mp4, который хранится в учетной записи хранения Azure.

Вопросы и ответы

Коды ошибок

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

Ответ: 404 не найдено

Учетная запись не найдена или видео не найдено.

Заголовки ответа

Основная часть ответа

JSON по умолчанию

{
    "ErrorType": "GENERAL",
    "Message": "string"
}

Ответ: 400 Недопустимый запрос

Недопустимые входные данные или невозможно редактировать видео, поскольку его первоначальная загрузка завершилась неудачей. Отправьте видео еще раз.

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

Заголовки ответа

Основная часть ответа

JSON по умолчанию

{
    "ErrorType": "GENERAL",
    "Message": "string"
}

Ответ: конфликт 409

Видео уже индексируется.

Заголовки ответа

Основная часть ответа

JSON по умолчанию

{
    "ErrorType": "GENERAL",
    "Message": "string"
}

Ответ: 401 Неавторизованный

Маркер доступа не авторизован для доступа к учетной записи.

Заголовки ответа

Основная часть ответа

JSON по умолчанию

{
    "ErrorType": "USER_NOT_ALLOWED",
    "Message": "Access token is not authorized to access account 'SampleAccountId'."
}

Ответ: ошибка внутреннего сервера 500

На сервере произошла ошибка.

Заголовки ответа

Основная часть ответа

JSON по умолчанию

{
    "ErrorType": "GENERAL",
    "Message": "There was an error."
}

Ответ: 429 Слишком много запросов

Было отправлено слишком много запросов. Retry-After Используйте заголовок ответа, чтобы решить, когда отправить следующий запрос.

Заголовки ответа

Ответ: 504 Ошибка таймаут шлюза

Сервер не ответил на шлюз в течение ожидаемого времени.

Заголовки ответа

JSON по умолчанию

{
    "ErrorType": "SERVER_TIMEOUT",
    "Message": "Server did not respond to gateway within expected time"
}