Person Group Operations - Create Person Group
Create новую группу пользователей с указанными personGroupId, именем, предоставленным пользователем userData и recognitionModel.
Группа пользователей — это контейнер, содержащий отправленные данные о пользователе, включая функции распознавания лиц.
После создания используйте "Create person group Person", чтобы добавить пользователей в группу, а затем вызовите "Обучение группы пользователей", чтобы подготовить эту группу к определению из группы пользователей.
Образ не будет сохранен. На сервере будут храниться только извлеченные функции распознавания лиц и userData, пока не будет вызвана команда "Удалить пользователя группы пользователей" или "Удалить группу пользователей".
Для связи с этой группой пользователей следует указать "recognitionModel". Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, укажите необходимую модель в этом параметре. Новые лица, добавленные в существующую группу пользователей, будут использовать модель распознавания, уже связанную с коллекцией. Существующие функции распознавания лиц в группе пользователей не могут быть обновлены до функций, извлеченных другой версией модели распознавания.
Примечание
-
- Квота подписки уровня "Бесплатный": 1000 человек Группы. Каждый из них содержит до 1000 человек.
- Квота на подписку уровня S0: 1 000 000 человек Группы. В каждом из них содержится до 10 000 человек.
- Чтобы решить проблему с идентификацией лиц в более крупном масштабе, рассмотрите возможность использования группы больших пользователей.
PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
api
|
path | True |
string |
Версия API |
endpoint
|
path | True |
string uri |
Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например: https://{имя_ресурса}.cognitiveservices.azure.com). |
person
|
path | True |
string |
Идентификатор контейнера. Шаблон регулярного выражения: |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
name | True |
string |
Определяемое пользователем имя, максимальная длина составляет 128. |
recognitionModel |
Recognition |
"recognitionModel", связанный с этим списком лиц. Поддерживаемые значения "recognitionModel" включают "recognition_01", "recognition_02", "recognition_03" и "recognition_04". Значение по умолчанию — "recognition_01". "recognition_04" рекомендуется, так как его точность улучшается на лицах носить маски по сравнению с "recognition_03", а его общая точность улучшается по сравнению с "recognition_01" и "recognition_02". |
|
userData |
string |
Необязательные пользовательские данные. Длина не должна превышать 16 000. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Запрос выполнен успешно. |
|
Other Status Codes |
Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string |
Безопасность
Ocp-Apim-Subscription-Key
Секретный ключ для подписки azure AI Face.
Тип:
apiKey
В:
header
AADToken
Поток OAuth2 в Azure Active Directory
Тип:
oauth2
Flow:
accessCode
URL-адрес авторизации:
https://api.example.com/oauth2/authorize
URL-адрес токена:
https://api.example.com/oauth2/token
Области
Имя | Описание |
---|---|
https://cognitiveservices.azure.com/.default |
Примеры
Create PersonGroup
Образец запроса
PUT {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id
{
"name": "your_person_group_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Пример ответа
Определения
Имя | Описание |
---|---|
Face |
Объект ошибки. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages. |
Face |
Ответ, содержащий сведения об ошибке. |
FaceError
Объект ошибки. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
Имя | Тип | Описание |
---|---|---|
code |
string |
Один из серверных наборов кодов ошибок. |
message |
string |
Понятное представление ошибки. |
FaceErrorResponse
Ответ, содержащий сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
error |
Объект ошибки. |