Face Detection Operations - Detect

Riferimento

Servizio:: Azure AI Services

Versione API:: v1.2-preview.1

Rilevare i visi umani in un'immagine, restituire rettangoli del viso e facoltativamente con faceId, punti di riferimento e attributi.

Importante

Microsoft ha ritirato o limitato funzionalità di riconoscimento facciale che possono essere usate per cercare di dedurre gli stati emotivi e gli attributi di identità che, se usati in modo improprio, possono essere soggetti a stereotipi, discriminazione o negazione sleale dei servizi. Le capacità ritirata sono emozioni e sesso. Le funzionalità limitate sono età, sorriso, capelli facciali, capelli e trucco. Inviare un messaggio di posta elettronica all'API Viso di Azure azureface@microsoft.com se si ha un caso d'uso responsabile che trarrebbe vantaggio dall'uso di una delle funzionalità limitate. Altre informazioni su questa decisione https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- Nessuna immagine verrà archiviata. Solo le caratteristiche del viso estratte verranno archiviate nel server. FaceId è un identificatore della funzionalità viso e verrà usato in "Identificazione", "Verifica" e "Trova simili". Le funzionalità del viso archiviate scadono e verranno eliminate al momento specificato da faceIdTimeToLive dopo la chiamata di rilevamento originale.
- I parametri facoltativi includono faceId, punti di riferimento e attributi. Gli attributi includono headPose, occhiali, occlusione, accessori, sfocatura, esposizione, rumore, maschera e qualitàForRecognition. Alcuni dei risultati restituiti per attributi specifici potrebbero non essere altamente accurati.
- Sono supportati JPEG, PNG, GIF (il primo fotogramma) e il formato BMP. Le dimensioni consentite del file di immagine sono da 1 KB a 6 MB.
- La dimensione minima del viso rilevabile è di 36x36 pixel in un'immagine non superiore a 1920x1080 pixel. Le immagini con dimensioni superiori a 1920x1080 pixel avranno bisogno di una dimensione minima minima proporzionale.
- È possibile restituire fino a 100 visi per un'immagine. I visi vengono classificati in base alle dimensioni del rettangolo del viso da grandi a piccole.
- Per ottenere risultati ottimali quando si esegue una query su "Identify", "Verify" e "Find Similar" ('returnFaceId' è true), usare visi che sono: frontal, clear e con una dimensione minima di 200x200 pixel (100 pixel tra gli occhi).
- È possibile specificare valori diversi di 'detectionModel'. Per usare e confrontare modelli di rilevamento diversi, vedere https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - 'detection_02': gli attributi e i punti di riferimento del viso sono disabilitati se si sceglie questo modello di rilevamento.
  - 'detection_03': gli attributi del viso (maschera, sfocatura e headPose) e i punti di riferimento sono supportati se si sceglie questo modello di rilevamento.
- Vengono forniti valori diversi di 'recognitionModel'. Se sono necessarie operazioni di completamento come "Verify", "Identify", "Find Similar", (Trova simile), specificare il modello di riconoscimento con il parametro "recognitionModel". Il valore predefinito per 'recognitionModel' è 'recognition_01', se necessario il modello più recente, specificare in modo esplicito il modello necessario in questo parametro. Una volta specificato, i faceId rilevati verranno associati al modello di riconoscimento specificato. Per altre informazioni, vedere https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
apiVersion	path	True	string	Versione API
endpoint	path	True	string uri	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://{nome-risorsa}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	'detectionModel' associato ai faceId rilevati. I valori 'detectionModel' supportati includono 'detection_01', 'detection_02' e 'detection_03'. Il valore predefinito è 'detection_01'.
faceIdTimeToLive	query		integer int32	Numero di secondi per l'ID viso memorizzato nella cache. Intervallo supportato da 60 secondi fino a 86400 secondi. Il valore predefinito è 86400 (24 ore).
recognitionModel	query		RecognitionModel	'recognitionModel' associato ai faceId rilevati. I valori 'recognitionModel' supportati includono 'recognition_01', 'recognition_02', 'recognition_03' o 'recognition_04'. Il valore predefinito è 'recognition_01'. È consigliabile "recognition_04" perché la sua accuratezza è migliorata sui volti che indossano maschere rispetto a "recognition_03" e la sua accuratezza complessiva è migliorata rispetto a "recognition_01" e "recognition_02".
returnFaceAttributes	query		FaceAttributeType[]	Analizzare e restituire uno o più attributi del viso specificati nella stringa delimitata da virgole, ad esempio 'returnFaceAttributes=headPose,occhiali'. L'analisi degli attributi viso comporta costi aggiuntivi per il calcolo e il tempo.
returnFaceId	query		boolean	Restituisce faceId dei visi rilevati o meno. Il valore predefinito è true.
returnFaceLandmarks	query		boolean	Restituisce o meno i punti di riferimento del viso dei visi rilevati. Il valore predefinito è false.
returnRecognitionModel	query		boolean	Restituisce o meno 'recognitionModel'. Il valore predefinito è false. Questo è applicabile solo quando returnFaceId = true.

