Face List Operations - Train Large Face List

Служба:

Azure AI Services

Версия API:

v1.2-preview.1

Отправьте задачу обучения большого списка лиц.

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

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

POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/train

Параметры URI

Имя	В	Обязательно	Тип	Описание
apiVersion	path	True	string	Версия API
endpoint	path	True	string uri	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://{имя ресурса}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Допустимый символ — буква в нижнем регистре или цифре или "-" или "_", максимальная длина составляет 64. Шаблон регулярного выражения: ^[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 LargeFaceList

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

HTTP

POST {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_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	Объект ошибки.