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

FaceOperations Класс

  • Ссылка

Операции FaceOperations.

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

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

Конструктор

FaceOperations(client, config, serializer, deserializer)

Параметры

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

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

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

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

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

Методы

detect_with_stream

Обнаруживает человеческие лица на изображении, возвращает прямоугольники с лицами и при необходимости с faceId, ориентирами и атрибутами.

  • Образ не будет сохранен. На сервере будет храниться только извлеченная функция распознавания лиц. FaceId является идентификатором функции распознавания лиц и будет использоваться в face - Identify, Face - Verify и Face - Find Similar. Срок действия хранимых функций распознавания лиц истечет и будет удален в момент, указанный faceIdTimeToLive после первоначального вызова обнаружения.
  • Необязательные параметры включают faceId, ориентиры и атрибуты. Атрибуты включают возраст, пол, headPose, улыбку, очки, эмоции, волосы, макияж, окклюзию, аксессуары, размытие, экспозицию, шум, маску и качествоForRecognition. Некоторые результаты, возвращаемые для определенных атрибутов, могут быть не очень точными.
  • Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
  • Для изображения можно вернуть до 100 лиц. Лица ранжируются по размеру прямоугольника от больших к маленьким.
  • Чтобы получить оптимальные результаты при запросе face - Identify, Face - Verify и Face - Find Similar ("returnFaceId" имеет значение true), используйте лица: фронтальные, четкие и с минимальным размером 200 x 200 пикселей (100 пикселей между глазами).
  • Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
  • Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
  • Предоставляются различные значения recognitionModel. Если требуются последующие операции, такие как Verify, Identify, Find Similar, укажите модель распознавания с параметром recognitionModel. Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, явно укажите нужную модель в этом параметре. После указания обнаруженные идентификаторы faceId будут связаны с указанной моделью распознавания. Дополнительные сведения см. в статье Указание модели распознавания.
detect_with_url

Обнаруживает человеческие лица на изображении, возвращает прямоугольники с лицами и при необходимости с faceId, ориентирами и атрибутами.

  • Образ не будет сохранен. На сервере будет храниться только извлеченная функция распознавания лиц. FaceId является идентификатором функции распознавания лиц и будет использоваться в face - Identify, Face - Verify и Face - Find Similar. Срок действия хранимых функций распознавания лиц истечет и будет удален в момент, указанный faceIdTimeToLive после первоначального вызова обнаружения.
  • Необязательные параметры включают faceId, ориентиры и атрибуты. Атрибуты включают возраст, пол, headPose, улыбку, очки, эмоции, волосы, макияж, окклюзию, аксессуары, размытие, экспозицию, шум, маску и качествоForRecognition. Некоторые результаты, возвращаемые для определенных атрибутов, могут быть не очень точными.
  • Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
  • Для изображения можно вернуть до 100 лиц. Лица ранжируются по размеру прямоугольника от больших к маленьким.
  • Чтобы получить оптимальные результаты при запросе face - Identify, Face - Verify и Face - Find Similar ("returnFaceId" имеет значение true), используйте лица: фронтальные, четкие и с минимальным размером 200 x 200 пикселей (100 пикселей между глазами).
  • Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
  • Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
  • Предоставляются различные значения recognitionModel. Если требуются последующие операции, такие как Verify, Identify, Find Similar, укажите модель распознавания с параметром recognitionModel. Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, явно укажите нужную модель в этом параметре. После указания обнаруженные идентификаторы faceId будут связаны с указанной моделью распознавания. Дополнительные сведения см. в статье Указание модели распознавания.
find_similar

