Поделиться через

FaceListOperations Класс

  • Ссылка

Операции FaceListOperations.

Не следует создавать экземпляр этого класса напрямую, а создать экземпляр Client, который создаст его для вас и прикрепит его к атрибуту.

Наследование
builtins.object
FaceListOperations

Конструктор

FaceListOperations(client, config, serializer, deserializer)

Параметры

Имя Описание
client
Обязательно

Клиент для запросов на обслуживание.
config
Обязательно

Настройка клиента службы.
serializer
Обязательно

Сериализатор объектной модели.
deserializer
Обязательно

Десериализатор объектной модели.

Методы

add_face_from_stream

Добавление лица в указанный список лиц, до 1000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова FaceList — Удалить лицо или FaceList — Удалить .
Примечание. PersistedFaceId отличается от faceId, созданного [Face

Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).

  • Более высокое качество изображения лица означает лучшую точность обнаружения и распознавания. Пожалуйста, рассмотрите высококачественные лица: фронтальные, четкие и размер лица 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Поддерживаются JPEG, PNG, GIF (первый кадр) и формат BMP. Допустимый размер файла изображения составляет от 1 КБ до 6 МБ.
  • Прямоугольник targetFace должен содержать одну грань. Ноль или несколько лиц будут рассматриваться как ошибка. Если предоставленный прямоугольник targetFace не возвращается из face — Detect, нет никакой гарантии для успешного обнаружения и добавления лица.
  • Если определить размер лица (36x36–4096 x 4096 пикселей), большой размер головы или большие окклюзии вызовут сбои.
  • Добавление или удаление лиц в одном списке лиц и из него обрабатываются последовательно, а в разные списки лиц и из них — параллельно.
  • Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении, не превышающем 1920 x 1080 пикселей. Изображениям с размерами выше 1920 x 1080 пикселей потребуется пропорционально больший минимальный размер лица.
  • Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение модели обнаружения.
add_face_from_url

Добавление лица в указанный список лиц, до 1000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова FaceList — Удалить лицо или FaceList — Удалить .
Примечание. PersistedFaceId отличается от faceId, созданного [Face

Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).

  • Более высокое качество изображения лица означает лучшую точность обнаружения и распознавания. Пожалуйста, рассмотрите высококачественные лица: фронтальные, четкие и размер лица 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Поддерживаются JPEG, PNG, GIF (первый кадр) и формат BMP. Допустимый размер файла изображения составляет от 1 КБ до 6 МБ.
  • Прямоугольник targetFace должен содержать одну грань. Ноль или несколько лиц будут рассматриваться как ошибка. Если предоставленный прямоугольник targetFace не возвращается из face — Detect, нет никакой гарантии для успешного обнаружения и добавления лица.
  • Если определить размер лица (36x36–4096 x 4096 пикселей), большой размер головы или большие окклюзии вызовут сбои.
  • Добавление или удаление лиц в одном списке лиц и из него обрабатываются последовательно, а в разные списки лиц и из них — параллельно.
  • Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении, не превышающем 1920 x 1080 пикселей. Изображениям с размерами выше 1920 x 1080 пикселей потребуется пропорционально больший минимальный размер лица.
  • Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение модели обнаружения.
create

Создайте пустой список лиц с указанным пользователем faceListId, именем, необязательным userData и recognitionModel. В одной подписке разрешено до 64 списков лиц.
Список лиц — это список лиц( до 1000 лиц), используемых face - Find Similar.
После создания пользователь должен использовать FaceList — Добавить лицо для импорта лиц. Образ не будет сохранен. Только извлеченные функции распознавания лиц хранятся на сервере до вызова FaceList — Delete .
Функция "Поиск похожих" используется для таких сценариев, как поиск лиц, похожих на знаменитостей, аналогичная фильтрация лиц или для легкой идентификации лиц. Но если фактическое использование заключается в идентификации человека, используйте PersonGroup / LargePersonGroup и Face - Identify.
Рассмотрите возможность largeFaceList , если номер лица большой. Он может поддерживать до 1 000 000 лиц.
Для связи с этим списком лиц следует указать "recognitionModel". Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, укажите необходимую модель в этом параметре. Новые лица, добавленные в существующий список лиц, будут использовать модель распознавания, которая уже связана с коллекцией. Существующие функции распознавания лиц в списке лиц не могут быть обновлены до функций, извлеченных другой версией модели распознавания. См. раздел Указание модели распознавания лиц.
delete

Удаляет указанный список лиц.
delete_face