Corpo della richiesta

Media Types: "application/octet-stream"

Nome	Tipo	Descrizione
imageContent	string	File binario dell'immagine di input.

Risposte

Nome	Tipo	Descrizione
200 OK	FaceDetectionResult[]	Una chiamata con esito positivo restituisce una matrice di voci del viso classificate in base alle dimensioni del rettangolo del viso in ordine decrescente. Una risposta vuota indica che non sono stati rilevati visi.
Other Status Codes	FaceErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

200 OK

FaceDetectionResult[]

Una chiamata con esito positivo restituisce una matrice di voci del viso classificate in base alle dimensioni del rettangolo del viso in ordine decrescente. Una risposta vuota indica che non sono stati rilevati visi.

Other Status Codes

FaceErrorResponse

Risposta di errore imprevista.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Viso di Intelligenza artificiale di Azure.

Tipo: apiKey
In: header

AADToken

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Ambiti

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Detect with Image

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
    }
  }
]

Definizioni

Nome	Descrizione
AccessoryItem	Elemento accessorio e livello di confidenza corrispondente.
AccessoryType	Tipo di accessorio.
BlurLevel	Indica il livello di sfocatura.
BlurProperties	Proprietà che descrivono qualsiasi presenza di sfocatura all'interno dell'immagine.
DetectionModel	'detectionModel' associato ai faceId rilevati. I valori 'detectionModel' supportati includono 'detection_01', 'detection_02' e 'detection_03'. Il valore predefinito è 'detection_01'.
ExposureLevel	Indica il livello di esposizione.
ExposureProperties	Proprietà che descrivono il livello di esposizione dell'immagine.
FaceAttributes	Attributi viso per il viso rilevato.
FaceAttributeType	Analizzare e restituire uno o più attributi del viso specificati nella stringa delimitata da virgole, ad esempio 'returnFaceAttributes=headPose,occhiali'. L'analisi degli attributi viso comporta costi aggiuntivi per il calcolo e il tempo.
FaceDetectionResult	Risposta per l'API di rilevamento.
FaceError	Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Risposta contenente i dettagli dell'errore.
FaceLandmarks	Raccolta di punti di riferimento del viso a 27 punti che puntano alle posizioni importanti dei componenti del viso.
FaceRectangle	Rettangolo all'interno del quale è possibile trovare un viso.
FacialHair	Proprietà che descrivono gli attributi dei capelli facciali.
GlassesType	Tipo di occhiali del viso.
HairColor	Matrice di colori candidati e livello di confidenza in presenza di ognuno di essi.
HairColorType	Nome del colore dei capelli.
HairProperties	Proprietà che descrivono gli attributi dei capelli.
HeadPose	Angoli di rotazione/yaw/inclinazione 3D per la direzione del viso.
LandmarkCoordinate	Coordinate di riferimento all'interno di un'immagine.
MaskProperties	Proprietà che descrivono la presenza di una maschera su un determinato viso.
MaskType	Tipo della maschera.
NoiseLevel	Indica il livello di rumore.
NoiseProperties	Proprietà che descrivono il livello di rumore dell'immagine.
OcclusionProperties	Proprietà che descrivono occlusioni su un determinato viso.
QualityForRecognition	Indica la qualità dell'immagine per il riconoscimento.
RecognitionModel	Modello di riconoscimento per il viso.