FaceId лица заданного запроса, поиск похожих лиц из массива faceId, списка лиц или большого списка лиц. Массив faceId содержит лица, созданные face — Detect With URL или Face — Detect With Stream, срок действия которых истекает в момент, указанный faceIdTimeToLive после создания. FaceListId создает faceList — create , содержащий persistedFaceIds, срок действия которых не истекает. Кроме того, largeFaceList — Create создает "largeFaceListId", содержащий persistedFaceIds, срок действия которых также не истекает. В зависимости от входных данных возвращенный список похожих лиц содержит faceIds или persistedFaceIds, ранжированные по подобию.
Функция Найти аналогичная имеет два режима работы: matchPerson и matchFace. MatchPerson — это режим по умолчанию, в котором он пытается найти лица одного и того же человека, как это возможно, с помощью внутренних пороговых значений одного и того же человека. Полезно найти другие фотографии известного человека. Обратите внимание, что пустой список возвращается, если ни один из лиц не проходит внутренние пороговые значения. Режим matchFace игнорирует пороговые значения для одного человека и в любом случае возвращает похожие лица, даже если сходство низкое. Его можно использовать в таких случаях, как поиск лиц знаменитостей.
"recognitionModel", связанный с faceId запроса, должен совпадать с "recognitionModel", используемым целевым массивом faceId, списком лиц или большим списком лиц. .
group

Разделяет лица-кандидаты на группы на основании сходства лиц.

  • Выходные данные — одна или несколько несвязанных групп лиц и messyGroup. Группа лиц содержит лица с похожим видом, часто одного и того же человека. Группы лиц ранжируются по размеру группы, т. е. количеству лиц. Обратите внимание, что лица, принадлежащие одному и тому же человеку, могут быть разделены на несколько групп в результате.
  • MessyGroup — это специальная группа лиц, содержащая лица, которые не могут найти похожие лица из исходных лиц. MessyGroup не будет отображаться в результате, если все лица нашли своих коллег.
  • Для API группы требуется по крайней мере 2 потенциальных лица и не более 1000. Мы рекомендуем попробовать Face — Проверка , если у вас есть только 2 лица кандидатов.
  • Идентификаторы faceId "recognitionModel", связанные с лицом запроса, должны совпадать. .
identify

Идентификация типа "один ко многим" для поиска наиболее близких совпадений лица пользователя из конкретного запроса в группе пользователей или большой группе пользователей.
Для каждого лица в массиве faceIds функция Face Identify вычислит сходства между лицом запроса и всеми лицами в группе пользователей (заданной personGroupId) или большой группе пользователей (заданная largePersonGroupId) и возвращает людей-кандидатов для этого лица, ранжированных по достоверности сходства. Группа пользователей или большая группа пользователей должна быть обучена, чтобы подготовить ее к идентификации. Дополнительные сведения см . в разделах PersonGroup — Train и LargePersonGroup — Train.
Примечания:

  • Алгоритм позволяет независимо идентифицировать несколько лиц по одному запросу, но не более 10 лиц.
  • Каждый человек в группе или большой группе может иметь более одного лица, но не более 248 лиц.
  • Более высокое качество изображения лица означает лучшую точность идентификации. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Количество возвращаемых кандидатов ограничено значениями maxNumOfCandidatesReturned и confidenceThreshold. Если никто не идентифицируется, возвращенные кандидаты будут пустым массивом.
  • Попробуйте face — поиск похожих лиц, если вам нужно найти похожие лица из списка лиц или большого списка лиц вместо группы пользователей или большой группы пользователей.
  • FaceIds "recognitionModel", связанный с запросом faceId, должен совпадать с "recognitionModel", используемым целевой группой пользователей или группой больших пользователей. .
verify_face_to_face

Проверяет, принадлежат ли два лица одному пользователю или принадлежит ли лицо пользователю.
Примечания:

  • Более высокое качество изображения лица означает лучшую точность идентификации. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Для сценариев, которые чувствительны к точности, сделайте собственное суждение.
  • Идентификаторы faceId "recognitionModel", связанные с лицом запроса, должны совпадать с идентификатором распознавания, используемым целевым лицом, группой пользователей или группой больших пользователей. .
verify_face_to_person

Проверьте, принадлежат ли два лица одному и тому же человеку. Сравнивает идентификатор лица с идентификатором пользователя.

detect_with_stream

