Face Recognition Operations - Identify From Person Directory

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Identificazione da 1 a molti per trovare le corrispondenze più vicine del viso della persona di query specifica da una matrice person personids della directory.
Per ogni viso nella matrice faceIds, Face Identify calcola le analogie tra il viso della query e tutti i visi nella directory person (data dagli personIds) e restituisce le persone candidate per il viso classificato in base alla confidenza di somiglianza. Il passaggio di personId con una matrice con un elemento "*" può eseguire l'operazione sull'intera directory delle persone.

Nota

• • L'algoritmo consente di identificare in modo indipendente più di un viso alla stessa richiesta, ma non più di 10 visi.
  • Ogni persona potrebbe avere più di un viso, ma non più di 248 visi.
  • 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.
  • Il numero di candidati restituiti è limitato da maxNumOfCandidatesReturned e confidenceThreshold. Se non viene identificata alcuna persona, i candidati restituiti saranno una matrice vuota.
  • L'operazione Di identificazione può corrispondere solo ai visi ottenuti con lo stesso modello di riconoscimento, associato ai visi della query.

POST {endpoint}/face/{apiVersion}/identify

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
faceIds	True	string[]	Matrice di visi di query faceId creati da "Detect". Ognuno dei visi viene identificato in modo indipendente. Il numero valido di faceId è compreso tra [1, 10].
personIds	True	string[]	Matrice di personId creati nella directory person "Create Person". Il numero valido di personId è compreso tra [1,30].
confidenceThreshold		number	Soglia di attendibilità dell'identificazione personalizzata, nell'intervallo di [0, 1]. L'utente avanzato può modificare questo valore per ignorare la soglia interna predefinita per una maggiore precisione sui dati dello scenario. Si noti che non esiste alcuna garanzia di questo valore soglia che funziona su altri dati e dopo l'aggiornamento dell'algoritmo.
maxNumOfCandidatesReturned		integer	L'intervallo di maxNumOfCandidatesReturned è compreso tra 1 e 100. Il valore predefinito è 10.

Risposte

Nome	Tipo	Descrizione
200 OK	IdentificationResult[]	Una chiamata con esito positivo restituisce le persone candidate identificate per ogni viso di query.
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

Identify from PersonDirectory

Esempio di richiesta

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personIds": [
    "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5"
  ],
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Risposta di esempio

Codice di stato:

200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "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.
IdentificationCandidate	Candidato per identificare la chiamata.
IdentificationResult	Identificare 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.

IdentificationCandidate

Candidato per identificare la chiamata.

Nome	Tipo	Descrizione
confidence	number	Valore di attendibilità del candidato. Maggiore è la fiducia, più simile. Intervallo compreso tra [0,1].
personId	string	personId della persona candidata.

IdentificationResult

Identificare il risultato.

Nome	Tipo	Descrizione
candidates	IdentificationCandidate[]	Persone identificate candidate per il viso (classificate in base alla confidenza). Le dimensioni della matrice non devono essere maggiori dell'input maxNumOfCandidatesReturned. Se non viene identificata alcuna persona, restituirà una matrice vuota.
faceId	string	faceId del viso della query.