Face Detection Operations - Detect

Odwołanie

Usługa:: Azure AI Services

Wersja interfejsu API:: v1.1-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żne

Aby ograniczyć potencjalne nadużycie, które mogą podlegać stereotypom, dyskryminacji lub niesprawiedliwej odmowie usług, wycofujemy atrybuty interfejsu API rozpoznawania twarzy, które przewidują emocje, płeć, wiek, uśmiech, zarost, włosy i makijaż. 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. Na serwerze będą przechowywane tylko wyodrębnione funkcje twarzy. 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, oklusion, akcesoria, rozmycie, ekspozycja, hałas, maska i jakośćForRecognition. 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 36 x 36 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żego do małego.
- 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ą: frontalne, jasne i o minimalnym rozmiarze 200 x 200 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 tematem 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) oraz punkty orientacyjne są obsługiwane, jeśli wybierzesz ten model wykrywania.
- Podano różne wartości "recognitionModel". Jeśli są potrzebne operacje monitowania, takie jak "Verify", "Identify", "Find Similar", podaj model rozpoznawania za pomocą parametru "recognitionModel". Wartość domyślna elementu "recognitionModel" to "recognition_01", jeśli wymagany jest 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 temacie 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ą "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ść zwiększa się 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	Zwracanie identyfikatorów faceId wykrytych twarzy lub nie. Wartością domyślną jest true.
returnFaceLandmarks	query		boolean	Zwracanie punktów charakterystycznych twarzy wykrytych 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 uporządkowanych 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 uporządkowanych 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 usługi 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.1-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 akcesorium 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ą "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 dodatkowy koszt obliczeniowy i czasowy.
FaceDetectionResult	Odpowiedź na potrzeby wykrywania interfejsu API.
FaceError	Obiekt error. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, skorzystaj z następującego linku: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpowiedź zawierająca szczegóły błędu.
FaceLandmarks	Kolekcja 27-punktowych punktów orientacyjnych twarzy wskazująca ważne położenie 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 akcesorium i odpowiedni poziom ufności.

Nazwa	Typ	Opis
confidence	number	Poziom ufności typu akcesorium. Zakres od [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ść wyliczenia wskazująca poziom rozmycia.
value	number	Liczba wskazująca poziom rozmycia w zakresie od 0 do 1.

DetectionModel

Element "detectionModel" skojarzony z wykrytymi identyfikatorami faceId. Obsługiwane wartości "detectionModel" obejmują "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 w pobliżu frontalu. 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 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 dobrą ekspozycją. [0,75, 1] jest ponad ekspozycji.

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 włosów na twarzy.
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 rozpoznawania 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 dodatkowy koszt obliczeniowy i czasowy.

Nazwa	Typ	Opis
accessories	string	Akcesoria wokół twarzy, w tym "zakrycie 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ść "Niski", "Średni" lub "Wysoki". 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 włosów na twarzy.
glasses	string	Typ okularów. Wartości obejmują "NoGlasses", "ReadingGlasses", "Okulary przeciwsłoneczne", "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ść "Niski", "Średni" i "Wysoki". Wartość zwraca liczbę z przedziału od [0,1], tym większa wartość hałaśliwsza
occlusion	string	Czy każdy obszar twarzy jest okluded, w tym czoło, oczy i usta.
qualityForRecognition	string	Ogólna jakość obrazu dotycząca tego, czy obraz używany w wykrywaniu jest wystarczająca do podjęcia próby rozpoznawania twarzy. Wartość jest nieformalną oceną niskiej, średniej lub wysokiej. W scenariuszach identyfikacji zalecane są tylko obrazy o wysokiej jakości dla rejestracji osób i jakości 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ć, wymaga parametru "returnFaceId" na wartość true.
faceLandmarks	FaceLandmarks	układ 27 charakterystycznych punktów twarzy wskazujący położenie istotnych części twarzy. Aby to zwrócić, wymaga wartości "returnFaceLandmarks" parametru 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 jako true.

FaceError

Obiekt error. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, skorzystaj z następującego linku: 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 orientacyjnych twarzy wskazująca ważne położenie składników twarzy.

Nazwa	Typ	Opis
eyeLeftBottom	LandmarkCoordinate	Współrzędne lewego oka w dolnej części.
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 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 rogu 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 pozostawiły naciśniętą końcówkę.
noseLeftAlarTop	LandmarkCoordinate	Współrzędne lewej górnej części nosa.
noseRightAlarOutTip	LandmarkCoordinate	Współrzędne nosa prawą wskazówkę na wierzchołku.
noseRightAlarTop	LandmarkCoordinate	Współrzędne nosu w prawym górnym rogu.
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 prawej źrenicy oka.
underLipBottom	LandmarkCoordinate	Współrzędne pod wargią.
underLipTop	LandmarkCoordinate	Współrzędne górnej części wargi.
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 od [0,1].

HairColorType

Nazwa koloru włosów.

Nazwa	Typ	Opis
black	string	Czarny.
blond	string	Blondynka.
brown	string	Brązowy.
gray	string	Szary.
other	string	Inne.
red	string	Czerwony.
unknown	string	Nieznane.
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 typy masek lub okluzji.
uncertain	string	Niepewne.

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ść wyliczenia wskazująca poziom szumu.
value	number	Liczba wskazująca poziom szumu od 0 do 1. [0, 0,25) jest narażenie. [0,25, 0,75) jest dobrą ekspozycją. [0,75, 1] jest ponad ekspozycji. [0, 0,3) to 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ą okludowane.
foreheadOccluded	boolean	Wartość logiczna wskazująca, czy nagłówek jest occluded.
mouthOccluded	boolean	Wartość logiczna wskazująca, czy usta są okludowane.

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