Обнаруживает человеческие лица на изображении, возвращает прямоугольники с лицами и при необходимости с faceId, ориентирами и атрибутами.

  • Образ не будет сохранен. На сервере будет храниться только извлеченная функция распознавания лиц. FaceId является идентификатором функции распознавания лиц и будет использоваться в face - Identify, Face - Verify и Face - Find Similar. Срок действия хранимых функций распознавания лиц истечет и будет удален в момент, указанный faceIdTimeToLive после первоначального вызова обнаружения.
  • Необязательные параметры включают faceId, ориентиры и атрибуты. Атрибуты включают возраст, пол, headPose, улыбку, очки, эмоции, волосы, макияж, окклюзию, аксессуары, размытие, экспозицию, шум, маску и качествоForRecognition. Некоторые результаты, возвращаемые для определенных атрибутов, могут быть не очень точными.
  • Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
  • Для изображения можно вернуть до 100 лиц. Лица ранжируются по размеру прямоугольника от больших к маленьким.
  • Чтобы получить оптимальные результаты при запросе face - Identify, Face - Verify и Face - Find Similar ("returnFaceId" имеет значение true), используйте лица: фронтальные, четкие и с минимальным размером 200 x 200 пикселей (100 пикселей между глазами).
  • Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
  • Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
  • Предоставляются различные значения recognitionModel. Если требуются последующие операции, такие как Verify, Identify, Find Similar, укажите модель распознавания с параметром recognitionModel. Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, явно укажите нужную модель в этом параметре. После указания обнаруженные идентификаторы faceId будут связаны с указанной моделью распознавания. Дополнительные сведения см. в статье Указание модели распознавания.
detect_with_stream(image, return_face_id=True, return_face_landmarks=False, return_face_attributes=None, recognition_model='recognition_01', return_recognition_model=False, detection_model='detection_01', face_id_time_to_live=86400, custom_headers=None, raw=False, callback=None, **operation_config)

Параметры

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

Поток изображений.
return_face_id
bool

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

значение по умолчанию: True
return_face_landmarks
bool

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

значение по умолчанию: False
return_face_attributes
list[str или FaceAttributeType]

Проанализируйте и верните один или несколько указанных атрибутов лица в строке, разделенной запятыми, например returnFaceAttributes=age,gender. Доступные атрибуты зависят от указанного параметра detectionModel. "detection_01" поддерживает возраст, пол, headPose, улыбку, лицевой стул, очки, эмоции, волосы, макияж, окклюзию, аксессуары, размытие, воздействие, шум и качествоForRecognition. Хотя "detection_02" не поддерживает атрибуты, а "detection_03" поддерживает только mask и qualityForRecognition. Кроме того, qualityForRecognition поддерживается только в том случае, если параметр "recognitionModel" указан как "recognition_03" или "recognition_04". Обратите внимание, что каждый анализ атрибутов лиц имеет дополнительные вычислительные и временные затраты.

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

Имя модели распознавания. Модель распознавания используется при извлечении признаков лиц и связывании с обнаруженными faceId, (Большим)FaceList или (Большим)PersonGroup. Имя модели распознавания можно указать при выполнении face - Detect или (Large)FaceList - Create или (Large)PersonGroup - Create. Значение по умолчанию — "recognition_01". Если требуется последняя модель, укажите нужную модель явным образом. Возможные значения: "recognition_01", "recognition_02", "recognition_03", "recognition_04".

значение по умолчанию: recognition_01
return_recognition_model
bool

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

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

Имя модели обнаружения. Модель обнаружения используется для обнаружения лиц на отправленном изображении. Имя модели обнаружения можно указать при выполнении face - Detect или (Large)FaceList - Add FaceList или (Large)PersonGroup - Add Face. Значение по умолчанию — "detection_01". Если требуется другая модель, укажите ее явным образом. Возможные значения: "detection_01", "detection_02", "detection_03".

значение по умолчанию: detection_01
face_id_time_to_live
int

Количество секунд для кэширования faceId. Поддерживаемый диапазон от 60 до 86400 секунд. Значение по умолчанию — 86400 (24 часа).

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

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

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

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

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

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

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

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

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

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

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

Исключения

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

detect_with_url

