Face Detection Operations - Detect

Usługa:: Azure AI Services

Wersja interfejsu API:: v1.2

Wykrywanie ludzkich twarzy na obrazie, zwracanie prostokątów twarzy i opcjonalnie za pomocą identyfikatorów faceId, punktów orientacyjnych i atrybutów.

Ważny

Firma Microsoft ma wycofane lub ograniczone możliwości rozpoznawania twarzy, które mogą służyć do wnioskowania stanów emocjonalnych i atrybutów tożsamości, które, w przypadku nieprawidłowego użycia, mogą podlegać stereotypom, dyskryminacji lub niesprawiedliwej odmowy usług. Wycofane możliwości to emocje i płeć. Ograniczone możliwości to wiek, uśmiech, zarost, włosy i makijaż. Adres e-mail interfejsu API rozpoznawania twarzy platformy Azure, jeśli masz odpowiedzialny przypadek użycia, który będzie korzystać z dowolnego z ograniczonych możliwości. Przeczytaj więcej na temat tej decyzji tutaj.

- Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy będą przechowywane na serwerze. FaceId jest identyfikatorem funkcji twarzy i będzie używany w elementach "Identify", "Verify" i "Find Similar". Przechowywane funkcje twarzy wygasną i zostaną usunięte w czasie określonym przez faceIdTimeToLive po oryginalnym wywołaniu wykrywania.
- Parametry opcjonalne obejmują faceId, punkty orientacyjne i atrybuty. Atrybuty obejmują headPose, okulary, okluzji, akcesoria, rozmycie, ekspozycji, hałasu, maski i jakościForRecognition. Niektóre wyniki zwracane dla określonych atrybutów mogą nie być bardzo dokładne.
- Obsługiwane są formaty JPEG, PNG, GIF (pierwsza ramka) i BMP. Dozwolony rozmiar pliku obrazu wynosi od 1 KB do 6 MB.
- Minimalny rozmiar twarzy wykrywalnej to 36x36 pikseli na obrazie nie większym niż 1920 x 1080 pikseli. Obrazy o wymiarach wyższych niż 1920 x 1080 pikseli będą potrzebować proporcjonalnie większego minimalnego rozmiaru twarzy.
- Dla obrazu można zwrócić maksymalnie 100 twarzy. Twarze są klasyfikowane według rozmiaru prostokąta twarzy od dużych do małych.
- Aby uzyskać optymalne wyniki podczas wykonywania zapytań dotyczących wartości "Identify", "Verify" i "Find Similar" ('returnFaceId' ma wartość true), użyj twarzy, które są: przednie, jasne i o minimalnym rozmiarze 200x200 pikseli (100 pikseli między oczami).
- Można podać różne wartości "detectionModel". Dostępność punktów orientacyjnych i obsługiwanych atrybutów zależy od określonego modelu wykrywania. Aby użyć i porównać różne modele wykrywania, zapoznaj się z tutaj.
- Podano różne wartości "recognitionModel". Jeśli potrzebne są operacje monitowania, takie jak "Verify", "Identify", "Find Similar", określ model rozpoznawania z parametrem "recognitionModel". Wartość domyślna "recognitionModel" to "recognition_01", jeśli jest potrzebny najnowszy model, jawnie określ model, którego potrzebujesz w tym parametrze. Po określeniu wykryte identyfikatory faceId zostaną skojarzone z określonym modelem rozpoznawania. Więcej informacji można znaleźć w tutaj.

POST {endpoint}/face/{apiVersion}/detect

Z parametrami opcjonalnymi:

POST {endpoint}/face/{apiVersion}/detect?_overload=detect&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
apiVersion	path	True	string	Wersja interfejsu API
endpoint	path	True	string (uri)	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://{nazwa-zasobu}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	Element "detectionModel" skojarzony z wykrytymi identyfikatorami faceId. Obsługiwane wartości "detectionModel" obejmują wartości "detection_01", "detection_02" i "detection_03". Wartość domyślna to "detection_01". "detection_03" jest zalecany, ponieważ jego dokładność jest lepsza na mniejszych twarzach (64x64 pikseli) i obróconych orientacji twarzy.
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	Liczba sekund buforowania identyfikatora twarzy. Obsługiwany zakres od 60 sekund do 86400 sekund. Wartość domyślna to 86400 (24 godziny).
recognitionModel	query		RecognitionModel	Element "recognitionModel" skojarzony z wykrytymi identyfikatorami faceId. Obsługiwane wartości "recognitionModel" obejmują "recognition_01", "recognition_02", "recognition_03" lub "recognition_04". Wartość domyślna to "recognition_01". Zaleca się "recognition_04", ponieważ jego dokładność jest lepsza na twarzach w maskach w porównaniu z "recognition_03", a jego ogólna dokładność jest lepsza w porównaniu z "recognition_01" i "recognition_02".
returnFaceAttributes	query		FaceAttributeType[]	Przeanalizuj i zwróć co najmniej jeden określony atrybut twarzy w ciągu rozdzielanym przecinkami, na przykład "returnFaceAttributes=headPose,okulary". Analiza atrybutów twarzy ma dodatkowe koszty obliczeniowe i czasowe.
returnFaceId	query		boolean	Zwraca faceId wykrytych twarzy lub nie. Wartość domyślna to true.
returnFaceLandmarks	query		boolean	Zwraca punkty orientacyjne twarzy wykrytych twarzy lub nie. Wartość domyślna to false.
returnRecognitionModel	query		boolean	Zwraca wartość "recognitionModel" lub nie. Wartość domyślna to false. Ma to zastosowanie tylko wtedy, gdy returnFaceId = true.

Treść żądania

Media Types: "application/octet-stream"

Nazwa	Typ	Opis
imageContent	string (binary)	Plik binarny obrazu wejściowego.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	FaceDetectionResult[]	Pomyślne wywołanie zwraca tablicę wpisów twarzy sklasyfikowanych według rozmiaru prostokąta twarzy w kolejności malejącej. Pusta odpowiedź wskazuje, że nie wykryto twarzy.
Other Status Codes	FaceErrorResponse	Nieoczekiwana odpowiedź na błąd. Nagłówki x-ms-error-code: string

Nazwa

Typ

Opis

200 OK

FaceDetectionResult[]

Pomyślne wywołanie zwraca tablicę wpisów twarzy sklasyfikowanych według rozmiaru prostokąta twarzy w kolejności malejącej. Pusta odpowiedź wskazuje, że nie wykryto twarzy.

Other Status Codes

FaceErrorResponse

Nieoczekiwana odpowiedź na błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Klucz tajny subskrypcji rozpoznawania twarzy w usłudze Azure AI.

Typ: apiKey
W: header

AADToken

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://api.example.com/oauth2/authorize
Adres URL tokenu: https://api.example.com/oauth2/token

Zakresy

Nazwa	Opis
https://cognitiveservices.azure.com/.default

Przykłady

Detect with Image

Przykładowe żądanie

HTTP

POST {endpoint}/face/v1.2/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

Przykładowa odpowiedź

