Face class
Класс, представляющий лицо.
Конструкторы
| Face(Face |
Создайте лицо. |
Методы
| detect |
Обнаруживает человеческие лица на изображении, возвращает прямоугольники с лицами и при необходимости с faceId, ориентирами и атрибутами.
|
| detect |
|
| detect |
|
| detect |
Обнаруживает человеческие лица на изображении, возвращает прямоугольники с лицами и при необходимости с faceId, ориентирами и атрибутами.
|
| detect |
|
| detect |
|
| find |
FaceId лица заданного запроса, поиск похожих лиц из массива faceId, списка лиц или большого списка лиц. Массив faceId содержит лица, созданные face - Detect With URL-адрес или Face - Detect With Stream, срок действия которых истекает в момент, указанный faceIdTimeToLive после создания. FaceListId создает faceList — create , содержащий сохраненныеFaceIds, срок действия которых не истекает. Кроме того, largeFaceList — Create создает параметр largeFaceList — Create , содержащий сохраненныеFaceIds, срок действия которых также не истекает. В зависимости от входных данных возвращаемый список похожих лиц содержит идентификаторы faceId или persistedFaceId, ранжированные по сходству.
|
| find |
|
| find |
|
| group(string[], Request |
Разделяет лица-кандидаты на группы на основании сходства лиц.
|
| group(string[], Request |
|
| group(string[], Service |
|
| identify(string[], Face |
Идентификация типа "один ко многим" для поиска наиболее близких совпадений лица пользователя из конкретного запроса в группе пользователей или большой группе пользователей.
Примечания:
|
| identify(string[], Face |
|
| identify(string[], Service |
|
| verify |
Проверяет, принадлежат ли два лица одному пользователю или принадлежит ли лицо пользователю.
|
| verify |
|
| verify |
|
| verify |
Проверьте, принадлежат ли два лица одному и тому же человеку. Сравнивает идентификатор лица с идентификатором пользователя |
| verify |
|
| verify |
Сведения о конструкторе
Face(FaceClientContext)
Создайте лицо.
new Face(client: FaceClientContext)Параметры
- client
- FaceClientContext
Ссылка на клиент службы.
Сведения о методе
detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams)
Обнаруживает человеческие лица на изображении, возвращает прямоугольники с лицами и при необходимости с 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 пикселей. Изображениям с размерами выше 1920 x 1080 пикселей потребуется пропорционально больший минимальный размер лица.
- Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение модели обнаружения.
- Предоставляются различные значения recognitionModel. Если требуются последующие операции, такие как Verify, Identify, Find Similar, укажите модель распознавания с параметром recognitionModel. Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, явно укажите необходимую модель в этом параметре. После указания обнаруженные идентификаторы лиц будут связаны с указанной моделью распознавания. Дополнительные сведения см. в разделе Указание модели распознавания.
function detectWithStream(image: HttpRequestBody, options?: FaceDetectWithStreamOptionalParams): Promise<FaceDetectWithStreamResponse>Параметры
- image
- HttpRequestBody
Поток изображения.
Необязательные параметры
Возвращаемое значение
Promise<FaceDetectWithStreamResponse>
Promise<Models.FaceDetectWithStreamResponse>
detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams, ServiceCallback<DetectedFace[]>)
function detectWithStream(image: HttpRequestBody, options: FaceDetectWithStreamOptionalParams, callback: ServiceCallback<DetectedFace[]>)Параметры
- image
- HttpRequestBody
Поток изображения.
Необязательные параметры
- callback
Обратный вызов
detectWithStream(HttpRequestBody, ServiceCallback<DetectedFace[]>)
function detectWithStream(image: HttpRequestBody, callback: ServiceCallback<DetectedFace[]>)Параметры
- image
- HttpRequestBody
Поток изображения.
- callback
Обратный вызов
detectWithUrl(string, FaceDetectWithUrlOptionalParams)
Обнаруживает человеческие лица на изображении, возвращает прямоугольники с лицами и при необходимости с 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 пикселей. Изображениям с размерами выше 1920 x 1080 пикселей потребуется пропорционально больший минимальный размер лица.
Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Определение модели обнаружения.
Предоставляются различные значения recognitionModel. Если требуются последующие операции, такие как Verify, Identify, Find Similar, укажите модель распознавания с параметром recognitionModel. Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, явно укажите необходимую модель в этом параметре. После указания обнаруженные идентификаторы лиц будут связаны с указанной моделью распознавания. Дополнительные сведения см. в разделе Указание модели распознавания.
function detectWithUrl(url: string, options?: FaceDetectWithUrlOptionalParams): Promise<FaceDetectWithUrlResponse>Параметры
- url
-
string
Общедоступный URL-адрес изображения
- options
- FaceDetectWithUrlOptionalParams
Необязательные параметры
Возвращаемое значение
Promise<FaceDetectWithUrlResponse>
Promise<Models.FaceDetectWithUrlResponse>
detectWithUrl(string, FaceDetectWithUrlOptionalParams, ServiceCallback<DetectedFace[]>)
function detectWithUrl(url: string, options: FaceDetectWithUrlOptionalParams, callback: ServiceCallback<DetectedFace[]>)Параметры
- url
-
string
Общедоступный URL-адрес изображения
- options
- FaceDetectWithUrlOptionalParams
Необязательные параметры
- callback
Обратный вызов
detectWithUrl(string, ServiceCallback<DetectedFace[]>)
function detectWithUrl(url: string, callback: ServiceCallback<DetectedFace[]>)Параметры
- url
-
string
Общедоступный URL-адрес изображения
- callback
Обратный вызов
findSimilar(string, FaceFindSimilarOptionalParams)
FaceId лица заданного запроса, поиск похожих лиц из массива faceId, списка лиц или большого списка лиц. Массив faceId содержит лица, созданные face - Detect With URL-адрес или Face - Detect With Stream, срок действия которых истекает в момент, указанный faceIdTimeToLive после создания. FaceListId создает faceList — create , содержащий сохраненныеFaceIds, срок действия которых не истекает. Кроме того, largeFaceList — Create создает параметр largeFaceList — Create , содержащий сохраненныеFaceIds, срок действия которых также не истекает. В зависимости от входных данных возвращаемый список похожих лиц содержит идентификаторы faceId или persistedFaceId, ранжированные по сходству.
Функция Найти аналогичная имеет два режима работы: matchPerson и matchFace. MatchPerson — это режим по умолчанию, в котором он пытается найти лица одного и того же человека, насколько это возможно, с помощью внутренних пороговых значений одного и того же человека. Полезно найти другие фотографии известного человека. Обратите внимание, что пустой список будет возвращен, если ни один из лиц не проходит внутренние пороговые значения. Режим matchFace игнорирует пороговые значения для одного и того же человека и в любом случае возвращает похожие лица, даже если сходство низкое. Его можно использовать в таких случаях, как поиск знаменитостей глядя лица.
"recognitionModel", связанный с faceId запроса, должен совпадать с "recognitionModel", используемым целевым массивом faceId, списком лиц или большим списком лиц.
function findSimilar(faceId: string, options?: FaceFindSimilarOptionalParams): Promise<FaceFindSimilarResponse>Параметры
- faceId
-
string
FaceId лица запроса. Пользователю необходимо сначала вызвать Face — Detect, чтобы получить допустимый идентификатор faceId. Обратите внимание, что этот идентификатор faceId не сохраняется и истекает в момент, указанный faceIdTimeToLive после вызова обнаружения.
- options
- FaceFindSimilarOptionalParams
Необязательные параметры
Возвращаемое значение
Promise<FaceFindSimilarResponse>
Promise<Models.FaceFindSimilarResponse>
findSimilar(string, FaceFindSimilarOptionalParams, ServiceCallback<SimilarFace[]>)
function findSimilar(faceId: string, options: FaceFindSimilarOptionalParams, callback: ServiceCallback<SimilarFace[]>)Параметры
- faceId
-
string
FaceId лица запроса. Пользователю необходимо сначала вызвать Face — Detect, чтобы получить допустимый идентификатор faceId. Обратите внимание, что этот идентификатор faceId не сохраняется и истекает в момент, указанный faceIdTimeToLive после вызова обнаружения.
- options
- FaceFindSimilarOptionalParams
Необязательные параметры
- callback
Обратный вызов
findSimilar(string, ServiceCallback<SimilarFace[]>)
function findSimilar(faceId: string, callback: ServiceCallback<SimilarFace[]>)Параметры
- faceId
-
string
FaceId лица запроса. Пользователю необходимо сначала вызвать Face — Detect, чтобы получить допустимый идентификатор faceId. Обратите внимание, что этот идентификатор faceId не сохраняется и истекает в момент, указанный faceIdTimeToLive после вызова обнаружения.
- callback
Обратный вызов
group(string[], RequestOptionsBase)
Разделяет лица-кандидаты на группы на основании сходства лиц.
- Выходные данные — одна или несколько несвязанных групп лиц и messyGroup. Группа лиц содержит лица, которые имеют похожий вид, часто одного человека. Группы лиц ранжируются по размеру группы, т. е. количеству лиц. Обратите внимание, что лица, принадлежащие одному и тому же человеку, могут быть разделены на несколько групп в результате.
- MessyGroup — это специальная группа лиц, содержащая лица, которые не могут найти похожие лица из исходных лиц. MessyGroup не будет отображаться в результатах, если все лица нашли своих коллег.
- Для API группы требуется как минимум 2 лица-кандидаты и не более 1000. Мы рекомендуем попробовать распознавание лиц — проверка , если у вас есть только 2 лица кандидатов.
- Идентификаторы faceId "recognitionModel", связанные с лицом запроса, должны быть одинаковыми.
function group(faceIds: string[], options?: RequestOptionsBase): Promise<FaceGroupResponse>Параметры
- faceIds
-
string[]
Массив потенциальных идентификаторов faceId, созданных Face — Detect. Максимальное значение — 1000 лиц.
- options
- RequestOptionsBase
Необязательные параметры
Возвращаемое значение
Promise<FaceGroupResponse>
Promise<Models.FaceGroupResponse>
group(string[], RequestOptionsBase, ServiceCallback<GroupResult>)
function group(faceIds: string[], options: RequestOptionsBase, callback: ServiceCallback<GroupResult>)Параметры
- faceIds
-
string[]
Массив потенциальных идентификаторов faceId, созданных Face — Detect. Максимальное значение — 1000 лиц.
- options
- RequestOptionsBase
Необязательные параметры
- callback
Обратный вызов
group(string[], ServiceCallback<GroupResult>)
function group(faceIds: string[], callback: ServiceCallback<GroupResult>)Параметры
- faceIds
-
string[]
Массив потенциальных идентификаторов faceId, созданных Face — Detect. Максимальное значение — 1000 лиц.
- callback
Обратный вызов
identify(string[], FaceIdentifyOptionalParams)
Идентификация типа "один ко многим" для поиска наиболее близких совпадений лица пользователя из конкретного запроса в группе пользователей или большой группе пользователей.
Для каждого лица в массиве faceIds функция Распознавание лиц вычисляет сходства между лицом запроса и всеми лицами в группе пользователей (заданной personGroupId) или большой группе пользователей (заданной largePersonGroupId) и возвращает кандидатов для этого лица, ранжированных по достоверности сходства. Группа или большая группа пользователей должна быть обучена, чтобы подготовить ее к идентификации. Дополнительные возможности см. в разделах PersonGroup — Train и LargePersonGroup — Train.
Примечания:
- Алгоритм позволяет идентифицировать несколько лиц независимо по одному запросу, но не более 10 лиц.
- Каждый человек в группе пользователей или большой группе людей может иметь более одного лица, но не более 248 лиц.
- Более высокое качество изображения лица означает лучшую точность идентификации. Пожалуйста, рассмотрите высококачественные лица: фронтальные, четкие и размер лица 200 x 200 пикселей (100 пикселей между глазами) или больше.
- Количество возвращаемых кандидатов ограничивается maxNumOfCandidatesReturned и confidenceThreshold. Если пользователь не идентифицируется, возвращенные кандидаты будут пустым массивом.
- Попробуйте face — найти похожие лица, если вам нужно найти похожие лица из списка лиц или большого списка лиц, а не из группы пользователей или большой группы пользователей.
- Идентификаторы faceId "recognitionModel", связанные с лицами запроса, должны совпадать с идентификаторами распознавания, используемыми целевой или крупной группой пользователей.
function identify(faceIds: string[], options?: FaceIdentifyOptionalParams): Promise<FaceIdentifyResponse>Параметры
- faceIds
-
string[]
Массив лиц запроса faceId, созданный face — Detect. Каждое лицо идентифицируется независимо. Допустимое число идентификаторов лиц находится в диапазоне от [1, 10].
- options
- FaceIdentifyOptionalParams
Необязательные параметры
Возвращаемое значение
Promise<FaceIdentifyResponse>
Promise<Models.FaceIdentifyResponse>
identify(string[], FaceIdentifyOptionalParams, ServiceCallback<IdentifyResult[]>)
function identify(faceIds: string[], options: FaceIdentifyOptionalParams, callback: ServiceCallback<IdentifyResult[]>)Параметры
- faceIds
-
string[]
Массив лиц запроса faceId, созданный face — Detect. Каждое лицо идентифицируется независимо. Допустимое число идентификаторов лиц находится в диапазоне от [1, 10].
- options
- FaceIdentifyOptionalParams
Необязательные параметры
- callback
Обратный вызов
identify(string[], ServiceCallback<IdentifyResult[]>)
function identify(faceIds: string[], callback: ServiceCallback<IdentifyResult[]>)Параметры
- faceIds
-
string[]
Массив лиц запроса faceId, созданный face — Detect. Каждое лицо идентифицируется независимо. Допустимое число идентификаторов лиц находится в диапазоне от [1, 10].
- callback
Обратный вызов
verifyFaceToFace(string, string, RequestOptionsBase)
Проверяет, принадлежат ли два лица одному пользователю или принадлежит ли лицо пользователю.
Примечания:
- Более высокое качество изображения лица означает лучшую точность идентификации. Пожалуйста, рассмотрите высококачественные лица: фронтальные, четкие и размер лица 200 x 200 пикселей (100 пикселей между глазами) или больше.
- Для сценариев, чувствительных к точности, примите собственное решение.
- Идентификаторы faceId "recognitionModel", связанные с лицами запроса, должны совпадать с идентификатором распознавания, используемым целевым лицом, группой пользователей или большой группой пользователей.
function verifyFaceToFace(faceId1: string, faceId2: string, options?: RequestOptionsBase): Promise<FaceVerifyFaceToFaceResponse>Параметры
- faceId1
-
string
FaceId первого лица, поступает от Face — Detect
- faceId2
-
string
FaceId второго лица, поступает от Face — Detect
- options
- RequestOptionsBase
Необязательные параметры
Возвращаемое значение
Promise<FaceVerifyFaceToFaceResponse>
Promise<Models.FaceVerifyFaceToFaceResponse>
verifyFaceToFace(string, string, RequestOptionsBase, ServiceCallback<VerifyResult>)
function verifyFaceToFace(faceId1: string, faceId2: string, options: RequestOptionsBase, callback: ServiceCallback<VerifyResult>)Параметры
- faceId1
-
string
FaceId первого лица, поступает от Face — Detect
- faceId2
-
string
FaceId второго лица, поступает от Face — Detect
- options
- RequestOptionsBase
Необязательные параметры
- callback
Обратный вызов
verifyFaceToFace(string, string, ServiceCallback<VerifyResult>)
function verifyFaceToFace(faceId1: string, faceId2: string, callback: ServiceCallback<VerifyResult>)Параметры
- faceId1
-
string
FaceId первого лица, поступает от Face — Detect
- faceId2
-
string
FaceId второго лица, поступает от Face — Detect
- callback
Обратный вызов
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams)
Проверьте, принадлежат ли два лица одному и тому же человеку. Сравнивает идентификатор лица с идентификатором пользователя
function verifyFaceToPerson(faceId: string, personId: string, options?: FaceVerifyFaceToPersonOptionalParams): Promise<FaceVerifyFaceToPersonResponse>Параметры
- faceId
-
string
FaceId лица, поступает от Face — Detect
- personId
-
string
Укажите определенного пользователя в группе пользователей или большой группе пользователей. PersonId создается в personGroup Person — Create или LargePersonGroup Person — Create.
Необязательные параметры
Возвращаемое значение
Promise<FaceVerifyFaceToPersonResponse>
Promise<Models.FaceVerifyFaceToPersonResponse>
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams, ServiceCallback<VerifyResult>)
function verifyFaceToPerson(faceId: string, personId: string, options: FaceVerifyFaceToPersonOptionalParams, callback: ServiceCallback<VerifyResult>)Параметры
- faceId
-
string
FaceId лица, поступает от Face — Detect
- personId
-
string
Укажите определенного пользователя в группе пользователей или большой группе пользователей. PersonId создается в personGroup Person — Create или LargePersonGroup Person — Create.
Необязательные параметры
- callback
Обратный вызов
verifyFaceToPerson(string, string, ServiceCallback<VerifyResult>)
function verifyFaceToPerson(faceId: string, personId: string, callback: ServiceCallback<VerifyResult>)Параметры
- faceId
-
string
FaceId лица, поступает от Face — Detect
- personId
-
string
Укажите определенного пользователя в группе пользователей или большой группе пользователей. PersonId создается в personGroup Person — Create или LargePersonGroup Person — Create.
- callback
Обратный вызов