Обнаруживает человеческие лица на изображении, возвращает прямоугольники с лицами и при необходимости с faceId, ориентирами и атрибутами.

  • Образ не будет сохранен. На сервере будет храниться только извлеченная функция распознавания лиц. FaceId является идентификатором функции распознавания лиц и будет использоваться в face - Identify, Face - Verify и Face - Find Similar. Срок действия хранимых функций распознавания лиц истечет и будет удален в момент, указанный faceIdTimeToLive после первоначального вызова обнаружения.
  • Необязательные параметры включают faceId, ориентиры и атрибуты. Атрибуты включают возраст, пол, headPose, улыбку, очки, эмоции, волосы, макияж, окклюзию, аксессуары, размытие, экспозицию, шум, маску и качествоForRecognition. Некоторые результаты, возвращаемые для определенных атрибутов, могут быть не очень точными.
  • Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
  • Для изображения можно вернуть до 100 лиц. Лица ранжируются по размеру прямоугольника от больших к маленьким.
  • Чтобы получить оптимальные результаты при запросе face - Identify, Face - Verify и Face - Find Similar ("returnFaceId" имеет значение true), используйте лица: фронтальные, четкие и с минимальным размером 200 x 200 пикселей (100 пикселей между глазами).
  • Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
  • Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
  • Предоставляются различные значения recognitionModel. Если требуются последующие операции, такие как Verify, Identify, Find Similar, укажите модель распознавания с параметром recognitionModel. Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, явно укажите нужную модель в этом параметре. После указания обнаруженные идентификаторы faceId будут связаны с указанной моделью распознавания. Дополнительные сведения см. в статье Указание модели распознавания.
detect_with_url(url, return_face_id=True, return_face_landmarks=False, return_face_attributes=None, recognition_model='recognition_01', return_recognition_model=False, detection_model='detection_01', face_id_time_to_live=86400, custom_headers=None, raw=False, **operation_config)

Параметры

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

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

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

значение по умолчанию: True
return_face_landmarks
bool

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

значение по умолчанию: False
return_face_attributes
list[str или FaceAttributeType]

Проанализируйте и верните один или несколько указанных атрибутов лица в строке, разделенной запятыми, например returnFaceAttributes=age,gender. Доступные атрибуты зависят от указанного параметра detectionModel. "detection_01" поддерживает возраст, пол, headPose, улыбку, лицевой стул, очки, эмоции, волосы, макияж, окклюзию, аксессуары, размытие, воздействие, шум и качествоForRecognition. Хотя "detection_02" не поддерживает атрибуты, а "detection_03" поддерживает только mask и qualityForRecognition. Кроме того, qualityForRecognition поддерживается только в том случае, если параметр "recognitionModel" указан как "recognition_03" или "recognition_04". Обратите внимание, что каждый анализ атрибутов лиц имеет дополнительные вычислительные и временные затраты.

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

Имя модели распознавания. Модель распознавания используется при извлечении признаков лиц и связывании с обнаруженными faceId, (Большим)FaceList или (Большим)PersonGroup. Имя модели распознавания можно указать при выполнении face - Detect или (Large)FaceList - Create или (Large)PersonGroup - Create. Значение по умолчанию — "recognition_01". Если требуется последняя модель, укажите нужную модель явным образом. Возможные значения: "recognition_01", "recognition_02", "recognition_03", "recognition_04".

значение по умолчанию: recognition_01
return_recognition_model
bool

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

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

Имя модели обнаружения. Модель обнаружения используется для обнаружения лиц на отправленном изображении. Имя модели обнаружения можно указать при выполнении face - Detect или (Large)FaceList - Add FaceList или (Large)PersonGroup - Add Face. Значение по умолчанию — "detection_01". Если требуется другая модель, укажите ее явным образом. Возможные значения: "detection_01", "detection_02", "detection_03".

значение по умолчанию: detection_01
face_id_time_to_live
int

Количество секунд для кэширования faceId. Поддерживаемый диапазон от 60 до 86400 секунд. Значение по умолчанию — 86400 (24 часа).

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

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

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

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

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

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

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

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

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

Исключения

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

find_similar