Удаление лица из списка лиц с помощью указанных faceListId и persistedFaceId.
Добавление или удаление лиц в одном списке лиц и из него обрабатываются последовательно, а в разные списки лиц и из них — параллельно.
get

Получите faceListId, имя, userData, recognitionModel и лица в списке лиц. .
list

List faceListId, name, userData и recognitionModel списков лиц.
Чтобы получить сведения о лицах внутри faceList, используйте FaceList — Получение .
update

Обновление сведений о списке лиц.

add_face_from_stream

Добавление лица в указанный список лиц, до 1000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова FaceList — Удалить лицо или FaceList — Удалить .
Примечание. PersistedFaceId отличается от faceId, созданного [Face

Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).

  • Более высокое качество изображения лица означает лучшую точность обнаружения и распознавания. Пожалуйста, рассмотрите высококачественные лица: фронтальные, четкие и размер лица 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Поддерживаются JPEG, PNG, GIF (первый кадр) и формат BMP. Допустимый размер файла изображения составляет от 1 КБ до 6 МБ.
  • Прямоугольник targetFace должен содержать одну грань. Ноль или несколько лиц будут рассматриваться как ошибка. Если предоставленный прямоугольник targetFace не возвращается из face — Detect, нет никакой гарантии для успешного обнаружения и добавления лица.
  • Если определить размер лица (36x36–4096 x 4096 пикселей), большой размер головы или большие окклюзии вызовут сбои.
  • Добавление или удаление лиц в одном списке лиц и из него обрабатываются последовательно, а в разные списки лиц и из них — параллельно.
  • Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении, не превышающем 1920 x 1080 пикселей. Изображениям с размерами выше 1920 x 1080 пикселей потребуется пропорционально больший минимальный размер лица.
  • Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение модели обнаружения.
add_face_from_stream(face_list_id, image, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, callback=None, **operation_config)

Параметры

Имя Описание
face_list_id
Обязательно
str

Идентификатор, ссылающийся на конкретный список лиц.
image
Обязательно
Generator

Поток изображения.
user_data
str

Пользовательские данные о лице для любых целей. Максимальная длина составляет 1 КБ.

значение по умолчанию: None
target_face
list[int]

Прямоугольник лица, указывающий целевое лицо, добавляемое к человеку в формате "targetFace=left,top,width,height". Например, "targetFace=10,10,100,100". Если на изображении несколько лиц, необходимо указать, какое лицо следует добавить, требуется targetFace. Нет targetFace означает, что во всем изображении обнаружено только одно лицо.

значение по умолчанию: None
detection_model
str или DetectionModel

Имя модели обнаружения. Модель обнаружения используется для обнаружения лиц на отправленном изображении. Имя модели обнаружения можно указать при выполнении функции Распознавание лиц — обнаружение или (большой)Список лиц — добавление лица или (большой)PersonGroup — добавление лица. Значение по умолчанию — "detection_01". Если требуется другая модель, укажите ее явным образом. Возможные значения: "detection_01", "detection_02", "detection_03".

значение по умолчанию: detection_01
custom_headers
dict

заголовки, которые будут добавлены в запрос

значение по умолчанию: None
raw
bool

возвращает прямой ответ вместе с десериализованным ответом

значение по умолчанию: False
callback
Callable[<xref:Bytes>, <xref:response=None>]

При указании будет вызываться с каждым блоком данных, которые передаются в поток. Обратный вызов должен принимать два аргумента: байт текущего блока данных и объект ответа. Если данные передаются, ответ будет равен None.

значение по умолчанию: None
operation_config
Обязательно

Переопределения конфигурации операций.

Возвращаемое значение

Тип Описание
PersistedFace,
<xref:msrest.pipeline.ClientRawResponse>

PersistedFace или ClientRawResponse, если raw=true

Исключения

Тип Описание
APIErrorException

add_face_from_url

Добавление лица в указанный список лиц, до 1000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова FaceList — Удалить лицо или FaceList — Удалить .
Примечание. PersistedFaceId отличается от faceId, созданного [Face

Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).

  • Более высокое качество изображения лица означает лучшую точность обнаружения и распознавания. Пожалуйста, рассмотрите высококачественные лица: фронтальные, четкие и размер лица 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Поддерживаются JPEG, PNG, GIF (первый кадр) и формат BMP. Допустимый размер файла изображения составляет от 1 КБ до 6 МБ.
  • Прямоугольник targetFace должен содержать одну грань. Ноль или несколько лиц будут рассматриваться как ошибка. Если предоставленный прямоугольник targetFace не возвращается из face — Detect, нет никакой гарантии для успешного обнаружения и добавления лица.
  • Если определить размер лица (36x36–4096 x 4096 пикселей), большой размер головы или большие окклюзии вызовут сбои.
  • Добавление или удаление лиц в одном списке лиц и из него обрабатываются последовательно, а в разные списки лиц и из них — параллельно.
  • Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении, не превышающем 1920 x 1080 пикселей. Изображениям с размерами выше 1920 x 1080 пикселей потребуется пропорционально больший минимальный размер лица.
  • Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение модели обнаружения.