Kod stanu:: 200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "recognitionModel": "recognition_03",
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "faceLandmarks": {
      "pupilLeft": {
        "x": 412.7,
        "y": 78.4
      },
      "pupilRight": {
        "x": 446.8,
        "y": 74.2
      },
      "noseTip": {
        "x": 437.7,
        "y": 92.4
      },
      "mouthLeft": {
        "x": 417.8,
        "y": 114.4
      },
      "mouthRight": {
        "x": 451.3,
        "y": 109.3
      },
      "eyebrowLeftOuter": {
        "x": 397.9,
        "y": 78.5
      },
      "eyebrowLeftInner": {
        "x": 425.4,
        "y": 70.5
      },
      "eyeLeftOuter": {
        "x": 406.7,
        "y": 80.6
      },
      "eyeLeftTop": {
        "x": 412.2,
        "y": 76.2
      },
      "eyeLeftBottom": {
        "x": 413,
        "y": 80.1
      },
      "eyeLeftInner": {
        "x": 418.9,
        "y": 78
      },
      "eyebrowRightInner": {
        "x": 4.8,
        "y": 69.7
      },
      "eyebrowRightOuter": {
        "x": 5.5,
        "y": 68.5
      },
      "eyeRightInner": {
        "x": 441.5,
        "y": 75
      },
      "eyeRightTop": {
        "x": 446.4,
        "y": 71.7
      },
      "eyeRightBottom": {
        "x": 447,
        "y": 75.3
      },
      "eyeRightOuter": {
        "x": 451.7,
        "y": 73.4
      },
      "noseRootLeft": {
        "x": 428,
        "y": 77.1
      },
      "noseRootRight": {
        "x": 435.8,
        "y": 75.6
      },
      "noseLeftAlarTop": {
        "x": 428.3,
        "y": 89.7
      },
      "noseRightAlarTop": {
        "x": 442.2,
        "y": 87
      },
      "noseLeftAlarOutTip": {
        "x": 424.3,
        "y": 96.4
      },
      "noseRightAlarOutTip": {
        "x": 446.6,
        "y": 92.5
      },
      "upperLipTop": {
        "x": 437.6,
        "y": 105.9
      },
      "upperLipBottom": {
        "x": 437.6,
        "y": 108.2
      },
      "underLipTop": {
        "x": 436.8,
        "y": 111.4
      },
      "underLipBottom": {
        "x": 437.3,
        "y": 114.5
      }
    },
    "faceAttributes": {
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 1.6
      },
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "accessories": [
        {
          "type": "headwear",
          "confidence": 0.99
        },
        {
          "type": "glasses",
          "confidence": 1
        },
        {
          "type": "mask",
          "confidence": 0.87
        }
      ],
      "blur": {
        "blurLevel": "medium",
        "value": 0.51
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.55
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0.12
      },
      "qualityForRecognition": "high"
    }
  }
]

Definicje

Nazwa	Opis
AccessoryItem	Element dostępu i odpowiedni poziom ufności.
AccessoryType	Typ akcesorium.
BlurLevel	Wskazuje poziom rozmycia.
BlurProperties	Właściwości opisujące obecność rozmycia obrazu.
DetectionModel	Element "detectionModel" skojarzony z wykrytymi identyfikatorami faceId. Obsługiwane wartości "detectionModel" obejmują wartości "detection_01", "detection_02" i "detection_03". Wartość domyślna to "detection_01". "detection_03" jest zalecany, ponieważ jego dokładność jest lepsza na mniejszych twarzach (64x64 pikseli) i obróconych orientacji twarzy.
ExposureLevel	Wskazuje poziom ekspozycji.
ExposureProperties	Właściwości opisujące poziom ekspozycji obrazu.
FaceAttributes	Atrybuty twarzy wykrytej twarzy.
FaceAttributeType	Przeanalizuj i zwróć co najmniej jeden określony atrybut twarzy w ciągu rozdzielanym przecinkami, na przykład "returnFaceAttributes=headPose,okulary". Analiza atrybutów twarzy ma dodatkowe koszty obliczeniowe i czasowe.
FaceDetectionResult	Odpowiedź na potrzeby wykrywania interfejsu API.
FaceError	Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpowiedź zawierająca szczegóły błędu.
FaceLandmarks	Kolekcja 27-punktowych punktów charakterystycznych twarzy wskazująca ważne pozycje składników twarzy.
FaceRectangle	Prostokąt, w którym można znaleźć twarz.
FacialHair	Właściwości opisujące atrybuty zarostu.
GlassesType	Okulary typu twarzy.
HairColor	Tablica kolorów kandydatów i poziom ufności w obecności każdego z nich.
HairColorType	Nazwa koloru włosów.
HairProperties	Właściwości opisujące atrybuty włosów.
HeadPose	Kąty rzutowania/yaw/skoku 3-W dla kierunku twarzy.
LandmarkCoordinate	Współrzędne punktów orientacyjnych na obrazie.
MaskProperties	Właściwości opisujące obecność maski na danej twarzy.
MaskType	Typ maski.
NoiseLevel	Wskazuje poziom szumu.
NoiseProperties	Właściwości opisujące poziom szumu obrazu.
OcclusionProperties	Właściwości opisujące okluzji na danej twarzy.
QualityForRecognition	Wskazuje jakość obrazu do rozpoznawania.
RecognitionModel	Model rozpoznawania twarzy.

AccessoryItem

Objekt

Element dostępu i odpowiedni poziom ufności.