FaceId лица заданного запроса, поиск похожих лиц из массива faceId, списка лиц или большого списка лиц. Массив faceId содержит лица, созданные face — Detect With URL или Face — Detect With Stream, срок действия которых истекает в момент, указанный faceIdTimeToLive после создания. FaceListId создает faceList — create , содержащий persistedFaceIds, срок действия которых не истекает. Кроме того, largeFaceList — Create создает "largeFaceListId", содержащий persistedFaceIds, срок действия которых также не истекает. В зависимости от входных данных возвращенный список похожих лиц содержит faceIds или persistedFaceIds, ранжированные по подобию.
Функция Найти аналогичная имеет два режима работы: matchPerson и matchFace. MatchPerson — это режим по умолчанию, в котором он пытается найти лица одного и того же человека, как это возможно, с помощью внутренних пороговых значений одного и того же человека. Полезно найти другие фотографии известного человека. Обратите внимание, что пустой список возвращается, если ни один из лиц не проходит внутренние пороговые значения. Режим matchFace игнорирует пороговые значения для одного человека и в любом случае возвращает похожие лица, даже если сходство низкое. Его можно использовать в таких случаях, как поиск лиц знаменитостей.
"recognitionModel", связанный с faceId запроса, должен совпадать с "recognitionModel", используемым целевым массивом faceId, списком лиц или большим списком лиц. .

find_similar(face_id, face_list_id=None, large_face_list_id=None, face_ids=None, max_num_of_candidates_returned=20, mode='matchPerson', custom_headers=None, raw=False, **operation_config)

Параметры

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

FaceId лица запроса. Пользователь должен сначала вызвать Face — Detect, чтобы получить допустимый faceId. Обратите внимание, что этот идентификатор faceId не сохраняется и истекает в момент, указанный faceIdTimeToLive после вызова обнаружения.
face_list_id
str

Существующий определяемой пользователем уникальный список лиц-кандидатов, созданный в разделе Список лиц — создание списка лиц. Список лиц содержит набор объектов persistedFaceId, которые сохраняются и не истечет. Параметр faceListId, largeFaceListId и faceIds не должны предоставляться одновременно.

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

Существующий определяемые пользователем уникальные потенциальные большие списки лиц, созданные в largeFaceList — Create. Большой список лиц содержит набор сохраненных идентификаторовFaceId, которые сохраняются и никогда не истечет. Параметр faceListId, largeFaceListId и faceIds не должны предоставляться одновременно.

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

Массив потенциальных идентификаторов faceId. Все они создаются методом Face — Detect, и срок действия идентификаторов faceId истекает в момент, указанный faceIdTimeToLive после вызова обнаружения. Количество идентификаторов faceId ограничено 1000. Параметр faceListId, largeFaceListId и faceIds не должны предоставляться одновременно.

значение по умолчанию: None
max_num_of_candidates_returned
int

Количество возвращенных лиц, похожих на верхние. Допустимый диапазон — [1, 1000].

значение по умолчанию: 20
mode
str или FindSimilarMatchMode

Похожий режим поиска лиц. Это может быть matchPerson или matchFace. Возможные значения: matchPerson, matchFace.

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

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

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

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

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

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

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

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

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

Исключения

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

group

Разделяет лица-кандидаты на группы на основании сходства лиц.

  • Выходные данные — одна или несколько несвязанных групп лиц и messyGroup. Группа лиц содержит лица с похожим видом, часто одного и того же человека. Группы лиц ранжируются по размеру группы, т. е. количеству лиц. Обратите внимание, что лица, принадлежащие одному и тому же человеку, могут быть разделены на несколько групп в результате.
  • MessyGroup — это специальная группа лиц, содержащая лица, которые не могут найти похожие лица из исходных лиц. MessyGroup не будет отображаться в результате, если все лица нашли своих коллег.
  • Для API группы требуется по крайней мере 2 потенциальных лица и не более 1000. Мы рекомендуем попробовать Face — Проверка , если у вас есть только 2 лица кандидатов.
  • Идентификаторы faceId "recognitionModel", связанные с лицом запроса, должны совпадать. .
group(face_ids, custom_headers=None, raw=False, **operation_config)

Параметры

Имя Описание
face_ids
Обязательно
list[str]

Массив потенциальных идентификаторов faceId, созданных Face — Detect. Максимальное значение — 1000 лиц
custom_headers
dict

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

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

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

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

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

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

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

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

Исключения

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

identify

