Face Detection Operations - Detect

Riferimento

Servizio:: Azure AI Services

Versione API:: v1.1-preview.1

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

Importante

Per attenuare potenziali abusi che possono essere soggetti a stereotipi, discriminazione o negazione ingiusta dei servizi, stiamo ritirando attributi dell'API Viso che stimano emozioni, sesso, età, sorriso, capelli facciali, capelli e trucco. Per altre informazioni su questa decisione https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/, vedere .

- Nessuna immagine verrà archiviata. Solo le funzionalità del viso estratte verranno archiviate nel server. FaceId è un identificatore della funzionalità viso e verrà usato in "Identifica", "Verifica" e "Trova simile". 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, occlusion, accessori, blur, esposizione, rumore, maschera e qualitàForRecognition. Alcuni dei risultati restituiti per attributi specifici potrebbero non essere estremamente accurati.
- Sono supportati JPEG, PNG, GIF (primo frame) e formato BMP. Le dimensioni consentite del file di immagine sono da 1 KB a 6 MB.
- Le dimensioni minime del viso rilevabili sono 36x36 pixel in un'immagine non superiore a 1920x1080 pixel. Le immagini con dimensioni superiori a 1920x1080 pixel richiedono dimensioni minime proporzionali maggiori.
- È possibile restituire fino a 100 visi per un'immagine. I visi sono classificati in base alle dimensioni del rettangolo viso da grandi a piccole.
- Per risultati ottimali quando si esegue una query su "Identifica", "Verifica" e "Trova simile" ('returnFaceId' è true), usare i visi che sono: frontali, chiari e con dimensioni minime di 200x200 pixel (100 pixel tra gli occhi).
- È possibile specificare valori diversi di 'detectionModel'. Per usare e confrontare modelli di rilevamento diversi, fare riferimento a https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - 'detection_02': gli attributi e i punti di riferimento viso sono disabilitati se si sceglie questo modello di rilevamento.
  - 'detection_03': attributi viso (maschera, blur e headPose) e punti di riferimento sono supportati se si sceglie questo modello di rilevamento.
- Vengono forniti valori 'recognitionModel' diversi. Se sono necessarie operazioni di completamento come "Verifica", "Identifica", "Trova simile", specificare il modello di riconoscimento con il parametro 'recognitionModel'. Il valore predefinito per 'recognitionModel' è 'recognition_01', se necessario, specificare in modo esplicito il modello necessario in questo parametro. Dopo aver specificato, i faceId rilevati verranno associati al modello di riconoscimento specificato. Altri dettagli, 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://{resource-name}.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 compreso tra 60 secondi e 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'. "recognition_04" è consigliato poiché 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,glasses'. L'analisi degli attributi viso ha costi di calcolo e tempo aggiuntivi.
returnFaceId	query		boolean	Restituisce faceId dei visi rilevati o meno. Il valore predefinito è true.
returnFaceLandmarks	query		boolean	Restituisce punti di riferimento del viso dei visi rilevati o meno. Il valore predefinito è false.
returnRecognitionModel	query		boolean	Restituisce 'recognitionModel' o meno. Il valore predefinito è false. Questa operazione è applicabile solo quando returnFaceId = true.

Corpo della richiesta

Media Types: "application/octet-stream"

Nome	Tipo	Descrizione
imageContent	string	Binario dell'immagine di input.

Risposte

Nome	Tipo	Descrizione
200 OK	FaceDetectionResult[]	Una chiamata riuscita restituisce una matrice di voci del viso classificate in base alle dimensioni del rettangolo 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 riuscita restituisce una matrice di voci del viso classificate in base alle dimensioni del rettangolo 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 Azure AI Face.

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

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 attendibilità 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 del 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,glasses'. L'analisi degli attributi viso comporta costi aggiuntivi per il calcolo e il tempo.
FaceDetectionResult	Risposta per rilevare l'API.
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	Occhiali di tipo viso.
HairColor	Matrice di colori candidati e livello di confidenza in presenza di ognuno.
HairColorType	Nome del colore dei capelli.
HairProperties	Proprietà che descrivono gli attributi dei capelli.
HeadPose	3D roll/yaw/pitch angolo 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 attendibilità corrispondente.

Nome	Tipo	Descrizione
confidence	number	Livello di attendibilità 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	Indossa la testa.
mask	string	Maschera.

BlurLevel

Indica il livello di sfocatura.

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

BlurProperties

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