AccessoryItem

Elemento accessorio e livello di confidenza corrispondente.

Nome	Tipo	Descrizione
confidence	number	Livello di confidenza del tipo di accessorio. Intervallo compreso tra [0,1].
type	AccessoryType	Tipo di accessorio.

AccessoryType

Tipo di accessorio.

Nome	Tipo	Descrizione
glasses	string	Occhiali.
headwear	string	Usura della testa.
mask	string	Maschera.

BlurLevel

Indica il livello di sfocatura.

Nome	Tipo	Descrizione
high	string	Alto livello di sfocatura.
low	string	Basso livello di sfocatura.
medium	string	Livello di sfocatura medio.

BlurProperties

Proprietà che descrivono qualsiasi presenza di sfocatura all'interno dell'immagine.

Nome	Tipo	Descrizione
blurLevel	BlurLevel	Valore di enumerazione che indica il livello di sfocatura.
value	number	Numero che indica il livello di sfocatura che va da 0 a 1.

DetectionModel

'detectionModel' associato ai faceId rilevati. I valori 'detectionModel' supportati includono 'detection_01', 'detection_02' e 'detection_03'. Il valore predefinito è 'detection_01'.

Nome	Tipo	Descrizione
detection_01	string	Modello di rilevamento predefinito. Consigliato per il rilevamento dei visi quasi frontali. Per scenari con visi ad angolo estremamente grande (posizione della testa), volti occlusi o orientamento errato dell'immagine, i visi in tali casi potrebbero non essere rilevati.
detection_02	string	Modello di rilevamento rilasciato nel 2019 maggio con una maggiore precisione soprattutto sui visi piccoli, laterali e sfocati.
detection_03	string	Modello di rilevamento rilasciato nel 2021 febbraio con una maggiore accuratezza soprattutto sui visi piccoli.

ExposureLevel

Indica il livello di esposizione.

Nome	Tipo	Descrizione
goodExposure	string	Buon livello di esposizione.
overExposure	string	Alto livello di esposizione.
underExposure	string	Basso livello di esposizione.

ExposureProperties

Proprietà che descrivono il livello di esposizione dell'immagine.

Nome	Tipo	Descrizione
exposureLevel	ExposureLevel	Valore di enumerazione che indica il livello di esposizione.
value	number	Numero che indica il livello di esposizione compreso tra 0 e 1. [0, 0,25) è sotto esposizione. [0,25, 0,75) è una buona esposizione. [0,75, 1] è oltre l'esposizione.

FaceAttributes

Attributi viso per il viso rilevato.

Nome	Tipo	Descrizione
accessories	AccessoryItem[]	Proprietà che descrivono eventuali accessori su un determinato viso.
age	number	Età in anni.
blur	BlurProperties	Proprietà che descrivono qualsiasi presenza di sfocatura all'interno dell'immagine.
exposure	ExposureProperties	Proprietà che descrivono il livello di esposizione dell'immagine.
facialHair	FacialHair	Proprietà che descrivono gli attributi dei capelli facciali.
glasses	GlassesType	Occhiali di tipo se uno dei visi.
hair	HairProperties	Proprietà che descrivono gli attributi dei capelli.
headPose	HeadPose	Angoli di rotazione/yaw/inclinazione 3D per la direzione del viso.
mask	MaskProperties	Proprietà che descrivono la presenza di una maschera su un determinato viso.
noise	NoiseProperties	Proprietà che descrivono il livello di rumore dell'immagine.
occlusion	OcclusionProperties	Proprietà che descrivono occlusioni su un determinato viso.
qualityForRecognition	QualityForRecognition	Proprietà che descrivono la qualità complessiva dell'immagine relativa al fatto che l'immagine utilizzata nel rilevamento sia di qualità sufficiente per tentare il riconoscimento dei volti.
smile	number	Intensità del sorriso, numero compreso tra [0,1].

