Faces - Compare

Servizio:

Azure AI Services

Versione API:

2025-05-01-preview

Confronta la somiglianza tra due volti.

POST {endpoint}/contentunderstanding/faces:compare?api-version=2025-05-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	Informazioni sul contenuto dell'endpoint del servizio.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-request-id		string (uuid)	Identificatore di stringa opaco, univoco a livello globale e generato dal client per la richiesta.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
faceSource1	True	FaceSource	Prima faccia da confrontare.
faceSource2	True	FaceSource	Seconda faccia da confrontare.

Risposte

Nome	Tipo	Descrizione
200 OK	CompareFacesResult	La richiesta ha avuto esito positivo.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

OAuth2Auth

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize
URL token: https://login.microsoftonline.com/common/oauth2/token

Ambiti

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

Esempio

Compare the Similarity Between Two Faces

Esempio di richiesta

HTTP

POST {endpoint}/contentunderstanding/faces:compare?api-version=2025-05-01-preview

{
  "faceSource1": {
    "url": "https://mystorageaccount.blob.core.windows.net/images/faces/face1.jpg",
    "targetBoundingBox": {
      "left": 33,
      "top": 73,
      "width": 262,
      "height": 324
    }
  },
  "faceSource2": {
    "data": "RXhhbXBsZSBGaWxl"
  }
}

Risposta di esempio

Codice di stato:

200

{
  "detectedFace1": {
    "boundingBox": {
      "left": 33,
      "top": 73,
      "width": 262,
      "height": 324
    }
  },
  "detectedFace2": {
    "boundingBox": {
      "left": 87,
      "top": 96,
      "width": 235,
      "height": 345
    }
  },
  "confidence": 0.95
}

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API Microsoft One , https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
BoundingBox	Riquadro di delimitazione in un'immagine.
CompareFacesParameters	Confronta i parametri delle facce.
CompareFacesResult	Confronta la risposta dei volti.
DetectedBoundingBox	Rilevato riquadro di delimitazione di un oggetto.
FaceSource	Origine faccia di input con un riquadro di delimitazione di destinazione opzionale. Se non specificato, verrà utilizzata la faccia più grande.

Azure.Core.Foundations.Error

Object

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Object

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Object

Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API Microsoft One , https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

BoundingBox

Object

Riquadro di delimitazione in un'immagine.

Nome	Tipo	Descrizione
height	integer (int32)	Altezza del riquadro di delimitazione.
left	integer (int32)	Coordinata sinistra del riquadro di delimitazione.
top	integer (int32)	Coordinata superiore del riquadro di delimitazione.
width	integer (int32)	Larghezza del riquadro di delimitazione.

CompareFacesParameters

Object

Confronta i parametri delle facce.

Nome	Tipo	Descrizione
faceSource1	FaceSource	Prima faccia da confrontare.
faceSource2	FaceSource	Seconda faccia da confrontare.

CompareFacesResult

Object

Confronta la risposta dei volti.

Nome	Tipo	Descrizione
confidence	number (float)	Punteggio di affidabilità del confronto del volto.
detectedFace1	DetectedBoundingBox	Dettagli del primo volto rilevato.
detectedFace2	DetectedBoundingBox	Dettagli del secondo volto rilevato.

DetectedBoundingBox

Object

Rilevato riquadro di delimitazione di un oggetto.

Nome	Tipo	Descrizione
boundingBox	BoundingBox	Riquadro di delimitazione del viso rilevato.

FaceSource

Object

Origine faccia di input con un riquadro di delimitazione di destinazione opzionale. Se non specificato, verrà utilizzata la faccia più grande.

Nome	Tipo	Descrizione
data	string (byte)	Dati dell'immagine con codifica Base64. È necessario specificare solo uno degli URL o dei dati.
imageReferenceId	string	Identificatore fornito dall'utente per l'immagine di origine.
targetBoundingBox	BoundingBox	Riquadro di delimitazione che specifica la regione di interesse.
url	string (uri)	URL immagine. È necessario specificare solo uno degli URL o dei dati.