Nome	Tipo	Descrizione
blurLevel	BlurLevel	Valore enumerazione che indica il livello di sfocatura.
value	number	Numero che indica il livello di sfocatura che varia 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 volti frontali vicino. Per scenari con visi estremamente grandi (posizione della testa), volti occlusi o orientamento errato dell'immagine, è possibile che i visi in questi casi non vengano rilevati.
detection_02	string	Modello di rilevamento rilasciato nel 2019 maggio con una maggiore accuratezza soprattutto su visi piccoli, laterali e sfocati.
detection_03	string	Modello di rilevamento rilasciato nel 2021 febbraio con un'accuratezza migliorata soprattutto per i visi di piccole dimensioni.

ExposureLevel

Indica il livello di esposizione.

Nome	Tipo	Descrizione
goodExposure	string	Livello di esposizione ottimale.
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 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) è buona esposizione. [0,75, 1] è in corso l'esposizione.

FaceAttributes

Attributi del viso per il viso rilevato.

Nome	Tipo	Descrizione
accessories	AccessoryItem[]	Proprietà che descrivono tutti gli 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	Gli occhiali digitano se uno dei visi.
hair	HairProperties	Proprietà che descrivono gli attributi dei capelli.
headPose	HeadPose	Angoli 3D roll/yaw/pitch 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 in merito al fatto che l'immagine usata nel rilevamento sia di qualità sufficiente per tentare il riconoscimento del viso.
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,glasses'. 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 "maschera". Matrice vuota indica che non sono stati rilevati accessori. Si noti che è dopo che è stato rilevato un viso. La maschera di grandi dimensioni potrebbe comportare 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 di occhiali. I valori includono 'NoGlasses', 'ReadingGlasses', 'Occhiali da sole', 'SwimmingGoggles'.
hair	string	Proprietà che descrivono gli attributi dei capelli.
headPose	string	Angoli 3D roll/yaw/pitch per la direzione del viso.
mask	string	Se ogni viso indossa una maschera. Il tipo di maschera restituisce 'noMask', 'faceMask', 'otherMaskOrOcclusion' o 'certo'. 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	Se ogni area facciale è occlusa, compresa la fronte, gli occhi e la bocca.
qualityForRecognition	string	La qualità complessiva dell'immagine relativa al fatto che l'immagine usata nel rilevamento sia di qualità sufficiente per tentare il riconoscimento del viso. Il valore è una classificazione informale di basso, medio o alto. Per gli scenari di identificazione è consigliabile usare solo immagini di qualità elevata 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 rilevare l'API.

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 con 27 punti di riferimento che indicano le 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' viene 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 dell'occhio sinistro interno.
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 dell'alar.
noseRightAlarOutTip	LandmarkCoordinate	Coordinate del naso a forma di punta alara destra.
noseRightAlarTop	LandmarkCoordinate	Coordinate del naso in alto alar.
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 sinistra.
pupilRight	LandmarkCoordinate	Coordinate della pupilla destra.
underLipBottom	LandmarkCoordinate	Coordinate della parte inferiore del labbro.
underLipTop	LandmarkCoordinate	Coordinate della parte inferiore del labbro.
upperLipBottom	LandmarkCoordinate	Coordinate del labbro superiore.
upperLipTop	LandmarkCoordinate	Coordinate della parte superiore del labbro.

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, espressa in pixel.
top	integer	Distanza dal bordo superiore se l'immagine al bordo superiore del rettangolo, espressa 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 attendibilità associato a una proprietà.
moustache	number	Numero compreso tra 0 e 1 che indica un livello di attendibilità associato a una proprietà.
sideburns	number	Numero compreso tra 0 e 1 che indica un livello di attendibilità associato a una proprietà.

GlassesType

Occhiali di tipo viso.

Nome	Tipo	Descrizione
noGlasses	string	Nessun bicchiere sul viso.
readingGlasses	string	Occhiali normali sul viso.
sunglasses	string	Occhiali da sole sul viso.
swimmingGoggles	string	Il nuoto passa sul viso.

HairColor

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

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

HairColorType

Nome del colore dei capelli.

Nome	Tipo	Descrizione
black	string	Nero.
blond	string	Bionda.
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	Un numero che descrive il livello di fiducia di se la persona è balda.
hairColor	HairColor[]	Matrice di colori candidati e livello di confidenza in presenza di ognuno.
invisible	boolean	Valore booleano che descrive se i capelli sono visibili nell'immagine.

HeadPose

3D roll/yaw/pitch angolo 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.
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 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) è buona esposizione. [0,75, 1] è in corso l'esposizione. [0, 0,3) è basso livello di rumore. [0,3, 0,7) è 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 testa è occlusa.
mouthOccluded	boolean	Valore booleano che indica se la bocca è occlusa.

QualityForRecognition

Indica la qualità dell'immagine per il riconoscimento.

Nome	Tipo	Descrizione
high	string	Qualità elevata.
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 2020 maggio.
recognition_04	string	Modello di riconoscimento rilasciato nel 2021 febbraio. È consigliabile usare questo modello di riconoscimento per una migliore 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