Interfejs API rozpoznawania twarzy
Interfejs API rozpoznawania twarzy usług Microsoft Cognitive Services umożliwia wykrywanie, identyfikowanie, analizowanie, organizowanie i tagowanie twarzy na zdjęciach.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Wszystkie regiony usługi Power Automate |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps |
| Power Apps | Standard | Wszystkie regiony usługi Power Apps |
| Power Automate | Standard | Wszystkie regiony usługi Power Automate |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL |
Obsługa usługi Microsoft LogicApps Pomoc techniczna usługi Microsoft Power Automate Obsługa usługi Microsoft Power Apps |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://azure.microsoft.com/services/cognitive-services/face/ |
Do korzystania z tej integracji potrzebny będzie zasób usługi Cognitive Service w witrynie Azure Portal. Otrzymasz punkt końcowy i klucz do uwierzytelniania aplikacji. Aby nawiązać połączenie, podaj klucz konta, adres URL witryny i wybierz pozycję Utwórz połączenie. Aby uzyskać informacje na temat kosztów operacji w połączeniu, dowiedz się więcej tutaj.
Teraz możesz rozpocząć korzystanie z tej integracji.
Nawiązywanie połączenia za pomocą identyfikatora Entra firmy Microsoft
Aby utworzyć połączenia z identyfikatorem Entra firmy Microsoft, musisz dodać rolę użytkownika usług Cognitive Services do swojego konta, aby uzyskać dostęp. Aby użyć tego połączenia, musisz wprowadzić unikatową poddomenę skojarzoną wih zasobu usług Cognitive Services do operacji pomocniczych.
Operacje nieobsługiwane przy użyciu uwierzytelniania identyfikatora Entra firmy Microsoft
W przypadku korzystania z uwierzytelniania identyfikatora Entra firmy Microsoft obsługiwane są tylko akcje v2. Przestarzałe akcje będą nadal działać z Access Key uwierzytelnianiem, ale w przypadku użycia z połączeniem Microsoft Entra ID zakończy się niepowodzeniem.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Klucz interfejsu API | Klucz interfejsu API | Wszystkie regiony | Udostępnialne |
| Domyślne [PRZESTARZAŁE] | Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. | Wszystkie regiony | Nie można udostępniać |
Klucz interfejsu API
Identyfikator uwierzytelniania: keyBasedAuth
Dotyczy: wszystkie regiony
Klucz interfejsu API
Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz konta | securestring | Klucz konta usług Cognitive Services | |
| Adres URL witryny | ciąg | Adres URL witryny głównej (przykład: https://westus.api.cognitive.microsoft.com) |
Domyślne [PRZESTARZAŁE]
Dotyczy: wszystkie regiony
Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz interfejsu API | securestring | Klucz interfejsu API | Prawda |
| Adres URL witryny | ciąg | Adres URL witryny głównej (przykład: https://westus.api.cognitive.microsoft.com ). Jeśli nie określono adresu URL witryny, zostanie domyślnie ustawiona wartość "https://westus.api.cognitive.microsoft.com". |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 1200 | 60 sekund |
Akcje
| Dodawanie listy twarzy do twarzy |
Dodaj twarz do listy twarzy. |
| Dodawanie twarzy do listy twarzy (wersja 2) |
Dodaj twarz do listy twarzy. |
| Dodawanie twarzy osoby |
Dodaj reprezentatywną twarz do osoby w celu identyfikacji. |
| Dodawanie twarzy osoby (wersja 2) |
Dodaj reprezentatywną twarz do osoby w celu identyfikacji. |
| Pobieranie grupy osób |
Pobierz informacje o grupie osób, w tym jej nazwę i nazwę użytkownikaData. |
| Pobieranie grupy osób (wersja 2) |
Pobierz informacje o grupie osób, w tym jej nazwę i nazwę użytkownikaData. |
| Pobieranie listy twarzy |
Pobierz informacje listy twarzy, w tym faceListId, name, userData i faces na liście twarzy. |
| Pobieranie listy twarzy (wersja 2) |
Pobierz informacje listy twarzy, w tym faceListId, name, userData i faces na liście twarzy. |
| Pobieranie osoby |
Pobierz informacje o danej osobie, w tym zarejestrowane utrwalone twarze, nazwę i nazwę użytkownikaData. |
| Pobieranie osoby (wersja 2) |
Pobierz informacje o danej osobie, w tym zarejestrowane utrwalone twarze, nazwę i nazwę użytkownikaData. |
| Pobieranie twarzy osoby (wersja 2) |
Pobierz informacje o utrwalonej twarzy określonej przez utrwalaneFaceId, personId i należące do niej personGroupId. |
| Tworzenie grupy osób |
Utwórz nową grupę osób z określonym identyfikatorem personGroupId, nazwą i użytkownikiem podanym przez użytkownikaData. |
| Tworzenie grupy osób (wersja 2) |
Utwórz nową grupę osób z określonym identyfikatorem personGroupId, nazwą i użytkownikiem podanym przez użytkownikaData. |
| Tworzenie listy twarzy |
Utwórz pustą listę twarzy z określonym przez użytkownika identyfikatorem faceListId, nazwą i opcjonalnym użytkownikiemData. |
| Tworzenie listy twarzy (wersja 2) |
Utwórz pustą listę twarzy z określonym przez użytkownika identyfikatorem faceListId, nazwą i opcjonalnym użytkownikiemData. |
| Tworzenie osoby |
Utwórz nową osobę w określonej grupie osób. |
| Tworzenie osoby (wersja 2) |
Utwórz nową osobę w określonej grupie osób. |
| Uzyskiwanie twarzy osoby |
Pobierz informacje o utrwalonej twarzy określonej przez utrwalaneFaceId, personId i należące do niej personGroupId. |
| Wykrywanie twarzy |
Wykrywanie ludzkich twarzy na obrazie i zwraca lokalizacje twarzy oraz opcjonalnie za pomocą identyfikatorów faceId, punktów orientacyjnych i atrybutów. |
| Wykrywanie twarzy (wersja 2) |
Wykrywanie ludzkich twarzy na obrazie i zwraca lokalizacje twarzy oraz opcjonalnie za pomocą identyfikatorów faceId, punktów orientacyjnych i atrybutów. |
| Znajdowanie osoby z twarzy |
Sprawdź, czy dwie twarze należą do tej samej osoby, czy jedna twarz należy do osoby. |
| Znajdowanie osoby z twarzy (wersja 2) |
Sprawdź, czy dwie twarze należą do tej samej osoby, czy jedna twarz należy do osoby. |
Dodawanie listy twarzy do twarzy
Dodaj twarz do listy twarzy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL obrazu
|
url | string |
Obraz musi mieć format JPEG, PNG, GIF (pierwsza ramka) lub BMP |
|
|
Twarz docelowa
|
targetFace | string |
Prostokąt twarzy określający docelową twarz do dodania do osoby w formacie targetFace=left,top,width,height |
|
|
Dane użytkownika
|
userData | string |
Dane określone przez użytkownika dotyczące twarzy docelowej do dodania do dowolnego celu. Maksymalna długość to 1 KB. |
|
|
Identyfikator listy twarzy
|
faceListId | True | string |
Prawidłowy znak to mała litera lub cyfra lub "-" lub "_", maksymalna długość to 64. |
Zwraca
Dodawanie twarzy do listy twarzy (wersja 2)
Dodaj twarz do listy twarzy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Adres URL obrazu
|
url | string |
Obraz musi mieć format JPEG, PNG, GIF (pierwsza ramka) lub BMP |
|
|
Twarz docelowa
|
targetFace | string |
Prostokąt twarzy określający docelową twarz do dodania do osoby w formacie targetFace=left,top,width,height |
|
|
Dane użytkownika
|
userData | string |
Dane określone przez użytkownika dotyczące twarzy docelowej do dodania do dowolnego celu. Maksymalna długość to 1 KB. |
|
|
Identyfikator listy twarzy
|
faceListId | True | string |
Prawidłowy znak to mała litera lub cyfra lub "-" lub "_", maksymalna długość to 64. |
Zwraca
Dodawanie twarzy osoby
Dodaj reprezentatywną twarz do osoby w celu identyfikacji.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator grupy osób
|
personGroupId | True | string |
Grupa osób |
|
Identyfikator osoby
|
personId | True | string |
Osoba docelowa, do której jest dodawana twarz. |
|
Adres URL obrazu
|
url | True | string |
Obraz musi mieć format JPEG, PNG, GIF (pierwsza ramka) lub BMP |
|
Twarz docelowa
|
targetFace | string |
Prostokąt twarzy określający docelową twarz do dodania do osoby w formacie targetFace=left,top,width,height |
|
|
Dane użytkownika
|
userData | string |
Dane określone przez użytkownika dotyczące twarzy docelowej do dodania do dowolnego celu. Maksymalna długość to 1 KB. |
Zwraca
Dodawanie twarzy osoby (wersja 2)
Dodaj reprezentatywną twarz do osoby w celu identyfikacji.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Identyfikator grupy osób
|
personGroupId | True | string |
Grupa osób |
|
Identyfikator osoby
|
personId | True | string |
Osoba docelowa, do której jest dodawana twarz. |
|
Adres URL obrazu
|
url | True | string |
Obraz musi mieć format JPEG, PNG, GIF (pierwsza ramka) lub BMP |
|
Twarz docelowa
|
targetFace | string |
Prostokąt twarzy określający docelową twarz do dodania do osoby w formacie targetFace=left,top,width,height |
|
|
Dane użytkownika
|
userData | string |
Dane określone przez użytkownika dotyczące twarzy docelowej do dodania do dowolnego celu. Maksymalna długość to 1 KB. |
Zwraca
Pobieranie grupy osób
Pobierz informacje o grupie osób, w tym jej nazwę i nazwę użytkownikaData.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator grupy osób
|
personGroupId | True | string |
Identyfikator grupy osób docelowych. |
Zwraca
Pobieranie grupy osób (wersja 2)
Pobierz informacje o grupie osób, w tym jej nazwę i nazwę użytkownikaData.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Identyfikator grupy osób
|
personGroupId | True | string |
Identyfikator grupy osób docelowych. |
Zwraca
Pobieranie listy twarzy
Pobierz informacje listy twarzy, w tym faceListId, name, userData i faces na liście twarzy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator listy twarzy
|
faceListId | True | string |
faceListId docelowej listy twarzy. |
Zwraca
- Body
- GetFaceListResponse
Pobieranie listy twarzy (wersja 2)
Pobierz informacje listy twarzy, w tym faceListId, name, userData i faces na liście twarzy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Identyfikator listy twarzy
|
faceListId | True | string |
faceListId docelowej listy twarzy. |
Zwraca
- Body
- GetFaceListResponse
Pobieranie osoby
Pobierz informacje o danej osobie, w tym zarejestrowane utrwalone twarze, nazwę i nazwę użytkownikaData.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator grupy osób
|
personGroupId | True | string |
Określanie grupy osób zawierającej osobę docelową. |
|
Identyfikator osoby
|
personId | True | string |
Określanie osoby docelowej. |
Zwraca
- Body
- GetPersonResponse
Pobieranie osoby (wersja 2)
Pobierz informacje o danej osobie, w tym zarejestrowane utrwalone twarze, nazwę i nazwę użytkownikaData.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Identyfikator grupy osób
|
personGroupId | True | string |
Określanie grupy osób zawierającej osobę docelową. |
|
Identyfikator osoby
|
personId | True | string |
Określanie osoby docelowej. |
Zwraca
- Body
- GetPersonResponse
Pobieranie twarzy osoby (wersja 2)
Pobierz informacje o utrwalonej twarzy określonej przez utrwalaneFaceId, personId i należące do niej personGroupId.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Identyfikator grupy osób
|
personGroupId | True | string |
Określanie grupy osób zawierającej osobę docelową. |
|
Identyfikator osoby
|
personId | True | string |
Określanie osoby docelowej, do której należy twarz. |
|
Utrwalone identyfikatory twarzy
|
persistedFaceId | True | string |
UtrwaloneFaceId obiektu docelowego utrwały twarz osoby. |
Zwraca
Tworzenie grupy osób
Utwórz nową grupę osób z określonym identyfikatorem personGroupId, nazwą i użytkownikiem podanym przez użytkownikaData.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator grupy osób
|
personGroupId | True | string |
Nowy identyfikator grupy osób (prawidłowe znaki obejmują cyfry, litery angielskie w małych literach, "-" i "_") |
|
Name
|
name | True | string |
Nazwa wyświetlana grupy osób. Maksymalna długość to 128. |
|
Dane użytkownika
|
userData | string |
Dane dostarczone przez użytkownika dołączone do grupy osób. Limit rozmiaru to 16 KB. |
Tworzenie grupy osób (wersja 2)
Utwórz nową grupę osób z określonym identyfikatorem personGroupId, nazwą i użytkownikiem podanym przez użytkownikaData.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Identyfikator grupy osób
|
personGroupId | True | string |
Nowy identyfikator grupy osób (prawidłowe znaki obejmują cyfry, litery angielskie w małych literach, "-" i "_") |
|
Name
|
name | True | string |
Nazwa wyświetlana grupy osób. Maksymalna długość to 128. |
|
Dane użytkownika
|
userData | string |
Dane dostarczone przez użytkownika dołączone do grupy osób. Limit rozmiaru to 16 KB. |
Tworzenie listy twarzy
Utwórz pustą listę twarzy z określonym przez użytkownika identyfikatorem faceListId, nazwą i opcjonalnym użytkownikiemData.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator listy twarzy
|
faceListId | True | string |
Prawidłowy znak to litera w małych literach lub cyfrach lub "-" lub "_", maksymalna długość to 64 |
|
Nazwa listy twarzy
|
name | True | string |
Nazwa utworzonej listy twarzy, maksymalna długość to 128. |
|
Dane użytkownika
|
userData | string |
Opcjonalne dane zdefiniowane przez użytkownika dla listy twarzy. Długość nie powinna przekraczać 16 KB. |
Tworzenie listy twarzy (wersja 2)
Utwórz pustą listę twarzy z określonym przez użytkownika identyfikatorem faceListId, nazwą i opcjonalnym użytkownikiemData.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Identyfikator listy twarzy
|
faceListId | True | string |
Prawidłowy znak to litera w małych literach lub cyfrach lub "-" lub "_", maksymalna długość to 64 |
|
Nazwa listy twarzy
|
name | True | string |
Nazwa utworzonej listy twarzy, maksymalna długość to 128. |
|
Dane użytkownika
|
userData | string |
Opcjonalne dane zdefiniowane przez użytkownika dla listy twarzy. Długość nie powinna przekraczać 16 KB. |
Tworzenie osoby
Utwórz nową osobę w określonej grupie osób.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator grupy osób
|
personGroupId | True | string |
Określanie grupy osób docelowych w celu utworzenia osoby. |
|
Name
|
name | True | string |
Nazwa wyświetlana osoby docelowej. Maksymalna długość to 128. |
|
Dane użytkownika
|
userData | string |
Opcjonalne pola dla danych dostarczonych przez użytkownika dołączonych do osoby. Limit rozmiaru to 16 KB. |
Zwraca
- Body
- CreatePersonResponse
Tworzenie osoby (wersja 2)
Utwórz nową osobę w określonej grupie osób.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Identyfikator grupy osób
|
personGroupId | True | string |
Określanie grupy osób docelowych w celu utworzenia osoby. |
|
Name
|
name | True | string |
Nazwa wyświetlana osoby docelowej. Maksymalna długość to 128. |
|
Dane użytkownika
|
userData | string |
Opcjonalne pola dla danych dostarczonych przez użytkownika dołączonych do osoby. Limit rozmiaru to 16 KB. |
Zwraca
- Body
- CreatePersonResponse
Uzyskiwanie twarzy osoby
Pobierz informacje o utrwalonej twarzy określonej przez utrwalaneFaceId, personId i należące do niej personGroupId.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator grupy osób
|
personGroupId | True | string |
Określanie grupy osób zawierającej osobę docelową. |
|
Identyfikator osoby
|
personId | True | string |
Określanie osoby docelowej, do której należy twarz. |
|
Utrwalone identyfikatory twarzy
|
persistedFaceId | True | string |
UtrwaloneFaceId obiektu docelowego utrwały twarz osoby. |
Zwraca
Wykrywanie twarzy
Wykrywanie ludzkich twarzy na obrazie i zwraca lokalizacje twarzy oraz opcjonalnie za pomocą identyfikatorów faceId, punktów orientacyjnych i atrybutów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL obrazu
|
url | True | string |
Obraz musi mieć format JPEG, PNG, GIF (pierwsza ramka) lub BMP |
Zwraca
- Przedmioty
- DetectResponse
Wykrywanie twarzy (wersja 2)
Wykrywanie ludzkich twarzy na obrazie i zwraca lokalizacje twarzy oraz opcjonalnie za pomocą identyfikatorów faceId, punktów orientacyjnych i atrybutów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Adres URL obrazu
|
url | True | string |
Obraz musi mieć format JPEG, PNG, GIF (pierwsza ramka) lub BMP |
Zwraca
- Przedmioty
- DetectResponse
Znajdowanie osoby z twarzy
Sprawdź, czy dwie twarze należą do tej samej osoby, czy jedna twarz należy do osoby.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Face Id
|
faceId | True | string |
Unikatowy faceId wykrytej twarzy. Wygaśnie 24 godziny po wywołaniu wykrywania. |
|
Identyfikator grupy osób
|
personGroupId | True | string |
Identyfikator grupy osób utworzony w interfejsie API rozpoznawania twarzy — akcja Utwórz grupę osób. |
|
Identyfikator osoby
|
personId | True | string |
Identyfikator osoby utworzony w interfejsie API rozpoznawania twarzy — akcja Utwórz osobę. |
Zwraca
- Body
- VerifyResponse
Znajdowanie osoby z twarzy (wersja 2)
Sprawdź, czy dwie twarze należą do tej samej osoby, czy jedna twarz należy do osoby.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Poddomena zasobów lub region
|
subdomain | True | string |
Poddomena platformy Azure lub region geograficzny (np. westus) |
|
Face Id
|
faceId | True | string |
Unikatowy faceId wykrytej twarzy. Wygaśnie 24 godziny po wywołaniu wykrywania. |
|
Identyfikator grupy osób
|
personGroupId | True | string |
Identyfikator grupy osób utworzony w interfejsie API rozpoznawania twarzy — akcja Utwórz grupę osób. |
|
Identyfikator osoby
|
personId | True | string |
Identyfikator osoby utworzony w interfejsie API rozpoznawania twarzy — akcja Utwórz osobę. |
Zwraca
- Body
- VerifyResponse
Definicje
DetectResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Face Id
|
faceId | string |
Unikatowy faceId wykrytej twarzy. Wygaśnie 24 godziny po wywołaniu wykrywania. |
|
Do góry
|
faceRectangle.top | integer |
Parametry obszaru prostokąta dla lokalizacji twarzy na obrazie. |
|
Lewo
|
faceRectangle.left | integer |
Parametry obszaru prostokąta dla lokalizacji twarzy na obrazie. |
|
Szerokość
|
faceRectangle.width | integer |
Parametry obszaru prostokąta dla lokalizacji twarzy na obrazie. |
|
Wysokość
|
faceRectangle.height | integer |
Parametry obszaru prostokąta dla lokalizacji twarzy na obrazie. |
|
Lewy uczeń X
|
faceLandmarks.pupilLeft.x | float |
Współrzędna x lewej źrenicy. |
|
Lewy uczeń Y
|
faceLandmarks.pupilLeft.y | float |
Współrzędna y lewej źrenicy. |
|
Prawy uczeń X
|
faceLandmarks.pupilRight.x | float |
Współrzędna x prawej źrenicy. |
|
Prawy uczeń Y
|
faceLandmarks.pupilRight.y | float |
Współrzędna y prawej źrenicy. |
|
Porada nosowa X
|
faceLandmarks.noseTip.x | float |
Współrzędna x końcówki nosa. |
|
Porada nosowa Y
|
faceLandmarks.noseTip.y | float |
Współrzędna y końcówki nosa. |
|
Usta z lewej X
|
faceLandmarks.mouthLeft.x | float |
Współrzędna x lewej strony ust. |
|
Usta lewe Y
|
faceLandmarks.mouthLeft.y | float |
Współrzędna y dla lewej strony ust. |
|
Usta w prawo X
|
faceLandmarks.mouthRight.x | float |
Współrzędna x prawej strony ust. |
|
Usta w prawo Y
|
faceLandmarks.mouthRight.y | float |
Współrzędna y dla prawej strony ust. |
|
Zewnętrzne lewe brwi X
|
faceLandmarks.eyebrowLeftOuter.x | float |
Współrzędna x dla zewnętrznej strony lewej brwi. |
|
Zewnętrzne lewe brwi Y
|
faceLandmarks.eyebrowLeftOuter.y | float |
Współrzędna y dla zewnętrznej strony lewej brwi. |
|
Lewy wewnętrzny Eybrow X
|
faceLandmarks.eyebrowLeftInner.x | float |
Współrzędna x dla wewnętrznej strony lewej brwi. |
|
Wewnętrzna lewa brwi Y
|
faceLandmarks.eyebrowLeftInner.y | float |
Współrzędna y dla wewnętrznej strony lewej brwi. |
|
Zewnętrzne lewe oko X
|
faceLandmarks.eyeLeftOuter.x | float |
Współrzędna x dla zewnętrznej strony lewego oka. |
|
Zewnętrzne lewe oko Y
|
faceLandmarks.eyeLeftOuter.y | float |
Współrzędna y dla zewnętrznej strony lewego oka. |
|
U góry lewego oka X
|
faceLandmarks.eyeLeftTop.x | float |
Współrzędna x u góry lewego oka. |
|
Góra lewego oka Y
|
faceLandmarks.eyeLeftTop.y | float |
Współrzędna y u góry lewego oka. |
|
U dołu lewego oka X
|
faceLandmarks.eyeLeftBottom.x | float |
Współrzędna x dolnej części lewego oka. |
|
U dołu lewego oka Y
|
faceLandmarks.eyeLeftBottom.y | float |
Współrzędna y dla dołu lewego oka. |
|
Wewnętrzne lewe oko X
|
faceLandmarks.eyeLeftInner.x | float |
Współrzędna x dla wewnętrznej strony lewego oka. |
|
Wewnętrzne lewe oko Y
|
faceLandmarks.eyeLeftInner.y | float |
Współrzędna y dla wewnętrznej strony lewego oka. |
|
Wewnętrzna prawa Eybrow X
|
faceLandmarks.eyebrowRightInner.x | float |
Współrzędna x dla wewnętrznej strony prawej brwi. |
|
Wewnętrzna prawa brwi Y
|
faceLandmarks.eyebrowRightInner.y | float |
Współrzędna y dla wewnętrznej strony prawej brwi. |
|
Zewnętrzne prawe brwi X
|
faceLandmarks.eyebrowRightOuter.x | float |
Współrzędna x dla zewnętrznej strony prawej brwi. |
|
Zewnętrzne prawe brwi Y
|
faceLandmarks.eyebrowRightOuter.y | float |
Współrzędna y dla zewnętrznej strony prawej brwi. |
|
Wewnętrzne prawe oko X
|
faceLandmarks.eyeRightInner.x | float |
Współrzędna x dla wewnętrznej strony prawego oka. |
|
Prawe oko wewnętrzne Y
|
faceLandmarks.eyeRightInner.y | float |
Współrzędna y dla wewnętrznej strony prawego oka. |
|
U góry prawego oka X
|
faceLandmarks.eyeRightTop.x | float |
Współrzędna x u góry prawego oka. |
|
Góra prawego oka Y
|
faceLandmarks.eyeRightTop.y | float |
Współrzędna y u góry prawego oka. |
|
U dołu prawego oka X
|
faceLandmarks.eyeRightBottom.x | float |
Współrzędna x dolnej części prawego oka. |
|
U dołu prawego oka Y
|
faceLandmarks.eyeRightBottom.y | float |
Współrzędna y dla dolnej części prawego oka. |
|
Zewnętrzne prawe oko X
|
faceLandmarks.eyeRightOuter.x | float |
Współrzędna x dla zewnętrznej strony prawego oka. |
|
Zewnętrzne prawe oko Y
|
faceLandmarks.eyeRightOuter.y | float |
Współrzędna y dla zewnętrznej strony prawego oka. |
|
Lewy korzeń nosowy X
|
faceLandmarks.noseRootLeft.x | float |
Współrzędna x lewej strony korzenia nosa. |
|
Lewy korzeń nosowy Y
|
faceLandmarks.noseRootLeft.y | float |
Współrzędna y dla lewej strony korzenia nosa. |
|
Prawy pierwiastek nosa X
|
faceLandmarks.noseRootRight.x | float |
Współrzędna x dla prawej strony korzenia nosa. |
|
Prawy korzeń nosa Y
|
faceLandmarks.noseRootRight.y | float |
Współrzędna y dla prawej strony korzenia nosa. |
|
Górna część lewego ołtarza nosowego X
|
faceLandmarks.noseLeftAlarTop.x | float |
Współrzędna x w górnej części lewego ołtarza nosa. |
|
Górna część lewego ołtarza nosowego Y
|
faceLandmarks.noseLeftAlarTop.y | float |
Współrzędna y w górnej części lewego ołtarza nosa. |
|
U góry prawego nosa ołtarz X
|
faceLandmarks.noseRightAlarTop.x | float |
Współrzędna x w górnej części prawego ołtarza nosa. |
|
Od góry prawego ołtarza nosowego Y
|
faceLandmarks.noseRightAlarTop.y | float |
Współrzędna y dla prawej części ołtarza nosowego. |
|
Końcówka lewego nosa ołtarza X
|
faceLandmarks.noseLeftAlarOutTip.x | float |
Współrzędna x dla końcówki lewego ołtarza nosa. |
|
Końcówka lewego nosa ołtarza Y
|
faceLandmarks.noseLeftAlarOutTip.y | float |
Współrzędna y dla końcówki lewego ołtarza nosa/ |
|
Końcówka prawego ołtarza nosa na X
|
faceLandmarks.noseRightAlarOutTip.x | float |
Współrzędna x dla końcówki prawego ołtarza nosa. |
|
Końcówka prawego ołtarza nosa Y
|
faceLandmarks.noseRightAlarOutTip.y | float |
Współrzędna y dla końcówki prawego ołtarza nosa. |
|
Góra górnej wargi X
|
faceLandmarks.upperLipTop.x | float |
Współrzędna x górnej górnej wargi. |
|
Góra górnej wargi Y
|
faceLandmarks.upperLipTop.y | float |
Współrzędna y dla górnej części górnej wargi. |
|
U dołu górnej wargi X
|
faceLandmarks.upperLipBottom.x | float |
Współrzędna x dolnej górnej wargi. |
|
U dołu górnej wargi Y
|
faceLandmarks.upperLipBottom.y | float |
Współrzędna y dla dolnej części górnej wargi. |
|
Góra pod wargą X
|
faceLandmarks.underLipTop.x | float |
Współrzędna x górnej części ust. |
|
Góra pod wargą Y
|
faceLandmarks.underLipTop.y | float |
Współrzędna y dla góry pod wargą. |
|
Dół pod wargą X
|
faceLandmarks.underLipBottom.x | float |
Współrzędna x do dołu pod wargą. |
|
Dno pod wargą Y
|
faceLandmarks.underLipBottom.y | float |
Współrzędna y na dole pod wargą. |
|
Head Pose Pitch
|
faceAttributes.headPose.pitch | float |
Pole zarezerwowane zawsze zwraca wartość 0. |
|
Rzut głowy
|
faceAttributes.headPose.roll | float |
Roll of the head pose. |
|
Pozy głowy Yaw
|
faceAttributes.headPose.yaw | float |
Yaw z pozy głowy. |
|
Okulary
|
faceAttributes.glasses | string |
Rodzaj okularów. |
AddPersonFaceResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Utrwalone identyfikatory twarzy
|
persistedFaceId | string |
GetPersonGroupResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator grupy osób
|
personGroupId | string | |
|
Name
|
name | string | |
|
userData (dane użytkownika)
|
userData | string |
GetFaceListResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Utrwalone twarze
|
persistedFaces | array of object | |
|
Utrwalone identyfikatory twarzy
|
persistedFaces.persistedFaceId | string |
Identyfikator twarzy. |
|
Dane użytkownika
|
persistedFaces.userData | string |
Dane dostarczone przez użytkownika dołączone do każdej twarzy. |
|
Identyfikator listy twarzy
|
faceListId | string |
faceListId docelowej listy twarzy. |
|
Name
|
name | string |
Nazwa wyświetlana listy twarzy. |
|
Dane użytkownika
|
userData | string |
Dane dostarczone przez użytkownika dołączone do listy twarzy. |
GetPersonFaceResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Utrwalone identyfikatory twarzy
|
persistedFaceId | string | |
|
userData (dane użytkownika)
|
userData | string |
CreatePersonResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator osoby
|
personId | string |
GetPersonResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator osoby
|
personId | string | |
|
Utrwalone identyfikatory twarzy
|
persistedFaceIds | array of object | |
|
Utrwalone identyfikatory twarzy
|
persistedFaceIds.persistedFaceId | string | |
|
Name
|
name | string | |
|
Dane użytkownika
|
userData | string |
VerifyResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Jest identyczny
|
isIdentical | boolean |
Prawda, jeśli dwie twarze należą do tej samej osoby lub twarz należy do tej osoby, w przeciwnym razie fałsz. |
|
Pewność
|
confidence | float |
Liczba wskazuje pewność podobieństwa tego, czy dwie twarze należą do tej samej osoby, czy też twarz należy do tej osoby. |