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

LargeFaceListOperations Класс

  • Ссылка

Операции LargeFaceListOperations.

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

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

Конструктор

LargeFaceListOperations(client, config, serializer, deserializer)

Параметры

client
Обязательно

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

config
Обязательно

Настройка клиента службы.

serializer
Обязательно

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

deserializer
Обязательно

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

Методы

add_face_from_stream

Добавление лица в указанный большой список лиц, до 1 000 000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере, пока не будет вызван метод LargeFaceList Face — Delete или LargeFaceList — Delete .
Примечание. 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. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение модели обнаружения. Quota:
  • Квота подписки бесплатного уровня: 1000 лиц на большой список лиц.
  • Квота на подписку уровня S0: 1 000 000 лиц на большой список лиц.
add_face_from_url

Добавление лица в указанный большой список лиц, до 1 000 000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере, пока не будет вызван метод LargeFaceList Face — Delete или LargeFaceList — Delete .
Примечание. 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. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение квоты модели обнаружения :
  • Квота подписки бесплатного уровня: 1000 лиц на большой список лиц.
  • Квота на подписку уровня S0: 1 000 000 лиц на большой список лиц.
create

Создайте пустой большой список лиц с указанным пользователем largeFaceListId, именем, необязательным userData и recognitionModel.
Большой список лиц — это список лиц, до 1 000 000 лиц, используемый face - Find Similar.
После создания пользователь должен использовать LargeFaceList Face - Add для импорта лиц и LargeFaceList - Train, чтобы подготовить его к face - Find Similar. Образ не будет сохранен. На сервере сохраняются только извлеченные функции распознавания лиц до вызова LargeFaceList — Delete .
Функция "Поиск похожих" используется для таких сценариев, как поиск лиц, похожих на знаменитостей, аналогичная фильтрация лиц или для легкой идентификации лиц. Но если фактическое использование заключается в идентификации человека, используйте PersonGroup / LargePersonGroup и Face - Identify.
Для связи с этим большим списком лиц следует указать "recognitionModel". Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, укажите необходимую модель в этом параметре. Новые лица, добавленные в существующий большой список лиц, будут использовать модель распознавания, уже связанную с коллекцией. Существующие функции распознавания лиц в большом списке лиц нельзя обновить до функций, извлеченных другой версией модели распознавания. См. раздел Указание модели распознавания. Квота на большой список лиц:

  • Квота подписки бесплатного уровня: 64 больших списка лиц.
  • Квота на подписку уровня S0: 1 000 000 больших списков лиц.
delete

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

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

Получение большого списка лиц, имя, userData и recognitionModel большого списка лиц.
get_face

Получение сведений о сохраненном лице (заданном параметром persistedFaceId и его принадлежности largeFaceListId).
get_training_status

Получение состояния обучения большого списка лиц (завершенного или текущего).
list

Список больших лиц содержит сведения о largeFaceListId, name, userData и recognitionModel.
Чтобы получить сведения о лицах в largeFaceList, используйте LargeFaceList Face — Get

  • Большие списки лиц хранятся в алфавитном порядке largeFaceListId.
  • Параметр start (string, необязательный) — это предоставленное пользователем значение largeFaceListId, возвращаемое записями с большими идентификаторами по сравнению со строками. Для параметра "start" задано пустое значение, указывающее на возврат из первого элемента.
  • Параметр top (int, необязательный) указывает количество возвращаемых записей. В одном вызове можно вернуть не более 1000 записей. Чтобы получить дополнительные сведения, можно указать "start" с идентификатором последнего возвращенного элемента текущего вызова.
    Например, всего 5 больших списков пользователей: "list1", ..., "list5".
    "start=&top=" вернет все 5 списков.
    "start=&top=2" возвращает "list1", "list2".
    "start=list2&top=3" возвращает "list3", "list4", "list5". .
list_faces

Вывод списка всех лиц в большом списке лиц и получение сведений о лицах (включая userData и persistedFaceId зарегистрированных лиц лиц).
train

Поставить в очередь задачу обучения с большим списком лиц. Задача обучения может быть запущена не сразу.
update

Обновление сведений о большом списке лиц.
update_face

Обновление поля userData сохраненного лица.

add_face_from_stream

Добавление лица в указанный большой список лиц, до 1 000 000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере, пока не будет вызван метод LargeFaceList Face — Delete или LargeFaceList — Delete .
Примечание. 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. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение модели обнаружения. Quota:
  • Квота подписки бесплатного уровня: 1000 лиц на большой список лиц.
  • Квота на подписку уровня S0: 1 000 000 лиц на большой список лиц.
add_face_from_stream(large_face_list_id, image, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, callback=None, **operation_config)

Параметры

large_face_list_id
str
Обязательно

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

image
Generator
Обязательно

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

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

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

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

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

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

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

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

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

PersistedFace,
ClientRawResponse

Исключения

APIErrorException

add_face_from_url

Добавление лица в указанный большой список лиц, до 1 000 000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере, пока не будет вызван метод LargeFaceList Face — Delete или LargeFaceList — Delete .
Примечание. 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. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение квоты модели обнаружения :
  • Квота подписки бесплатного уровня: 1000 лиц на большой список лиц.
  • Квота на подписку уровня S0: 1 000 000 лиц на большой список лиц.
add_face_from_url(large_face_list_id, url, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, **operation_config)

Параметры

large_face_list_id
str
Обязательно

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

url
str
Обязательно

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

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

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

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

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

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

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

PersistedFace,
ClientRawResponse

Исключения

APIErrorException

create

