Person Group Operations - Create Large Person Group

Служба:

Azure AI Services

Версия API:

v1.1-preview.1

Create новую группу больших пользователей с указанным пользователем largePersonGroupId, именем, необязательным userData и recognitionModel.
Группа больших пользователей — это контейнер, содержащий отправленные данные о пользователе, включая функции распознавания лиц. Он может содержать до 1 000 000 сущностей.

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

Образ не будет сохранен. На сервере будут храниться только извлеченные функции распознавания лиц и userData, пока не будет вызвана команда "Удалить пользователя большой группы" или "Удалить группу больших пользователей".

Для связи с этой группой больших пользователей следует указать "recognitionModel". Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, укажите необходимую модель в этом параметре. Новые лица, добавленные в существующую группу больших пользователей, будут использовать модель распознавания, которая уже связана с коллекцией. Существующие функции распознавания лиц в группе больших пользователей не могут быть обновлены до функций, извлеченных другой версией модели распознавания.

Примечание

• • Квота подписки на бесплатный уровень: 1000 Группы больших пользователей.
  • Квота на подписку уровня S0: 1 000 000 Группы для крупных пользователей.

PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

Параметры URI

Имя	В	Обязательно	Тип	Описание
apiVersion	path	True	string	Версия API
endpoint	path	True	string uri	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например: https://{имя_ресурса}.cognitiveservices.azure.com).
largePersonGroupId	path	True	string	Идентификатор контейнера. Шаблон регулярного выражения: ^[a-z0-9-_]+$

Текст запроса

Имя	Обязательно	Тип	Описание
name	True	string	Определяемое пользователем имя, максимальная длина составляет 128.
recognitionModel		RecognitionModel	"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	FaceErrorResponse	Непредвиденное сообщение об ошибке. Заголовки 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 LargePersonGroup

Образец запроса

HTTP

PUT {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id

{
  "name": "your_large_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Пример ответа

Код состояния:

200

Определения

Имя	Описание
FaceError	Объект ошибки. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ответ, содержащий сведения об ошибке.

FaceError

Объект ошибки. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.

Имя	Тип	Описание
code	string	Один из серверных наборов кодов ошибок.
message	string	Понятное представление ошибки.

FaceErrorResponse

Ответ, содержащий сведения об ошибке.

Имя	Тип	Описание
error	FaceError	Объект ошибки.