FaceAttributeType

Analizzare e restituire uno o più attributi del viso specificati nella stringa delimitata da virgole, ad esempio 'returnFaceAttributes=headPose,occhiali'. L'analisi degli attributi viso comporta costi aggiuntivi per il calcolo e il tempo.

Nome	Tipo	Descrizione
accessories	string	Accessori intorno al viso, tra cui 'headwear', 'occhiali' e 'mask'. Matrice vuota indica che non sono stati rilevati accessori. Si noti che è dopo che è stato rilevato un viso. La maschera di grandi dimensioni potrebbe causare il rilevamento di nessun viso.
age	string	Età in anni.
blur	string	Il viso è sfocato o meno. Level restituisce 'Low', 'Medium' o 'High'. Il valore restituisce un numero compreso tra [0,1], maggiore è il più sfocato.
exposure	string	Livello di esposizione del viso. Level restituisce 'GoodExposure', 'OverExposure' o 'UnderExposure'.
facialHair	string	Proprietà che descrivono gli attributi dei capelli facciali.
glasses	string	Tipo occhiali. I valori includono 'NoGlasses', 'ReadingGlasses', 'Sunglasses', 'SwimmingGoggles'.
hair	string	Proprietà che descrivono gli attributi dei capelli.
headPose	string	Angoli di rotazione/yaw/inclinazione 3D per la direzione del viso.
mask	string	Se ogni viso indossa una maschera. Il tipo mask restituisce 'noMask', 'faceMask', 'otherMaskOrOcclusion' o 'incerto'. Il valore restituisce un valore booleano 'noseAndMouthCovered' che indica se il naso e la bocca sono coperti.
noise	string	Livello di rumore dei pixel del viso. Level restituisce 'Low', 'Medium' e 'High'. Il valore restituisce un numero compreso tra [0,1], più grande è il più rumoroso
occlusion	string	Indica se ogni area del viso è occlusa, inclusa la fronte, gli occhi e la bocca.
qualityForRecognition	string	La qualità complessiva dell'immagine relativa al fatto che l'immagine utilizzata nel rilevamento sia di qualità sufficiente per tentare il riconoscimento dei volti. Il valore è una classificazione informale di basso, medio o alto. Per gli scenari di identificazione è consigliabile usare solo immagini di qualità "alta" per la registrazione delle persone e la qualità superiore o superiore a "media". L'attributo è disponibile solo quando si usano modelli di riconoscimento recognition_03 o recognition_04.
smile	string	Intensità del sorriso, numero compreso tra [0,1].

FaceDetectionResult

Risposta per l'API di rilevamento.

Nome	Tipo	Descrizione
faceAttributes	FaceAttributes	Attributi del viso per il viso rilevato.
faceId	string	FaceId univoco del viso rilevato, creato dall'API di rilevamento e scadrà 24 ore dopo la chiamata di rilevamento. Per restituire questo risultato, è necessario che il parametro 'returnFaceId' sia true.
faceLandmarks	FaceLandmarks	Matrice di punti di riferimento del viso a 27 punti che puntano alle posizioni importanti dei componenti del viso. Per restituire questo risultato, è necessario che il parametro 'returnFaceLandmarks' sia true.
faceRectangle	FaceRectangle	Area rettangolo per la posizione del viso nell'immagine.
recognitionModel	RecognitionModel	'recognitionModel' associato a questo faceId. Viene restituito solo quando 'returnRecognitionModel' è impostato in modo esplicito su true.

FaceError

Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
message	string	Rappresentazione leggibile dell'errore.

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	FaceError	Oggetto error.

FaceLandmarks

Raccolta di punti di riferimento del viso a 27 punti che puntano alle posizioni importanti dei componenti del viso.

