Person Group Operations - Train Person Group

Служба:

Azure AI Services

Версия API:

v1.2-preview.1

Отправьте задачу обучения группы пользователей. Обучение является важным шагом, который можно использовать только обученной группе пользователей с помощью функции "Идентификация от группы лиц".
Задача обучения — это асинхронная задача. Время обучения зависит от количества записей пользователей и их лиц в группе пользователей. Это может быть несколько секунд до минут. Чтобы проверить состояние обучения, используйте "Получить состояние обучения группы пользователей".

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/train

Параметры URI

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

Ответы

Имя	Тип	Описание
202 Accepted		Успешный вызов возвращает пустой текст ответа. Заголовки operation-Location: string
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

Примеры

Train PersonGroup

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

HTTP

POST {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id/train

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

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

202

operation-Location: https://contoso.com/operationstatus

Определения

Имя	Описание
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	Объект ошибки.