API распознавания лиц

API распознавания лиц Microsoft Cognitive Services позволяет обнаруживать, выявлять, анализировать, упорядочивать и тегировать лица в фотографиях.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Стандарт	Все Power Automate регионы
Логические приложения	Стандарт	Все регионы Logic Apps
Power Apps	Стандарт	Все Power Apps регионы
Power Automate	Стандарт	Все Power Automate регионы

Контакт
Имя	Microsoft
URL	Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps

Метаданные соединителя
Publisher	Microsoft
Веб-сайт	https://azure.microsoft.com/services/cognitive-services/face/

Для использования этой интеграции потребуется ресурс Cognitive Service на портале Azure. Вы получите конечную точку и ключ для проверки подлинности приложений. Чтобы сделать подключение, укажите ключ учетной записи, URL-адрес сайта и выберите "Создать подключение". Дополнительные сведения см. в статье об затратах на операции подключения.

Теперь вы готовы начать использовать эту интеграцию.

Подключение с помощью идентификатора Microsoft Entra

Чтобы создать подключения с идентификатором Microsoft Entra, необходимо добавить роль пользователя Cognitive Services в учетную запись для доступа. Чтобы использовать это подключение, необходимо ввести уникальный поддомен, связанный с ресурсом Cognitive Services, в вспомогательные операции.

Операции, не поддерживаемые проверкой подлинности идентификатора Microsoft Entra

При использовании проверки подлинности идентификатора Microsoft Entra id поддерживаются только действия версии 2. Устаревшие действия будут продолжать работать с Access Key проверкой подлинности, но при использовании с подключением идентификатора Microsoft Entra ID завершится ошибкой.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

Ключ API	Ключ API	Все регионы	Доступный для общего пользования
По умолчанию [не рекомендуется]	Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.	Все регионы	Недоступен для совместного использования

Ключ API

Идентификатор проверки подлинности: keyBasedAuth

Применимо: все регионы