Nome	Tipo	Descrizione
eyeLeftBottom	LandmarkCoordinate	Coordinate dell'occhio sinistro.
eyeLeftInner	LandmarkCoordinate	Coordinate dell'occhio sinistro interno.
eyeLeftOuter	LandmarkCoordinate	Coordinate dell'occhio sinistro esterno.
eyeLeftTop	LandmarkCoordinate	Coordinate dell'occhio sinistro.
eyeRightBottom	LandmarkCoordinate	Coordinate dell'occhio destro.
eyeRightInner	LandmarkCoordinate	Coordinate dell'occhio destro interno.
eyeRightOuter	LandmarkCoordinate	Coordinate dell'occhio destro esterno.
eyeRightTop	LandmarkCoordinate	Coordinate dell'occhio destro.
eyebrowLeftInner	LandmarkCoordinate	Coordinate della sopracciglia sinistra interna.
eyebrowLeftOuter	LandmarkCoordinate	Coordinate della sopracciglia sinistra esterna.
eyebrowRightInner	LandmarkCoordinate	Coordinate della sopracciglia destra interna.
eyebrowRightOuter	LandmarkCoordinate	Coordinate della sopracciglia destra esterna.
mouthLeft	LandmarkCoordinate	Coordinate della bocca sinistra.
mouthRight	LandmarkCoordinate	Coordinate della bocca destra.
noseLeftAlarOutTip	LandmarkCoordinate	Le coordinate del naso hanno lasciato la punta alara.
noseLeftAlarTop	LandmarkCoordinate	Le coordinate del naso a sinistra della parte superiore alara.
noseRightAlarOutTip	LandmarkCoordinate	Le coordinate del naso a forma di punta alara verticale.
noseRightAlarTop	LandmarkCoordinate	Coordinate del naso superiore alaro.
noseRootLeft	LandmarkCoordinate	Coordinate della radice del naso a sinistra.
noseRootRight	LandmarkCoordinate	Coordinate della radice del naso a destra.
noseTip	LandmarkCoordinate	Coordinate della punta del naso.
pupilLeft	LandmarkCoordinate	Coordinate della pupilla dell'occhio sinistro.
pupilRight	LandmarkCoordinate	Coordinate della pupilla destra.
underLipBottom	LandmarkCoordinate	Le coordinate della parte inferiore del labbro.
underLipTop	LandmarkCoordinate	Coordinate della parte inferiore del labbro.
upperLipBottom	LandmarkCoordinate	Coordinate del fondo del labbro superiore.
upperLipTop	LandmarkCoordinate	Coordinate della parte superiore del labbro superiore.

FaceRectangle

Rettangolo all'interno del quale è possibile trovare un viso.

Nome	Tipo	Descrizione
height	integer	Altezza del rettangolo, in pixel.
left	integer	Distanza dal bordo sinistro se l'immagine al bordo sinistro del rettangolo, in pixel.
top	integer	Distanza dal bordo superiore se l'immagine al bordo superiore del rettangolo, in pixel.
width	integer	Larghezza del rettangolo, in pixel.

FacialHair

Proprietà che descrivono gli attributi dei capelli facciali.

Nome	Tipo	Descrizione
beard	number	Numero compreso tra 0 e 1 che indica un livello di confidenza associato a una proprietà.
moustache	number	Numero compreso tra 0 e 1 che indica un livello di confidenza associato a una proprietà.
sideburns	number	Numero compreso tra 0 e 1 che indica un livello di confidenza associato a una proprietà.

GlassesType

Tipo di occhiali del viso.

Nome	Tipo	Descrizione
noGlasses	string	Niente occhiali sul viso.
readingGlasses	string	Occhiali normali sul viso.
sunglasses	string	Occhiali da sole sul viso.
swimmingGoggles	string	Nuota con le gole sulla faccia.

HairColor

Matrice di colori candidati e livello di confidenza in presenza di ognuno di essi.

