Face Recognition Operations - Verify From Person Group

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Verificare se un viso appartiene a una persona in un gruppo di persone.

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 al viso della query deve essere uguale a "recognitionModel" usato dal gruppo person.

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
faceId	True	string	Il faceId del viso proviene da "Detect".
personGroupId	True	string	Uso di personGroupId e personId esistenti per il caricamento rapido di una persona specificata. personGroupId viene creato in "Create Person Group".
personId	True	string	Specificare una determinata persona nel gruppo di persone.

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 from PersonGroup

Esempio di richiesta

HTTP

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

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "personId": "815df99c-598f-4926-930a-a734b3fd651c",
  "personGroupId": "your_person_group"
}

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.