Идентификация типа "один ко многим" для поиска наиболее близких совпадений лица пользователя из конкретного запроса в группе пользователей или большой группе пользователей.
Для каждого лица в массиве faceIds функция Face Identify вычислит сходства между лицом запроса и всеми лицами в группе пользователей (заданной personGroupId) или большой группе пользователей (заданная largePersonGroupId) и возвращает людей-кандидатов для этого лица, ранжированных по достоверности сходства. Группа пользователей или большая группа пользователей должна быть обучена, чтобы подготовить ее к идентификации. Дополнительные сведения см . в разделах PersonGroup — Train и LargePersonGroup — Train.
Примечания:

  • Алгоритм позволяет независимо идентифицировать несколько лиц по одному запросу, но не более 10 лиц.
  • Каждый человек в группе или большой группе может иметь более одного лица, но не более 248 лиц.
  • Более высокое качество изображения лица означает лучшую точность идентификации. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Количество возвращаемых кандидатов ограничено значениями maxNumOfCandidatesReturned и confidenceThreshold. Если никто не идентифицируется, возвращенные кандидаты будут пустым массивом.
  • Попробуйте face — поиск похожих лиц, если вам нужно найти похожие лица из списка лиц или большого списка лиц вместо группы пользователей или большой группы пользователей.
  • FaceIds "recognitionModel", связанный с запросом faceId, должен совпадать с "recognitionModel", используемым целевой группой пользователей или группой больших пользователей. .
identify(face_ids, person_group_id=None, large_person_group_id=None, max_num_of_candidates_returned=1, confidence_threshold=None, custom_headers=None, raw=False, **operation_config)

Параметры

Имя Описание
face_ids
Обязательно
list[str]

Массив лиц запроса faceId, созданный face - Detect. Каждое лицо определяется независимо друг от друга. Допустимое число идентификаторов faceId находится в диапазоне от [1, 10].
person_group_id
str

PersonGroupId целевой группы пользователей, созданной personGroup — Create. Параметры personGroupId и largePersonGroupId не должны предоставляться одновременно.

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

LargePersonGroupId целевой группы больших пользователей, созданной largePersonGroup — Create. Параметры personGroupId и largePersonGroupId не должны предоставляться одновременно.

значение по умолчанию: None
max_num_of_candidates_returned
int

Диапазон maxNumOfCandidatesReturned находится в диапазоне от 1 до 100 (по умолчанию — 1).

значение по умолчанию: 1
confidence_threshold
float

Порог доверия идентификации, используемый для оценки принадлежности одного лица одному человеку. Диапазон confidenceThreshold равен [0, 1] (по умолчанию определяется алгоритмом).

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

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

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

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

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

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

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

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

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

Исключения

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

verify_face_to_face

Проверяет, принадлежат ли два лица одному пользователю или принадлежит ли лицо пользователю.
Примечания:

  • Более высокое качество изображения лица означает лучшую точность идентификации. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Для сценариев, которые чувствительны к точности, сделайте собственное суждение.
  • Идентификаторы faceId "recognitionModel", связанные с лицом запроса, должны совпадать с идентификатором распознавания, используемым целевым лицом, группой пользователей или группой больших пользователей. .
verify_face_to_face(face_id1, face_id2, custom_headers=None, raw=False, **operation_config)

Параметры

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

FaceId первого лица, поступает из Face — Detect
face_id2
Обязательно
str

FaceId второго лица, поступает из Face — Detect
custom_headers
dict

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

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

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

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

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

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

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

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

Исключения

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

verify_face_to_person

Проверьте, принадлежат ли два лица одному и тому же человеку. Сравнивает идентификатор лица с идентификатором пользователя.

verify_face_to_person(face_id, person_id, person_group_id=None, large_person_group_id=None, custom_headers=None, raw=False, **operation_config)

Параметры

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

FaceId лица, поступает из Face — Detect
person_id
Обязательно
str

Укажите определенного пользователя в группе пользователей или большой группе пользователей. PersonId создается в personGroup Person — Create или LargePersonGroup Person — Create.
person_group_id
str

Использование существующих personGroupId и personId для быстрой загрузки указанного пользователя. PersonGroupId создается в PersonGroup — Create. Параметры personGroupId и largePersonGroupId не должны предоставляться одновременно.

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

Использование существующих largePersonGroupId и personId для быстрой загрузки указанного пользователя. largePersonGroupId создается в LargePersonGroup — Create. Параметры personGroupId и largePersonGroupId не должны предоставляться одновременно.

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

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

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

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

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

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

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

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

VerifyResult или 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'>