Nazwa	Typ	Opis
confidence	number (float) minimum: 0 maximum: 1	Poziom ufności typu akcesorium. Zakres między [0,1].
type	AccessoryType	Typ akcesorium.

AccessoryType

Wyliczanie

Typ akcesorium.

Wartość	Opis
headwear	Zużycie głowy.
glasses	Okulary.
mask	Maska.

BlurLevel

Wyliczanie

Wskazuje poziom rozmycia.

Wartość	Opis
low	Niski poziom rozmycia.
medium	Średni poziom rozmycia.
high	Wysoki poziom rozmycia.

BlurProperties

Objekt

Właściwości opisujące obecność rozmycia obrazu.

Nazwa	Typ	Opis
blurLevel	BlurLevel	Wartość wyliczeniowa wskazująca poziom rozmycia.
value	number (float) minimum: 0 maximum: 1	Liczba wskazująca poziom rozmycia od 0 do 1.

DetectionModel

Wyliczanie

Element "detectionModel" skojarzony z wykrytymi identyfikatorami faceId. Obsługiwane wartości "detectionModel" obejmują wartości "detection_01", "detection_02" i "detection_03". Wartość domyślna to "detection_01". "detection_03" jest zalecany, ponieważ jego dokładność jest lepsza na mniejszych twarzach (64x64 pikseli) i obróconych orientacji twarzy.

Wartość	Opis
detection_01	Domyślny model wykrywania. Zaleca się wykrywanie twarzy niemal przedniej. W przypadku scenariuszy z wyjątkowo dużym kątem (pozy głowy) twarze, okludowane twarze lub niewłaściwa orientacja obrazu, twarze w takich przypadkach mogą nie zostać wykryte.
detection_02	Model wykrywania wydany w maju 2019 r. z lepszą dokładnością szczególnie na małych, bocznych i rozmytych twarzach.
detection_03	Model wykrywania wydany w 2021 r. w lutym 2021 r. z lepszą dokładnością szczególnie na małych twarzach.

ExposureLevel

Wyliczanie

Wskazuje poziom ekspozycji.

Wartość	Opis
underExposure	Niski poziom ekspozycji.
goodExposure	Dobry poziom ekspozycji.
overExposure	Wysoki poziom ekspozycji.

ExposureProperties

Objekt

Właściwości opisujące poziom ekspozycji obrazu.

Nazwa	Typ	Opis
exposureLevel	ExposureLevel	Wartość wyliczeniowa wskazująca poziom ekspozycji.
value	number (float) minimum: 0 maximum: 1	Liczba wskazująca poziom ekspozycji od 0 do 1. [0, 0,25) jest narażenie. [0,25, 0,75) jest dobra ekspozycja. [0,75, 1] jest nadmiernie narażenie.

FaceAttributes

Objekt

Atrybuty twarzy wykrytej twarzy.

Nazwa	Typ	Opis
accessories	AccessoryItem[]	Właściwości opisujące wszelkie akcesoria na danej twarzy.
age	number (float)	Wiek w latach.
blur	BlurProperties	Właściwości opisujące obecność rozmycia obrazu.
exposure	ExposureProperties	Właściwości opisujące poziom ekspozycji obrazu.
facialHair	FacialHair	Właściwości opisujące atrybuty zarostu.
glasses	GlassesType	Okulary wpisz, jeśli którakolwiek z twarzy.
hair	HairProperties	Właściwości opisujące atrybuty włosów.
headPose	HeadPose	Kąty rzutowania/yaw/skoku 3-W dla kierunku twarzy.
mask	MaskProperties	Właściwości opisujące obecność maski na danej twarzy.
noise	NoiseProperties	Właściwości opisujące poziom szumu obrazu.
occlusion	OcclusionProperties	Właściwości opisujące okluzji na danej twarzy.
qualityForRecognition	QualityForRecognition	Właściwości opisujące ogólną jakość obrazu dotyczące tego, czy obraz używany w wykrywaniu ma wystarczającą jakość do próby rozpoznania twarzy.
smile	number (float) minimum: 0 maximum: 1	Intensywność uśmiechu, liczba z zakresu od [0,1].

FaceAttributeType

Wyliczanie

Przeanalizuj i zwróć co najmniej jeden określony atrybut twarzy w ciągu rozdzielanym przecinkami, na przykład "returnFaceAttributes=headPose,okulary". Analiza atrybutów twarzy ma dodatkowe koszty obliczeniowe i czasowe.

