Face List - Create
Создайте пустой список лиц с указанным пользователем faceListId, именем, необязательным userData и recognitionModel. В одной подписке разрешено до 64 списков лиц.
Список лиц — это список лиц, до 1000 лиц и используемый face - Find Similar.
После создания пользователь должен использовать FaceList — добавить лицо для импорта лиц. Изображение не будет сохранено. Только извлеченные функции распознавания лиц хранятся на сервере до вызова FaceList — Delete .
Поиск похожих используется для сценария, например поиска лиц знаменитости, аналогичной фильтрации лиц или в качестве легкого способа идентификации лиц. Но если фактическое использование заключается в идентификации человека, используйте PersonGroup / LargePersonGroup и Face - Identify.
Учитывайте largeFaceList , если номер лица большой. Она может поддерживать до 1000 000 лиц.
Для связи с этим списком лиц необходимо указать "recognitionModel". Значение по умолчанию для "recognitionModel" равно "recognition_01", если требуется последняя модель, явно укажите нужную модель в этом параметре. Новые лица, добавленные в существующий список лиц, будут использовать модель распознавания, которая уже связана с коллекцией. Существующие функции распознавания лиц в списке лиц не могут быть обновлены до компонентов, извлеченных другой версией модели распознавания.
См. раздел " Указание модели распознавания лиц".
PUT {Endpoint}/face/v1.0/facelists/{faceListId}Параметры URI
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
Endpoint
|
path | True |
|
Поддерживаемые конечные точки Cognitive Services (например, https://westus.api.cognitive.microsoft.comпротокол и имя узла). |
|
face
|
path | True |
|
Идентификатор, ссылающийся на определенный список лиц. Regex pattern: |
Заголовок запроса
| Name | Required | Type | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | True |
|
Текст запроса
| Name | Required | Type | Description |
|---|---|---|---|
| name | True |
|
Определяемое пользователем имя, максимальная длина — 128. |
| recognitionModel |
Имя модели распознавания. Модель распознавания используется, когда функции распознавания извлекаются и связаны с обнаруженными faceIds, (Large)FaceList или (Large)PersonGroup. Имя модели распознавания можно указать при выполнении face — Detect or (Large)FaceList — Create or (Large)PersonGroup — Create. Значение по умолчанию — "recognition_01", если требуется последняя модель, явно укажите нужную модель. |
||
| userData |
|
Указанные пользователем данные. Длина не должна превышать 16 КБ. |
Ответы
| Name | Type | Description |
|---|---|---|
| 200 OK |
Успешный вызов возвращает пустой текст ответа. |
|
| Other Status Codes |
Ответ об ошибке. |
Безопасность
Ocp-Apim-Subscription-Key
Type:
apiKey
In:
header
Примеры
Create new face list example
Sample Request
PUT {Endpoint}/face/v1.0/facelists/sample_face_list
{
"name": "sample_list",
"userData": "User-provided data attached to the face list.",
"recognitionModel": "recognition_01"
}
Sample Response
Определения
| APIError |
Сведения об ошибке, возвращаемые API |
| Error |
Текст ошибки. |
|
Meta |
Сочетание определяемого пользователем имени и указанного пользователем имени данных и имени модели распознавания для largePersonGroup/personGroup и largeFaceList/faceList. |
|
Recognition |
Имя модели распознавания. Модель распознавания используется, когда функции распознавания извлекаются и связаны с обнаруженными faceIds, (Large)FaceList или (Large)PersonGroup. Имя модели распознавания можно указать при выполнении face — Detect or (Large)FaceList — Create or (Large)PersonGroup — Create. Значение по умолчанию — "recognition_01", если требуется последняя модель, явно укажите нужную модель. |
APIError
Сведения об ошибке, возвращаемые API
| Name | Type | Description |
|---|---|---|
| error |
Текст ошибки. |
Error
Текст ошибки.
| Name | Type | Description |
|---|---|---|
| code |
|
|
| message |
|
MetaDataContract
Сочетание определяемого пользователем имени и указанного пользователем имени данных и имени модели распознавания для largePersonGroup/personGroup и largeFaceList/faceList.
| Name | Type | Default Value | Description |
|---|---|---|---|
| name |
|
Определяемое пользователем имя, максимальная длина — 128. |
|
| recognitionModel | recognition_01 |
Имя модели распознавания. Модель распознавания используется, когда функции распознавания извлекаются и связаны с обнаруженными faceIds, (Large)FaceList или (Large)PersonGroup. Имя модели распознавания можно указать при выполнении face — Detect or (Large)FaceList — Create or (Large)PersonGroup — Create. Значение по умолчанию — "recognition_01", если требуется последняя модель, явно укажите нужную модель. |
|
| userData |
|
Указанные пользователем данные. Длина не должна превышать 16 КБ. |
RecognitionModel
Имя модели распознавания. Модель распознавания используется, когда функции распознавания извлекаются и связаны с обнаруженными faceIds, (Large)FaceList или (Large)PersonGroup. Имя модели распознавания можно указать при выполнении face — Detect or (Large)FaceList — Create or (Large)PersonGroup — Create. Значение по умолчанию — "recognition_01", если требуется последняя модель, явно укажите нужную модель.
| Name | Type | Description |
|---|---|---|
| recognition_01 |
|
|
| recognition_02 |
|
|
| recognition_03 |
|
|
| recognition_04 |
|