add_face_from_url(face_list_id, url, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, **operation_config)

Параметры

Имя Описание
face_list_id
Обязательно
str

Идентификатор, ссылающийся на конкретный список лиц.
url
Обязательно
str

Общедоступный URL-адрес изображения
user_data
str

Пользовательские данные о лице для любых целей. Максимальная длина составляет 1 КБ.

значение по умолчанию: None
target_face
list[int]

Прямоугольник лица, указывающий целевое лицо, добавляемое к человеку в формате "targetFace=left,top,width,height". Например, "targetFace=10,10,100,100". Если на изображении несколько лиц, необходимо указать, какое лицо следует добавить, требуется targetFace. Нет targetFace означает, что во всем изображении обнаружено только одно лицо.

значение по умолчанию: None
detection_model
str или DetectionModel

Имя модели обнаружения. Модель обнаружения используется для обнаружения лиц на отправленном изображении. Имя модели обнаружения можно указать при выполнении функции Распознавание лиц — обнаружение или (большой)Список лиц — добавление лица или (большой)PersonGroup — добавление лица. Значение по умолчанию — "detection_01". Если требуется другая модель, укажите ее явным образом. Возможные значения: "detection_01", "detection_02", "detection_03".

значение по умолчанию: detection_01
custom_headers
dict

заголовки, которые будут добавлены в запрос

значение по умолчанию: None
raw
bool

возвращает прямой ответ вместе с десериализованным ответом

значение по умолчанию: False
operation_config
Обязательно

Переопределения конфигурации операций.

Возвращаемое значение

Тип Описание
PersistedFace,
<xref:msrest.pipeline.ClientRawResponse>

PersistedFace или ClientRawResponse, если raw=true

Исключения

Тип Описание
APIErrorException

create

Создайте пустой список лиц с указанным пользователем faceListId, именем, необязательным userData и recognitionModel. В одной подписке разрешено до 64 списков лиц.
Список лиц — это список лиц( до 1000 лиц), используемых face - Find Similar.
После создания пользователь должен использовать FaceList — Добавить лицо для импорта лиц. Образ не будет сохранен. Только извлеченные функции распознавания лиц хранятся на сервере до вызова FaceList — Delete .
Функция "Поиск похожих" используется для таких сценариев, как поиск лиц, похожих на знаменитостей, аналогичная фильтрация лиц или для легкой идентификации лиц. Но если фактическое использование заключается в идентификации человека, используйте PersonGroup / LargePersonGroup и Face - Identify.
Рассмотрите возможность largeFaceList , если номер лица большой. Он может поддерживать до 1 000 000 лиц.
Для связи с этим списком лиц следует указать "recognitionModel". Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, укажите необходимую модель в этом параметре. Новые лица, добавленные в существующий список лиц, будут использовать модель распознавания, которая уже связана с коллекцией. Существующие функции распознавания лиц в списке лиц не могут быть обновлены до функций, извлеченных другой версией модели распознавания. См. раздел Указание модели распознавания лиц.

create(face_list_id, name, user_data=None, recognition_model='recognition_01', custom_headers=None, raw=False, **operation_config)

Параметры

Имя Описание
face_list_id
Обязательно
str

Идентификатор, ссылающийся на конкретный список лиц.
name
Обязательно
str

Определяемое пользователем имя, максимальная длина составляет 128.
user_data
str

Данные, указанные пользователем. Длина не должна превышать 16 КБ.

значение по умолчанию: None
recognition_model
str или RecognitionModel

Возможные значения: "recognition_01", "recognition_02", "recognition_03", "recognition_04".

значение по умолчанию: recognition_01
custom_headers
dict

заголовки, которые будут добавлены в запрос

значение по умолчанию: None
raw
bool

возвращает прямой ответ вместе с десериализованным ответом

значение по умолчанию: False
operation_config
Обязательно

Переопределения конфигурации операций.

Возвращаемое значение

Тип Описание
None,
<xref:msrest.pipeline.ClientRawResponse>