Wartość	Opis
headPose	Kąty rzutowania/yaw/skoku 3-W dla kierunku twarzy.
glasses	Typ okularów. Wartości obejmują "NoGlasses", "ReadingGlasses", "Sunglasses", "SwimmingGoggles".
occlusion	Czy każdy obszar twarzy jest okludniony, w tym czoło, oczy i usta.
accessories	Akcesoria wokół twarzy, w tym "odzieży głowy", "okulary" i "maska". Pusta tablica oznacza, że nie wykryto żadnych akcesoriów. Pamiętaj, że jest to po wykryciu twarzy. Duża maska nie może spowodować wykrycia twarzy.
blur	Twarz jest rozmyta lub nie. Poziom zwraca wartość "Niska", "Średnia" lub "Wysoka". Wartość zwraca liczbę z zakresu od [0,1], tym większa jest rozmyta.
exposure	Poziom ekspozycji twarzy. Poziom zwraca wartość "GoodExposure", "OverExposure" lub "UnderExposure".
noise	Poziom szumu pikseli twarzy. Poziom zwraca wartości "Niski", "Średni" i "Wysoki". Wartość zwraca liczbę z zakresu od [0,1], tym większa wartość hałaśliwsza
mask	Czy każda twarz nosi maskę. Typ maski zwraca wartość "noMask", "faceMask", "otherMaskOrOcclusion" lub "niepewne". Wartość zwraca wartość logiczną "noseAndMouthCovered" wskazującą, czy nos i usta są pokryte.
qualityForRecognition	Ogólna jakość obrazu dotycząca tego, czy obraz używany w wykrywaniu jest wystarczającą jakością, aby podjąć próbę rozpoznawania twarzy. Wartość jest nieformalną oceną niskiej, średniej lub wysokiej. W scenariuszach identyfikacji zalecane są tylko obrazy o wysokiej jakości w przypadku rejestracji osób i jakości na poziomie lub powyżej "średniej". Atrybut jest dostępny tylko w przypadku używania modeli rozpoznawania recognition_03 lub recognition_04.
age	Wiek w latach.
smile	Intensywność uśmiechu, liczba z zakresu od [0,1].
facialHair	Właściwości opisujące atrybuty zarostu.
hair	Właściwości opisujące atrybuty włosów.

FaceDetectionResult

Objekt

Odpowiedź na potrzeby wykrywania interfejsu API.

Nazwa	Typ	Opis
faceAttributes	FaceAttributes	Atrybuty twarzy wykrytej twarzy.
faceId	string (uuid)	Unikatowy identyfikator faceId wykrytej twarzy utworzony przez interfejs API wykrywania i wygaśnie 24 godziny po wywołaniu wykrywania. Aby to zwrócić, parametr "returnFaceId" musi mieć wartość true.
faceLandmarks	FaceLandmarks	Tablica 27-punktowych punktów charakterystycznych twarzy wskazująca ważne pozycje składników twarzy. Aby to zwrócić, parametr "returnFaceLandmarks" musi mieć wartość true.
faceRectangle	FaceRectangle	Obszar prostokąta dla lokalizacji twarzy na obrazie.
recognitionModel	RecognitionModel	Element "recognitionModel" skojarzony z tym identyfikatorem faceId. Jest to zwracane tylko wtedy, gdy wartość "returnRecognitionModel" jest jawnie ustawiona na wartość true.

FaceError

Objekt

Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
message	string	Czytelna dla człowieka reprezentacja błędu.

FaceErrorResponse

Objekt

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	FaceError	Obiekt błędu.

FaceLandmarks

Objekt

Kolekcja 27-punktowych punktów charakterystycznych twarzy wskazująca ważne pozycje składników twarzy.

