Face List Operations - Train Large Face List

Служба:

Azure AI Services

Версия API:

v1.1-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.1-preview.1/largefacelists/your_large_face_list_id/train

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

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

202

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

Определения

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

FaceError

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

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

FaceErrorResponse

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

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