Face List Operations - Create Large Face List
Создайте пустой список лиц большого размера с указанным пользователем largeFaceListId, именем, необязательным пользователемData и распознаваниемModel.
Большой список лиц — это список лиц, до 1000 000 лиц и используемый параметром "Найти похожий из большого списка лиц".
После создания пользователь должен использовать добавление большого списка лиц для импорта лиц и обучения большого списка лиц, чтобы сделать его готовым к поиску аналогичного. Изображение не будет сохранено. На сервере будут храниться только извлеченные функции лиц, пока не будет вызван список крупных лиц.
"Найти аналогичный" используется для сценария, как поиск знаменитостей, похожих на фильтрацию лиц, или как легкий способ идентификации лиц. Но если фактическое использование предназначено для идентификации человека, используйте группу пользователей / группу крупных пользователей и "Определить".
Заметка
-
- Квота подписки на бесплатный уровень: 64 больших списков лиц.
- Квота подписки уровня S0: 1000 000 больших списков лиц.
PUT {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
api
|
path | True |
string |
Версия API |
endpoint
|
path | True |
string uri |
Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://{имя ресурса}.cognitiveservices.azure.com). |
large
|
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 LargeFaceList
Образец запроса
PUT {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id
{
"name": "your_large_face_list_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Пример ответа
Определения
Имя | Описание |
---|---|
Face |
Объект ошибки. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages. |
Face |
Ответ, содержащий сведения об ошибке. |
FaceError
Объект ошибки. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
Имя | Тип | Описание |
---|---|---|
code |
string |
Один из определяемых сервером кодов ошибок. |
message |
string |
Читаемое пользователем представление ошибки. |
FaceErrorResponse
Ответ, содержащий сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
error |
Объект ошибки. |