Nazwa	Typ	Opis
eyeLeftBottom	LandmarkCoordinate	Współrzędne lewego oka.
eyeLeftInner	LandmarkCoordinate	Współrzędne lewego oka wewnętrzne.
eyeLeftOuter	LandmarkCoordinate	Współrzędne lewego oka zewnętrzne.
eyeLeftTop	LandmarkCoordinate	Współrzędne lewego górnego oka.
eyeRightBottom	LandmarkCoordinate	Współrzędne prawego dna oka.
eyeRightInner	LandmarkCoordinate	Współrzędne prawego oka wewnętrznego.
eyeRightOuter	LandmarkCoordinate	Współrzędne prawego oka zewnętrzne.
eyeRightTop	LandmarkCoordinate	Współrzędne prawego górnego oka.
eyebrowLeftInner	LandmarkCoordinate	Współrzędne lewej brwi wewnętrznej.
eyebrowLeftOuter	LandmarkCoordinate	Współrzędne lewej brwi zewnętrznej.
eyebrowRightInner	LandmarkCoordinate	Współrzędne prawej brwi wewnętrznej.
eyebrowRightOuter	LandmarkCoordinate	Współrzędne prawej brwi zewnętrznej.
mouthLeft	LandmarkCoordinate	Współrzędne lewej ust.
mouthRight	LandmarkCoordinate	Współrzędne jamy ustnej w prawo.
noseLeftAlarOutTip	LandmarkCoordinate	Współrzędne nosa zostawiły górną wskazówkę.
noseLeftAlarTop	LandmarkCoordinate	Współrzędne lewego górnego rogu nosa.
noseRightAlarOutTip	LandmarkCoordinate	Współrzędne nosa prawe prawe przechylają się na wierzchołku.
noseRightAlarTop	LandmarkCoordinate	Współrzędne prawej górnej części nosa.
noseRootLeft	LandmarkCoordinate	Współrzędne korzenia nosa w lewo.
noseRootRight	LandmarkCoordinate	Współrzędne korzenia nosa po prawej stronie.
noseTip	LandmarkCoordinate	Współrzędne końcówki nosa.
pupilLeft	LandmarkCoordinate	Współrzędne lewego źrenicy oka.
pupilRight	LandmarkCoordinate	Współrzędne prawego źrenicy oczu.
underLipBottom	LandmarkCoordinate	Współrzędne dna pod wargą.
underLipTop	LandmarkCoordinate	Współrzędne pod wargą.
upperLipBottom	LandmarkCoordinate	Współrzędne górnej wargi.
upperLipTop	LandmarkCoordinate	Współrzędne górnej wargi.

FaceRectangle

Objekt

Prostokąt, w którym można znaleźć twarz.

Nazwa	Typ	Opis
height	integer (int32)	Wysokość prostokąta w pikselach.
left	integer (int32)	Odległość od lewej krawędzi, jeśli obraz do lewej krawędzi prostokąta w pikselach.
top	integer (int32)	Odległość od górnej krawędzi, jeśli obraz do górnej krawędzi prostokąta w pikselach.
width	integer (int32)	Szerokość prostokąta w pikselach.

FacialHair

Objekt

Właściwości opisujące atrybuty zarostu.

Nazwa	Typ	Opis
beard	number (float) minimum: 0 maximum: 1	Liczba z zakresu od 0 do 1 wskazująca poziom ufności skojarzony z właściwością.
moustache	number (float) minimum: 0 maximum: 1	Liczba z zakresu od 0 do 1 wskazująca poziom ufności skojarzony z właściwością.
sideburns	number (float) minimum: 0 maximum: 1	Liczba z zakresu od 0 do 1 wskazująca poziom ufności skojarzony z właściwością.

GlassesType

Wyliczanie

Okulary typu twarzy.

Wartość	Opis
noGlasses	Brak okularów na twarzy.
readingGlasses	Normalne okulary na twarzy.
sunglasses	Okulary przeciwsłoneczne na twarzy.
swimmingGoggles	Pływanie gogle na twarzy.

HairColor

Objekt

Tablica kolorów kandydatów i poziom ufności w obecności każdego z nich.

Nazwa	Typ	Opis
color	HairColorType	Nazwa koloru włosów.
confidence	number (float) minimum: 0 maximum: 1	Poziom ufności koloru. Zakres między [0,1].

HairColorType

Wyliczanie

Nazwa koloru włosów.

Wartość	Opis
unknown	Nieznany.
white	Biały.
gray	Szary.
blond	Blond.
brown	Brązowy.
red	Czerwony.
black	Czarny.
other	Inny.

HairProperties

