Face Recognition Operations - Verify Face To Face

  • Riferimento
Servizio:
Azure AI Services
Versione API:
v1.2-preview.1

Verificare se due visi appartengono a una stessa persona.

Nota

    • Qualità dell'immagine del viso più elevata significa una migliore precisione di identificazione. Si prega di considerare i visi di alta qualità: le dimensioni frontali, chiare e del viso sono di 200x200 pixel (100 pixel tra gli occhi) o più grandi.
    • Per gli scenari sensibili all'accuratezza, è consigliabile prendere il proprio giudizio.
    • Il 'recognitionModel' associato a entrambi i visi deve essere lo stesso.
POST {endpoint}/face/{apiVersion}/verify

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

Corpo della richiesta

Nome Necessario Tipo Descrizione
faceId1 True

string

Il faceId di un viso, proviene da "Detect".
faceId2 True

string

Il faceId di un altro viso, proviene da "Detect".

Risposte

Nome Tipo Descrizione
200 OK

VerificationResult

Una chiamata con esito positivo restituisce il risultato della verifica.
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

Verify Face to Face

Esempio di richiesta

POST {endpoint}/face/v1.2-preview.1/verify

{
  "faceId1": "c5c24a82-6845-4031-9d5d-978df9175426",
  "faceId2": "3aa87e30-b380-48eb-ad9e-1aa54fc52bd3"
}

Risposta di esempio

Codice di stato:
200 
{
  "isIdentical": true,
  "confidence": 0.8
}

Definizioni

Nome Descrizione
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.
VerificationResult

Verificare il risultato.

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.

VerificationResult

Verificare il risultato.

Nome Tipo Descrizione
confidence

number

Un numero indica la probabilità di somiglianza di due volti appartenenti alla stessa persona o se il viso appartiene alla persona. Per impostazione predefinita, isIdentical è impostato su True se la probabilità di somiglianza è maggiore o uguale a 0,5. Ciò è utile per gli utenti avanzati per eseguire l'override di "isIdentical" e ottimizzare il risultato sui propri dati.
isIdentical

boolean

True se le due facce appartengono alla stessa persona o al viso appartengono alla persona; in caso contrario, false.