Ключ API

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Ключ учетной записи	securestring	Ключ учетной записи Cognitive Services
URL-адрес сайта	струна	URL-адрес корневого сайта (пример: https://westus.api.cognitive.microsoft.com)

По умолчанию [не рекомендуется]

Применимо: все регионы

Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Ключ API	securestring	Ключ API	True
URL-адрес сайта	струна	URL-адрес корневого сайта (пример: https://westus.api.cognitive.microsoft.com ). Если url-адрес сайта не указан, по умолчанию будет иметь значение "https://westus.api.cognitive.microsoft.com".

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	1200	60 секунд

Действия

Добавление лица в список лиц	Добавьте лицо в список лиц.
Добавление лица в список лиц (версия 2)	Добавьте лицо в список лиц.
Добавление лица пользователя	Добавьте представителя лица для идентификации.
Добавление лица пользователя (версия 2)	Добавьте представителя лица для идентификации.
Обнаружение лиц	Обнаружение человеческих лиц в изображении и возврат расположения лиц, а также при необходимости с помощью faceIds, ориентиров и атрибутов.
Обнаружение лиц (версия 2)	Обнаружение человеческих лиц в изображении и возврат расположения лиц, а также при необходимости с помощью faceIds, ориентиров и атрибутов.
Поиск человека с лица	Проверьте, принадлежат ли два лица одному и тому же лицу или одному лицу.
Поиск человека с лица (V2)	Проверьте, принадлежат ли два лица одному и тому же лицу или одному лицу.
Получение группы пользователей	Получение сведений о группе пользователей, включая ее имя и userData.
Получение группы пользователей (версия 2)	Получение сведений о группе пользователей, включая ее имя и userData.
Получение лица	Получение сведений о сохраняемом лице, указанном в сохраненныхfaceId, personId и его принадлежности personGroupId.
Получение лица (V2)	Получение сведений о сохраняемом лице, указанном в сохраненныхfaceId, personId и его принадлежности personGroupId.
Получение пользователя (версия 2)	Получение сведений о человеке, включая зарегистрированные сохраненные лица, имя и userData.
Получение списка лиц	Получение сведений о списке лиц, включая faceListId, имя, userData и лица в списке лиц.
Получение списка лиц (версия 2)	Получение сведений о списке лиц, включая faceListId, имя, userData и лица в списке лиц.
Получение человека	Получение сведений о человеке, включая зарегистрированные сохраненные лица, имя и userData.
Создание группы пользователей	Создайте новую группу пользователей с указанным personGroupId, именем и предоставленным пользователем userData.
Создание группы пользователей (версия 2)	Создайте новую группу пользователей с указанным personGroupId, именем и предоставленным пользователем userData.
Создание пользователя	Создайте нового пользователя в указанной группе пользователей.
Создание пользователя (версия 2)	Создайте нового пользователя в указанной группе пользователей.
Создание списка лиц	Создайте пустой список лиц с указанным пользователем faceListId, именем и необязательным пользователем UserData.
Создание списка лиц (версия 2)	Создайте пустой список лиц с указанным пользователем faceListId, именем и необязательным пользователем UserData.

Добавление лица в список лиц

Идентификатор операции:

AddFaceToFaceList

Добавьте лицо в список лиц.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес изображения	url		string	Изображение должно быть JPEG, PNG, GIF(первый кадр) или BMP
Целевое лицо	targetFace		string	Прямоугольник лица, указывающий целевое лицо, добавляемое пользователю, в формате targetFace=left,width,height
Пользовательские данные	userData		string	Указанные пользователем данные о целевом лице, добавляемые для любой цели. Максимальная длина — 1 КБ.
Идентификатор списка лиц	faceListId	True	string	Допустимым символом является буква в нижнем регистре или цифра или '-' или '_', максимальная длина - 64.

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

Тело

AddPersonFaceResponse

Добавление лица в список лиц (версия 2)

Идентификатор операции:

AddFaceToFaceListV2

Добавьте лицо в список лиц.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
URL-адрес изображения	url		string	Изображение должно быть JPEG, PNG, GIF(первый кадр) или BMP
Целевое лицо	targetFace		string	Прямоугольник лица, указывающий целевое лицо, добавляемое пользователю, в формате targetFace=left,width,height
Пользовательские данные	userData		string	Указанные пользователем данные о целевом лице, добавляемые для любой цели. Максимальная длина — 1 КБ.
Идентификатор списка лиц	faceListId	True	string	Допустимым символом является буква в нижнем регистре или цифра или '-' или '_', максимальная длина - 64.

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

Тело

AddPersonFaceResponse

Добавление лица пользователя

Идентификатор операции:

AddPersonFace

Добавьте представителя лица для идентификации.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор группы пользователей	personGroupId	True	string	Группа пользователей
Идентификатор пользователя	personId	True	string	Целевой пользователь, к которому добавляется лицо.
URL-адрес изображения	url	True	string	Изображение должно быть JPEG, PNG, GIF(первый кадр) или BMP
Целевое лицо	targetFace		string	Прямоугольник лица, указывающий целевое лицо, добавляемое пользователю, в формате targetFace=left,width,height
Пользовательские данные	userData		string	Указанные пользователем данные о целевом лице, добавляемые для любой цели. Максимальная длина — 1 КБ.

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

Тело

AddPersonFaceResponse

Добавление лица пользователя (версия 2)

Идентификатор операции:

AddPersonFaceV2

Добавьте представителя лица для идентификации.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
Идентификатор группы пользователей	personGroupId	True	string	Группа пользователей
Идентификатор пользователя	personId	True	string	Целевой пользователь, к которому добавляется лицо.
URL-адрес изображения	url	True	string	Изображение должно быть JPEG, PNG, GIF(первый кадр) или BMP
Целевое лицо	targetFace		string	Прямоугольник лица, указывающий целевое лицо, добавляемое пользователю, в формате targetFace=left,width,height
Пользовательские данные	userData		string	Указанные пользователем данные о целевом лице, добавляемые для любой цели. Максимальная длина — 1 КБ.

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

Тело

AddPersonFaceResponse

Обнаружение лиц

Идентификатор операции:

Detect

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес изображения	url	True	string	Изображение должно быть JPEG, PNG, GIF(первый кадр) или BMP

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

Товары

DetectResponse

Обнаружение лиц (версия 2)

Идентификатор операции:

DetectV2

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
URL-адрес изображения	url	True	string	Изображение должно быть JPEG, PNG, GIF(первый кадр) или BMP

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

Товары

DetectResponse

Поиск человека с лица

Идентификатор операции:

Verify

Проверьте, принадлежат ли два лица одному и тому же лицу или одному лицу.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор лица	faceId	True	string	Уникальный идентификатор лица, обнаруженного. Срок действия истекает через 24 часа после вызова обнаружения.
Идентификатор группы пользователей	personGroupId	True	string	Идентификатор группы пользователей, созданный в API распознавания лиц. Создание действия группы пользователей.
Идентификатор пользователя	personId	True	string	Идентификатор пользователя, созданный в API распознавания лиц . Создание действия пользователя.

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

Тело

VerifyResponse

Поиск человека с лица (V2)

Идентификатор операции:

VerifyV2

Проверьте, принадлежат ли два лица одному и тому же лицу или одному лицу.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
Идентификатор лица	faceId	True	string	Уникальный идентификатор лица, обнаруженного. Срок действия истекает через 24 часа после вызова обнаружения.
Идентификатор группы пользователей	personGroupId	True	string	Идентификатор группы пользователей, созданный в API распознавания лиц. Создание действия группы пользователей.
Идентификатор пользователя	personId	True	string	Идентификатор пользователя, созданный в API распознавания лиц . Создание действия пользователя.

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

Тело

VerifyResponse

Получение группы пользователей

Идентификатор операции:

GetPersonGroup

Получение сведений о группе пользователей, включая ее имя и userData.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор группы пользователей	personGroupId	True	string	Идентификатор группы целевого пользователя.

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

Тело

GetPersonGroupResponse

Получение группы пользователей (версия 2)

Идентификатор операции:

GetPersonGroupV2

Получение сведений о группе пользователей, включая ее имя и userData.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
Идентификатор группы пользователей	personGroupId	True	string	Идентификатор группы целевого пользователя.

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

Тело

GetPersonGroupResponse

Получение лица

Идентификатор операции:

GetPersonFace

Получение сведений о сохраняемом лице, указанном в сохраненныхfaceId, personId и его принадлежности personGroupId.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор группы пользователей	personGroupId	True	string	Указание группы пользователей, содержащей целевого пользователя.
Идентификатор пользователя	personId	True	string	Указание целевого пользователя, которому принадлежит лицо.
Идентификатор сохраняемого лица	persistedFaceId	True	string	СохраненныйFaceId целевого объекта сохранялся лицом человека.

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

Тело

GetPersonFaceResponse

Получение лица (V2)

Идентификатор операции:

GetPersonFaceV2

Получение сведений о сохраняемом лице, указанном в сохраненныхfaceId, personId и его принадлежности personGroupId.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
Идентификатор группы пользователей	personGroupId	True	string	Указание группы пользователей, содержащей целевого пользователя.
Идентификатор пользователя	personId	True	string	Указание целевого пользователя, которому принадлежит лицо.
Идентификатор сохраняемого лица	persistedFaceId	True	string	СохраненныйFaceId целевого объекта сохранялся лицом человека.

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

Тело

GetPersonFaceResponse

Получение пользователя (версия 2)

Идентификатор операции:

GetPersonV2

Получение сведений о человеке, включая зарегистрированные сохраненные лица, имя и userData.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
Идентификатор группы пользователей	personGroupId	True	string	Указание группы пользователей, содержащей целевого пользователя.
Идентификатор пользователя	personId	True	string	Указание целевого пользователя.

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

Тело

GetPersonResponse

Получение списка лиц

Идентификатор операции:

GetFaceList

Получение сведений о списке лиц, включая faceListId, имя, userData и лица в списке лиц.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор списка лиц	faceListId	True	string	faceListId целевого списка лиц.

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

Тело

GetFaceListResponse

Получение списка лиц (версия 2)

Идентификатор операции:

GetFaceListV2

Получение сведений о списке лиц, включая faceListId, имя, userData и лица в списке лиц.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
Идентификатор списка лиц	faceListId	True	string	faceListId целевого списка лиц.

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

Тело

GetFaceListResponse

Получение человека

Идентификатор операции:

GetPerson

Получение сведений о человеке, включая зарегистрированные сохраненные лица, имя и userData.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор группы пользователей	personGroupId	True	string	Указание группы пользователей, содержащей целевого пользователя.
Идентификатор пользователя	personId	True	string	Указание целевого пользователя.

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

Тело

GetPersonResponse

Создание группы пользователей

Идентификатор операции:

CreatePersonGroup

Создайте новую группу пользователей с указанным personGroupId, именем и предоставленным пользователем userData.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор группы пользователей	personGroupId	True	string	Новый идентификатор группы person (допустимые символы включают числа, английские буквы в нижнем регистре, "-" и "_")
Имя	name	True	string	Отображаемое имя группы пользователей. Максимальная длина — 128.
Пользовательские данные	userData		string	Предоставленные пользователем данные, подключенные к группе пользователей. Ограничение размера составляет 16 КБ.

Создание группы пользователей (версия 2)

Идентификатор операции:

CreatePersonGroupV2

Создайте новую группу пользователей с указанным personGroupId, именем и предоставленным пользователем userData.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
Идентификатор группы пользователей	personGroupId	True	string	Новый идентификатор группы person (допустимые символы включают числа, английские буквы в нижнем регистре, "-" и "_")
Имя	name	True	string	Отображаемое имя группы пользователей. Максимальная длина — 128.
Пользовательские данные	userData		string	Предоставленные пользователем данные, подключенные к группе пользователей. Ограничение размера составляет 16 КБ.

Создание пользователя

Идентификатор операции:

CreatePerson

Создайте нового пользователя в указанной группе пользователей.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор группы пользователей	personGroupId	True	string	Указание целевой группы пользователей для создания пользователя.
Имя	name	True	string	Отображаемое имя целевого пользователя. Максимальная длина — 128.
Пользовательские данные	userData		string	Необязательные поля для предоставленных пользователем данных, подключенных к человеку. Ограничение размера составляет 16 КБ.

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

Тело

CreatePersonResponse

Создание пользователя (версия 2)

Идентификатор операции:

CreatePersonV2

Создайте нового пользователя в указанной группе пользователей.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
Идентификатор группы пользователей	personGroupId	True	string	Указание целевой группы пользователей для создания пользователя.
Имя	name	True	string	Отображаемое имя целевого пользователя. Максимальная длина — 128.
Пользовательские данные	userData		string	Необязательные поля для предоставленных пользователем данных, подключенных к человеку. Ограничение размера составляет 16 КБ.

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

Тело

CreatePersonResponse

Создание списка лиц

Идентификатор операции:

CreateFaceList

Создайте пустой список лиц с указанным пользователем faceListId, именем и необязательным пользователем UserData.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор списка лиц	faceListId	True	string	Допустимый символ — буква в нижнем регистре или цифре или "-" или "_", максимальная длина составляет 64
Имя списка лиц	name	True	string	Имя созданного списка лиц, максимальная длина — 128.
Пользовательские данные	userData		string	Необязательные пользовательские данные для списка лиц. Длина не должна превышать 16 КБ.

Создание списка лиц (версия 2)

Идентификатор операции:

CreateFaceListV2

Создайте пустой список лиц с указанным пользователем faceListId, именем и необязательным пользователем UserData.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поддомен ресурсов или регион	subdomain	True	string	Поддомен Azure или географический регион (например, westus)
Идентификатор списка лиц	faceListId	True	string	Допустимый символ — буква в нижнем регистре или цифре или "-" или "_", максимальная длина составляет 64
Имя списка лиц	name	True	string	Имя созданного списка лиц, максимальная длина — 128.
Пользовательские данные	userData		string	Необязательные пользовательские данные для списка лиц. Длина не должна превышать 16 КБ.

Определения

DetectResponse

Имя	Путь	Тип	Описание
Идентификатор лица	faceId	string	Уникальный идентификатор лица, обнаруженного. Срок действия истекает через 24 часа после вызова обнаружения.
Верх	faceRectangle.top	integer	Параметры прямоугольника для расположения лица на изображении.
Лево	faceRectangle.left	integer	Параметры прямоугольника для расположения лица на изображении.
Ширина	faceRectangle.width	integer	Параметры прямоугольника для расположения лица на изображении.
Высота	faceRectangle.height	integer	Параметры прямоугольника для расположения лица на изображении.
Левый учащийся X	faceLandmarks.pupilLeft.x	float	Координата x левого ученика.
Левый ученик Y	faceLandmarks.pupilLeft.y	float	Координата y левого ученика.
Правое учащееся X	faceLandmarks.pupilRight.x	float	Координата x правого ученика.
Правый ученик Y	faceLandmarks.pupilRight.y	float	Координата y правого ученика.
Кончик носа X	faceLandmarks.noseTip.x	float	Координата x кончика носа.
Кончик носа Y	faceLandmarks.noseTip.y	float	Координата y кончика носа.
Рот слева X	faceLandmarks.mouthLeft.x	float	Координата x для левой стороны рта.
Рот слева от Y	faceLandmarks.mouthLeft.y	float	Координата y для левой стороны рта.
Рот справа X	faceLandmarks.mouthRight.x	float	Координата x для правой стороны рта.
Рот справа от Y	faceLandmarks.mouthRight.y	float	Координата y для правой стороны рта.
Внешний левый бровь X	faceLandmarks.eyebrowLeftOuter.x	float	Координата x для внешней стороны левой брови.
Внешний левый бровь Y	faceLandmarks.eyebrowLeftOuter.y	float	Координата y для внешней стороны левой брови.
Внутренний левый Eybrow X	faceLandmarks.eyebrowLeftInner.x	float	Координата x для внутренней стороны левой брови.
Внутренняя левая бровь Y	faceLandmarks.eyebrowLeftInner.y	float	Координата y для внутренней стороны левой брови.
Внешний левый глаз X	faceLandmarks.eyeLeftOuter.x	float	Координата x для внешней стороны левого глаза.
Внешний левый глаз Y	faceLandmarks.eyeLeftOuter.y	float	Координата y для внешней стороны левого глаза.
Верхняя часть левого глаза X	faceLandmarks.eyeLeftTop.x	float	Координата x для верхней части левого глаза.
Верхняя часть левого глаза Y	faceLandmarks.eyeLeftTop.y	float	Координата y для верхней части левого глаза.
Нижняя часть левого глаза X	faceLandmarks.eyeLeftBottom.x	float	Координата x для нижней части левого глаза.
Внизу левого глаза Y	faceLandmarks.eyeLeftBottom.y	float	Координата y для нижней части левого глаза.
Внутренний левый глаз X	faceLandmarks.eyeLeftInner.x	float	Координата x для внутренней стороны левого глаза.
Внутренний левый глаз Y	faceLandmarks.eyeLeftInner.y	float	Координата y для внутренней стороны левого глаза.
Внутренний правый Eybrow X	faceLandmarks.eyebrowRightInner.x	float	Координата x для внутренней стороны правой брови.
Внутренний правый бровь Y	faceLandmarks.eyebrowRightInner.y	float	Координата y для внутренней стороны правой брови.
Внешний правый бровь X	faceLandmarks.eyebrowRightOuter.x	float	Координата x для внешней стороны правой брови.
Внешний правый бровь Y	faceLandmarks.eyebrowRightOuter.y	float	Координата y для внешней стороны правой брови.
Внутренний правый глаз X	faceLandmarks.eyeRightInner.x	float	Координата x для внутренней стороны правого глаза.
Внутренний правый глаз Y	faceLandmarks.eyeRightInner.y	float	Координата y для внутренней стороны правого глаза.
Верхняя часть правого глаза X	faceLandmarks.eyeRightTop.x	float	Координата x для верхней части правого глаза.
Верхняя часть правого глаза Y	faceLandmarks.eyeRightTop.y	float	Координата y для верхней части правого глаза.
Внизу правого глаза X	faceLandmarks.eyeRightBottom.x	float	Координата x для нижней части правого глаза.
Внизу правого глаза Y	faceLandmarks.eyeRightBottom.y	float	Координата y для нижней части правого глаза.
Внешний правый глаз X	faceLandmarks.eyeRightOuter.x	float	Координата x для внешней стороны правого глаза.
Внешний правый глаз Y	faceLandmarks.eyeRightOuter.y	float	Координата y для внешней стороны правого глаза.
Левый корень носа X	faceLandmarks.noseRootLeft.x	float	Координата x для левой стороны корня носа.
Левый корень носа Y	faceLandmarks.noseRootLeft.y	float	Координата y для левой стороны корня носа.
Правый корень носа X	faceLandmarks.noseRootRight.x	float	Координата x для правой стороны корня носа.
Правый корень носа Y	faceLandmarks.noseRootRight.y	float	Координата y для правой стороны корня носа.
Верхняя часть левого носа Алтарь X	faceLandmarks.noseLeftAlarTop.x	float	Координата x для верхней части левого алтаря носа.
Верхняя часть левого носа Алтарь Y	faceLandmarks.noseLeftAlarTop.y	float	Координата y для верхней части левого носового алтаря.
Верхняя часть правого носа Алтарь X	faceLandmarks.noseRightAlarTop.x	float	Координата x для верхней части правого алтаря носа.
Верхняя часть правого носа Алтарь Y	faceLandmarks.noseRightAlarTop.y	float	Координата y для верхней части правого алтаря носа.
Совет левого носа Алтарь из X	faceLandmarks.noseLeftAlarOutTip.x	float	Координата x для кончика левого носового алтаря.
Совет левого носа Алтарь из Y	faceLandmarks.noseLeftAlarOutTip.y	float	Координата y для кончика левого носового алтаря/
Совет правого носа Алтарь из X	faceLandmarks.noseRightAlarOutTip.x	float	Координата x для кончика правого носового алтаря.
Совет правого носа Алтарь из Y	faceLandmarks.noseRightAlarOutTip.y	float	Координата y для кончика правого носового алтаря.
Верхняя губа X	faceLandmarks.upperLipTop.x	float	Координата x для верхней губы.
Верхняя губа Y	faceLandmarks.upperLipTop.y	float	Координата y для верхней губы.
Нижняя часть верхней губы X	faceLandmarks.upperLipBottom.x	float	Координата x для нижней части верхней губы.
Нижняя верхняя губа Y	faceLandmarks.upperLipBottom.y	float	Координата y для нижней части верхней губы.
Верхняя часть под губой X	faceLandmarks.underLipTop.x	float	Координата x для верхней части губы.
Верхняя часть под губой Y	faceLandmarks.underLipTop.y	float	Координата y для верхней части губы.
Нижняя часть под губой X	faceLandmarks.underLipBottom.x	float	Координата x для нижней части губы.
Нижняя часть под губой Y	faceLandmarks.underLipBottom.y	float	Координата y для нижней части губы.
Поле головы позы	faceAttributes.headPose.pitch	float	Зарезервированное поле всегда возвращает значение 0.
Свертка головы	faceAttributes.headPose.roll	float	Свернуть позу головы.
Голова Поза Яв	faceAttributes.headPose.yaw	float	Яж позу головы.
Очки	faceAttributes.glasses	string	Тип очков.

AddPersonFaceResponse

Имя	Путь	Тип	Описание
Идентификатор сохраняемого лица	persistedFaceId	string

GetPersonGroupResponse

Имя	Путь	Тип	Описание
Идентификатор группы пользователей	personGroupId	string
Имя	name	string
userData	userData	string

GetFaceListResponse

Имя	Путь	Тип	Описание
Сохраненные лица	persistedFaces	array of object
Идентификатор сохраняемого лица	persistedFaces.persistedFaceId	string	Идентификатор лица.
Пользовательские данные	persistedFaces.userData	string	Предоставленные пользователем данные, подключенные к каждому лицу.
Идентификатор списка лиц	faceListId	string	faceListId целевого списка лиц.
Имя	name	string	Отображаемое имя списка лиц.
Пользовательские данные	userData	string	Предоставленные пользователем данные, подключенные к списку лиц.

GetPersonFaceResponse

Имя	Путь	Тип	Описание
Идентификатор сохраняемого лица	persistedFaceId	string
userData	userData	string

CreatePersonResponse

Имя	Путь	Тип	Описание
Идентификатор пользователя	personId	string

GetPersonResponse

Имя	Путь	Тип	Описание
Идентификатор пользователя	personId	string
Сохраненные идентификаторы лиц	persistedFaceIds	array of object
Идентификатор сохраняемого лица	persistedFaceIds.persistedFaceId	string
Имя	name	string
Пользовательские данные	userData	string

VerifyResponse

Имя	Путь	Тип	Описание
Идентичен	isIdentical	boolean	Истина, если два лица принадлежат одному и тому же лицу или лицо принадлежит человеку, в противном случае ложно.
Достоверность	confidence	float	Число указывает на достоверность сходства в том, принадлежат ли два лица одному и тому же человеку, или же лицо принадлежит этому человеку.