None или ClientRawResponse, если raw=true

Исключения

Тип Описание
APIErrorException

delete

Удаляет указанный список лиц.

delete(face_list_id, custom_headers=None, raw=False, **operation_config)

Параметры

Имя Описание
face_list_id
Обязательно
str

Идентификатор, ссылающийся на конкретный список лиц.
custom_headers
dict

заголовки, которые будут добавлены в запрос

значение по умолчанию: None
raw
bool

возвращает прямой ответ вместе с десериализованным ответом

значение по умолчанию: False
operation_config
Обязательно

Переопределения конфигурации операций.

Возвращаемое значение

Тип Описание
None,
<xref:msrest.pipeline.ClientRawResponse>

None или ClientRawResponse, если raw=true

Исключения

Тип Описание
APIErrorException

delete_face

Удаление лица из списка лиц с помощью указанных faceListId и persistedFaceId.
Добавление или удаление лиц в одном списке лиц и из него обрабатываются последовательно, а в разные списки лиц и из них — параллельно.

delete_face(face_list_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)

Параметры

Имя Описание
face_list_id
Обязательно
str

Идентификатор, ссылающийся на конкретный список лиц.
persisted_face_id
Обязательно
str

Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
custom_headers
dict

заголовки, которые будут добавлены в запрос

значение по умолчанию: None
raw
bool

возвращает прямой ответ вместе с десериализованным ответом

значение по умолчанию: False
operation_config
Обязательно

Переопределения конфигурации операций.

Возвращаемое значение

Тип Описание
None,
<xref:msrest.pipeline.ClientRawResponse>

None или ClientRawResponse, если raw=true

Исключения

Тип Описание
APIErrorException

get

Получите faceListId, имя, userData, recognitionModel и лица в списке лиц. .

get(face_list_id, return_recognition_model=False, custom_headers=None, raw=False, **operation_config)

Параметры

Имя Описание
face_list_id
Обязательно
str

Идентификатор, ссылающийся на конкретный список лиц.
return_recognition_model
bool

Значение , указывающее, должна ли операция возвращать в ответ "recognitionModel".

значение по умолчанию: False
custom_headers
dict

заголовки, которые будут добавлены в запрос

значение по умолчанию: None
raw
bool

возвращает прямой ответ вместе с десериализованным ответом

значение по умолчанию: False
operation_config
Обязательно

Переопределения конфигурации операций.

Возвращаемое значение

Тип Описание
FaceList,
<xref:msrest.pipeline.ClientRawResponse>

FaceList или ClientRawResponse, если raw=true

Исключения

Тип Описание
APIErrorException

list

List faceListId, name, userData и recognitionModel списков лиц.
Чтобы получить сведения о лицах внутри faceList, используйте FaceList — Получение .

list(return_recognition_model=False, custom_headers=None, raw=False, **operation_config)

Параметры

Имя Описание
return_recognition_model
bool

Значение , указывающее, должна ли операция возвращать в ответ "recognitionModel".

значение по умолчанию: False
custom_headers
dict

заголовки, которые будут добавлены в запрос

значение по умолчанию: None
raw
bool

возвращает прямой ответ вместе с десериализованным ответом

значение по умолчанию: False
operation_config
Обязательно

Переопределения конфигурации операций.

Возвращаемое значение

Тип Описание
list[FaceList],
<xref:msrest.pipeline.ClientRawResponse>

list или ClientRawResponse, если raw=true

Исключения

Тип Описание
APIErrorException

update

Обновление сведений о списке лиц.

update(face_list_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)

Параметры

Имя Описание
face_list_id
Обязательно
str

Идентификатор, ссылающийся на конкретный список лиц.
name
str

Определяемое пользователем имя, максимальная длина составляет 128.

значение по умолчанию: None
user_data
str

Данные, указанные пользователем. Длина не должна превышать 16 КБ.

значение по умолчанию: None
custom_headers
dict

заголовки, которые будут добавлены в запрос

значение по умолчанию: None
raw
bool

возвращает прямой ответ вместе с десериализованным ответом

значение по умолчанию: False
operation_config
Обязательно

Переопределения конфигурации операций.

Возвращаемое значение

Тип Описание
None,
<xref:msrest.pipeline.ClientRawResponse>

None или ClientRawResponse, если raw=true

Исключения

Тип Описание
APIErrorException

Атрибуты

models 

models = <module 'azure.cognitiveservices.vision.face.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.9\\x64\\Lib\\site-packages\\azure\\cognitiveservices\\vision\\face\\models\\__init__.py'>