Face Detection Operations - Detect

Odwołanie

Usługa:: Azure AI Services

Wersja interfejsu API:: v1.2-preview.1

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ż. Wyślij wiadomość e-mail do interfejsu API rozpoznawania twarzy platformy Azure azureface@microsoft.com, jeśli masz odpowiedzialny przypadek użycia dowolnego z ograniczonych możliwości. Przeczytaj więcej na temat tej decyzji https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- 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". Aby użyć i porównać różne modele wykrywania, zapoznaj się z https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - "detection_02": atrybuty twarzy i punkty orientacyjne są wyłączone, jeśli wybierzesz ten model wykrywania.
  - "detection_03": Atrybuty twarzy (maska, rozmycie i headPose) i punkty orientacyjne są obsługiwane, jeśli wybierzesz ten model wykrywania.
- 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 artykule https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

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".
faceIdTimeToLive	query		integer int32	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	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-preview.1/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".
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

Element dostępu i odpowiedni poziom ufności.

Nazwa	Typ	Opis
confidence	number	Poziom ufności typu akcesorium. Zakres między [0,1].
type	AccessoryType	Typ akcesorium.

AccessoryType

Typ akcesorium.

Nazwa	Typ	Opis
glasses	string	Okulary.
headwear	string	Zużycie głowy.
mask	string	Maska.

BlurLevel

Wskazuje poziom rozmycia.

Nazwa	Typ	Opis
high	string	Wysoki poziom rozmycia.
low	string	Niski poziom rozmycia.
medium	string	Średni poziom rozmycia.

BlurProperties

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

Nazwa	Typ	Opis
blurLevel	BlurLevel	Wartość wyliczeniowa wskazująca poziom rozmycia.
value	number	Liczba wskazująca poziom rozmycia od 0 do 1.

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".

Nazwa	Typ	Opis
detection_01	string	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	string	Model wykrywania wydany w maju 2019 r. z lepszą dokładnością szczególnie na małych, bocznych i rozmytych twarzach.
detection_03	string	Model wykrywania wydany w 2021 r. w lutym 2021 r. z lepszą dokładnością szczególnie na małych twarzach.

ExposureLevel

Wskazuje poziom ekspozycji.

Nazwa	Typ	Opis
goodExposure	string	Dobry poziom ekspozycji.
overExposure	string	Wysoki poziom ekspozycji.
underExposure	string	Niski poziom ekspozycji.

ExposureProperties

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

Nazwa	Typ	Opis
exposureLevel	ExposureLevel	Wartość wyliczeniowa wskazująca poziom ekspozycji.
value	number	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

Atrybuty twarzy wykrytej twarzy.

Nazwa	Typ	Opis
accessories	AccessoryItem[]	Właściwości opisujące wszelkie akcesoria na danej twarzy.
age	number	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	Intensywność uśmiechu, liczba z zakresu od [0,1].

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.

Nazwa	Typ	Opis
accessories	string	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.
age	string	Wiek w latach.
blur	string	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	string	Poziom ekspozycji twarzy. Poziom zwraca wartość "GoodExposure", "OverExposure" lub "UnderExposure".
facialHair	string	Właściwości opisujące atrybuty zarostu.
glasses	string	Typ okularów. Wartości obejmują "NoGlasses", "ReadingGlasses", "Sunglasses", "SwimmingGoggles".
hair	string	Właściwości opisujące atrybuty włosów.
headPose	string	Kąty rzutowania/yaw/skoku 3-W dla kierunku twarzy.
mask	string	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.
noise	string	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
occlusion	string	Czy każdy obszar twarzy jest okludniony, w tym czoło, oczy i usta.
qualityForRecognition	string	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.
smile	string	Intensywność uśmiechu, liczba z zakresu od [0,1].

FaceDetectionResult

Odpowiedź na potrzeby wykrywania interfejsu API.

Nazwa	Typ	Opis
faceAttributes	FaceAttributes	Atrybuty twarzy wykrytej twarzy.
faceId	string	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

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

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

Nazwa	Typ	Opis
error	FaceError	Obiekt błędu.

FaceLandmarks

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

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

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

FacialHair

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

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

GlassesType

Okulary typu twarzy.

Nazwa	Typ	Opis
noGlasses	string	Brak okularów na twarzy.
readingGlasses	string	Normalne okulary na twarzy.
sunglasses	string	Okulary przeciwsłoneczne na twarzy.
swimmingGoggles	string	Pływanie gogle na twarzy.

HairColor

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	Poziom ufności koloru. Zakres między [0,1].

HairColorType

Nazwa koloru włosów.

Nazwa	Typ	Opis
black	string	Czarny.
blond	string	Blond.
brown	string	Brązowy.
gray	string	Szary.
other	string	Inny.
red	string	Czerwony.
unknown	string	Nieznany.
white	string	Biały.

HairProperties

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

Nazwa	Typ	Opis
bald	number	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

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

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

LandmarkCoordinate

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

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

MaskProperties

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

Typ maski.

Nazwa	Typ	Opis
faceMask	string	Maska.
noMask	string	Brak maski.
otherMaskOrOcclusion	string	Inne rodzaje maski lub okluzji.
uncertain	string	Niepewny.

NoiseLevel

Wskazuje poziom szumu.

Nazwa	Typ	Opis
high	string	Wysoki poziom szumu.
low	string	Niski poziom szumu.
medium	string	Średni poziom szumu.

NoiseProperties

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

Nazwa	Typ	Opis
noiseLevel	NoiseLevel	Wartość wyliczeniowa wskazująca poziom szumu.
value	number	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

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

Wskazuje jakość obrazu do rozpoznawania.

Nazwa	Typ	Opis
high	string	Wysoka jakość.
low	string	Niska jakość.
medium	string	Średnia jakość.

RecognitionModel

Model rozpoznawania twarzy.

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

Udostępnij za pośrednictwem

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

Dodatkowe zasoby