Face List Operations - Create Face List

Служба:

Azure AI Services

Версия API:

v1.1-preview.1

Create пустой список лиц с указанным пользователем faceListId, именем, необязательным userData и recognitionModel.
В одной подписке разрешено до 64 Списки распознавания лиц.

Список лиц — это список лиц до 1000 лиц, используемый в разделе "Поиск похожих лиц из списка лиц".

После создания пользователь должен использовать "Добавить лицо в списке лиц" для импорта лиц. Образ не будет сохранен. Только извлеченные функции распознавания лиц будут храниться на сервере до вызова "Удалить список лиц".

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

Если номер лица большой, рассмотрите возможность получения большого списка лиц. Он может поддерживать до 1 000 000 лиц.

PUT {endpoint}/face/{apiVersion}/facelists/{faceListId}

Параметры URI

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

Ответы

Имя	Тип	Описание
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 FaceList

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

HTTP

PUT {endpoint}/face/v1.1-preview.1/facelists/your_face_list_id

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

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

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

200

Определения

Имя	Описание
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.