Objekt

Właściwości opisujące atrybuty włosów.

Nazwa	Typ	Opis
bald	number (float) minimum: 0 maximum: 1	Liczba opisująca poziom pewności, czy dana osoba jest łysa.
hairColor	HairColor[]	Tablica kolorów kandydatów i poziom ufności w obecności każdego z nich.
invisible	boolean	Wartość logiczna opisująca, czy włosy są widoczne na obrazie.

HeadPose

Objekt

Kąty rzutowania/yaw/skoku 3-W dla kierunku twarzy.

Nazwa	Typ	Opis
pitch	number (float)	Wartość kątów.
roll	number (float)	Wartość kątów.
yaw	number (float)	Wartość kątów.

LandmarkCoordinate

Objekt

Współrzędne punktów orientacyjnych na obrazie.

Nazwa	Typ	Opis
x	number (float)	Składnik poziomy w pikselach.
y	number (float)	Składnik pionowy w pikselach.

MaskProperties

Objekt

Właściwości opisujące obecność maski na danej twarzy.

Nazwa	Typ	Opis
noseAndMouthCovered	boolean	Wartość logiczna wskazująca, czy nos i usta są pokryte.
type	MaskType	Typ maski.

MaskType

Wyliczanie

Typ maski.

Wartość	Opis
faceMask	Maska.
noMask	Brak maski.
otherMaskOrOcclusion	Inne rodzaje maski lub okluzji.
uncertain	Niepewny.

NoiseLevel

Wyliczanie

Wskazuje poziom szumu.

Wartość	Opis
low	Niski poziom szumu.
medium	Średni poziom szumu.
high	Wysoki poziom szumu.

NoiseProperties

Objekt

Właściwości opisujące poziom szumu obrazu.

Nazwa	Typ	Opis
noiseLevel	NoiseLevel	Wartość wyliczeniowa wskazująca poziom szumu.
value	number (float) minimum: 0 maximum: 1	Liczba wskazująca poziom hałasu od 0 do 1. [0, 0,25) jest narażenie. [0,25, 0,75) jest dobra ekspozycja. [0,75, 1] jest nadmiernie narażenie. [0, 0,3) jest niski poziom szumu. [0,3, 0,7) to średni poziom szumu. [0,7, 1] jest wysokim poziomem szumu.

OcclusionProperties

Objekt

Właściwości opisujące okluzji na danej twarzy.

Nazwa	Typ	Opis
eyeOccluded	boolean	Wartość logiczna wskazująca, czy oczy są okludnione.
foreheadOccluded	boolean	Wartość logiczna wskazująca, czy czoło jest okludne.
mouthOccluded	boolean	Wartość logiczna wskazująca, czy usta są okludnione.

QualityForRecognition

Wyliczanie

Wskazuje jakość obrazu do rozpoznawania.

Wartość	Opis
low	Niska jakość.
medium	Średnia jakość.
high	Wysoka jakość.

RecognitionModel

Wyliczanie

Model rozpoznawania twarzy.

Wartość	Opis
recognition_01	Domyślny model rozpoznawania dla "Detect". Wszystkie te identyfikatory faceId utworzone przed marcem 2019 r. są związane z tym modelem rozpoznawania.
recognition_02	Model rozpoznawania wydany w marcu 2019 r.
recognition_03	Model rozpoznawania wydany w maju 2020 r.
recognition_04	Model rozpoznawania wydany w lutym 2021 r. Zaleca się użycie tego modelu rozpoznawania w celu uzyskania lepszej dokładności rozpoznawania.

Udostępnij przez

Face Detection Operations - Detect

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

Ocp-Apim-Subscription-Key

AADToken

Zakresy

Przykłady

Detect with Image

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AccessoryItem

AccessoryType

BlurLevel

BlurProperties

DetectionModel

ExposureLevel

ExposureProperties

FaceAttributes

FaceAttributeType

FaceDetectionResult

FaceError

FaceErrorResponse

FaceLandmarks

FaceRectangle

FacialHair

GlassesType

HairColor

HairColorType

HairProperties

HeadPose

LandmarkCoordinate

MaskProperties

MaskType

NoiseLevel

NoiseProperties

OcclusionProperties

QualityForRecognition

RecognitionModel