Nome	Tipo	Descrizione
color	HairColorType	Nome del colore dei capelli.
confidence	number	Livello di confidenza del colore. Intervallo compreso tra [0,1].

HairColorType

Nome del colore dei capelli.

Nome	Tipo	Descrizione
black	string	Nero.
blond	string	Biondo.
brown	string	Marrone.
gray	string	Grigio.
other	string	Altro.
red	string	Rosso.
unknown	string	Sconosciuto.
white	string	Bianco.

HairProperties

Proprietà che descrivono gli attributi dei capelli.

Nome	Tipo	Descrizione
bald	number	Numero che descrive il livello di confidenza che indica se la persona è calva.
hairColor	HairColor[]	Matrice di colori candidati e livello di confidenza in presenza di ognuno di essi.
invisible	boolean	Valore booleano che descrive se i capelli sono visibili nell'immagine.

HeadPose

Angoli di rotazione/yaw/inclinazione 3D per la direzione del viso.

Nome	Tipo	Descrizione
pitch	number	Valore degli angoli.
roll	number	Valore degli angoli.
yaw	number	Valore degli angoli.

LandmarkCoordinate

Coordinate di riferimento all'interno di un'immagine.

Nome	Tipo	Descrizione
x	number	Componente orizzontale, in pixel.
y	number	Componente verticale, in pixel.

MaskProperties

Proprietà che descrivono la presenza di una maschera su un determinato viso.

Nome	Tipo	Descrizione
noseAndMouthCovered	boolean	Valore booleano che indica se il naso e la bocca sono coperti.
type	MaskType	Tipo della maschera.

MaskType

Tipo della maschera.

Nome	Tipo	Descrizione
faceMask	string	Maschera per il viso.
noMask	string	Nessuna maschera.
otherMaskOrOcclusion	string	Altri tipi di maschera o occlusione.
uncertain	string	Incerto.

NoiseLevel

Indica il livello di rumore.

Nome	Tipo	Descrizione
high	string	Alto livello di rumore.
low	string	Basso livello di rumore.
medium	string	Livello di rumore medio.

NoiseProperties

Proprietà che descrivono il livello di rumore dell'immagine.

Nome	Tipo	Descrizione
noiseLevel	NoiseLevel	Valore di enumerazione che indica il livello di rumore.
value	number	Numero che indica il livello di rumore compreso tra 0 e 1. [0, 0,25) è sotto esposizione. [0,25, 0,75) è una buona esposizione. [0,75, 1] è oltre l'esposizione. [0, 0,3) è basso livello di rumore. [0,3, 0,7) è un livello di rumore medio. [0,7, 1] è alto livello di rumore.

OcclusionProperties

Proprietà che descrivono occlusioni su un determinato viso.

Nome	Tipo	Descrizione
eyeOccluded	boolean	Valore booleano che indica se gli occhi sono occlusi.
foreheadOccluded	boolean	Valore booleano che indica se la fronte è bloccata.
mouthOccluded	boolean	Valore booleano che indica se la bocca è occlusa.

QualityForRecognition

Indica la qualità dell'immagine per il riconoscimento.

Nome	Tipo	Descrizione
high	string	Alta qualità.
low	string	Bassa qualità.
medium	string	Qualità media.

RecognitionModel

Modello di riconoscimento per il viso.

Nome	Tipo	Descrizione
recognition_01	string	Modello di riconoscimento predefinito per "Detect". Tutti i faceId creati prima del 2019 marzo sono associati a questo modello di riconoscimento.
recognition_02	string	Modello di riconoscimento rilasciato nel marzo 2019.
recognition_03	string	Modello di riconoscimento rilasciato nel maggio 2020.
recognition_04	string	Modello di riconoscimento rilasciato nel 2021 febbraio. È consigliabile usare questo modello di riconoscimento per migliorare l'accuratezza del riconoscimento.

Condividi tramite

Face Detection Operations - Detect

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

AADToken

Ambiti

Esempio

Detect with Image

Esempio di richiesta

Risposta di esempio

Definizioni

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

Risorse aggiuntive