Face List Operations - Create Face List
Create пустой список лиц с указанным пользователем faceListId, именем, необязательным userData и recognitionModel.
В одной подписке разрешено до 64 Списки распознавания лиц.
Список лиц — это список лиц до 1000 лиц, используемый в разделе "Поиск похожих лиц из списка лиц".
После создания пользователь должен использовать "Добавить лицо в списке лиц" для импорта лиц. Образ не будет сохранен. Только извлеченные функции распознавания лиц будут храниться на сервере до вызова "Удалить список лиц".
Функция "Найти похожие" используется для таких сценариев, как поиск лиц, похожих на знаменитостей, аналогичная фильтрация лиц или для легкой идентификации лиц. Но если фактически используется для идентификации человека, используйте группу пользователей или группу больших пользователей и "Идентификация".
Если номер лица большой, рассмотрите возможность получения большого списка лиц. Он может поддерживать до 1 000 000 лиц.
PUT {endpoint}/face/{apiVersion}/facelists/{faceListId}
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
api
|
path | True |
string |
Версия API |
endpoint
|
path | True |
string uri |
Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://{имя_ресурса}.cognitiveservices.azure.com). |
face
|
path | True |
string |
Допустимый символ — буква в нижнем регистре или цифра либо "-" или "_", максимальная длина — 64. Шаблон регулярного выражения: |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
name | True |
string |
Имя, определенное пользователем, максимальная длина — 128. |
recognitionModel |
Recognition |
"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 |
Непредвиденное сообщение об ошибке. Заголовки 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
Образец запроса
PUT {endpoint}/face/v1.1-preview.1/facelists/your_face_list_id
{
"name": "your_face_list_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Пример ответа
Определения
Имя | Описание |
---|---|
Face |
Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages. |
Face |
Ответ, содержащий сведения об ошибке. |
FaceError
Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
Имя | Тип | Описание |
---|---|---|
code |
string |
Один из определяемого сервером набора кодов ошибок. |
message |
string |
Удобочитаемое представление ошибки. |
FaceErrorResponse
Ответ, содержащий сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
error |
Объект error. |