Создайте пустой большой список лиц с указанным пользователем largeFaceListId, именем, необязательным userData и recognitionModel.
Большой список лиц — это список лиц, до 1 000 000 лиц, используемый face - Find Similar.
После создания пользователь должен использовать LargeFaceList Face - Add для импорта лиц и LargeFaceList - Train, чтобы подготовить его к face - Find Similar. Образ не будет сохранен. На сервере сохраняются только извлеченные функции распознавания лиц до вызова LargeFaceList — Delete .
Функция "Поиск похожих" используется для таких сценариев, как поиск лиц, похожих на знаменитостей, аналогичная фильтрация лиц или для легкой идентификации лиц. Но если фактическое использование заключается в идентификации человека, используйте PersonGroup / LargePersonGroup и Face - Identify.
Для связи с этим большим списком лиц следует указать "recognitionModel". Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, укажите необходимую модель в этом параметре. Новые лица, добавленные в существующий большой список лиц, будут использовать модель распознавания, уже связанную с коллекцией. Существующие функции распознавания лиц в большом списке лиц нельзя обновить до функций, извлеченных другой версией модели распознавания. См. раздел Указание модели распознавания. Квота на большой список лиц:

  • Квота подписки бесплатного уровня: 64 больших списка лиц.
  • Квота на подписку уровня S0: 1 000 000 больших списков лиц.
create(large_face_list_id, name, user_data=None, recognition_model='recognition_01', custom_headers=None, raw=False, **operation_config)

Параметры

large_face_list_id
str
Обязательно

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

name
str
Обязательно

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

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

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

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

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

None,
ClientRawResponse

Исключения

APIErrorException

delete

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

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

Параметры

large_face_list_id
str
Обязательно

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

None,
ClientRawResponse

Исключения

APIErrorException

delete_face

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

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

Параметры

large_face_list_id
str
Обязательно

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

persisted_face_id
str
Обязательно

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

None,
ClientRawResponse

Исключения

APIErrorException

get

Получение большого списка лиц, имя, userData и recognitionModel большого списка лиц.

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

Параметры

large_face_list_id
str
Обязательно

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

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

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

LargeFaceList,
ClientRawResponse

Исключения

APIErrorException

get_face

Получение сведений о сохраненном лице (заданном параметром persistedFaceId и его принадлежности largeFaceListId).

get_face(large_face_list_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)

Параметры

large_face_list_id
str
Обязательно

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

persisted_face_id
str
Обязательно

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

PersistedFace,
ClientRawResponse

Исключения

APIErrorException

get_training_status

Получение состояния обучения большого списка лиц (завершенного или текущего).

get_training_status(large_face_list_id, custom_headers=None, raw=False, **operation_config)

Параметры

large_face_list_id
str
Обязательно

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

TrainingStatus,
ClientRawResponse

Исключения

APIErrorException

list

Список больших лиц содержит сведения о largeFaceListId, name, userData и recognitionModel.
Чтобы получить сведения о лицах в largeFaceList, используйте LargeFaceList Face — Get

  • Большие списки лиц хранятся в алфавитном порядке largeFaceListId.
  • Параметр start (string, необязательный) — это предоставленное пользователем значение largeFaceListId, возвращаемое записями с большими идентификаторами по сравнению со строками. Для параметра "start" задано пустое значение, указывающее на возврат из первого элемента.
  • Параметр top (int, необязательный) указывает количество возвращаемых записей. В одном вызове можно вернуть не более 1000 записей. Чтобы получить дополнительные сведения, можно указать "start" с идентификатором последнего возвращенного элемента текущего вызова.
    Например, всего 5 больших списков пользователей: "list1", ..., "list5".
    "start=&top=" вернет все 5 списков.
    "start=&top=2" возвращает "list1", "list2".
    "start=list2&top=3" возвращает "list3", "list4", "list5". .
list(return_recognition_model=False, start=None, top=None, custom_headers=None, raw=False, **operation_config)

Параметры

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

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

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

Начало возврата идентификатора большого списка лиц (используется для перечисления диапазона больших списков лиц).

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

Число больших списков лиц, возвращаемых начиная с идентификатора большого списка лиц, указанного параметром start.

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

list[LargeFaceList],
ClientRawResponse

Исключения

APIErrorException

list_faces

Вывод списка всех лиц в большом списке лиц и получение сведений о лицах (включая userData и persistedFaceId зарегистрированных лиц лиц).

list_faces(large_face_list_id, start=None, top=None, custom_headers=None, raw=False, **operation_config)

Параметры

large_face_list_id
str
Обязательно

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

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

Запуск возвращаемого идентификатора лица (используется для перечисления диапазона лиц).

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

Число возвращаемых лиц, начиная с идентификатора лица, указанного параметром start.

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

list[PersistedFace],
ClientRawResponse

Исключения

APIErrorException

train

Поставить в очередь задачу обучения с большим списком лиц. Задача обучения может быть запущена не сразу.

train(large_face_list_id, custom_headers=None, raw=False, **operation_config)

Параметры

large_face_list_id
str
Обязательно

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

None,
ClientRawResponse

Исключения

APIErrorException

update

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

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

Параметры

large_face_list_id
str
Обязательно

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

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

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

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

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

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

None,
ClientRawResponse

Исключения

APIErrorException

update_face

Обновление поля userData сохраненного лица.

update_face(large_face_list_id, persisted_face_id, user_data=None, custom_headers=None, raw=False, **operation_config)

Параметры

large_face_list_id
str
Обязательно

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

persisted_face_id
str
Обязательно

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

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

Предоставленные пользователем данные, прикрепленные к лицу. Ограничение на размер составляет 1 КБ.

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

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

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

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

operation_config
Обязательно

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

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

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

Возвращаемый тип

None,
ClientRawResponse

Исключения

APIErrorException

Атрибуты

models 

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