Face Recognition Operations - Identify From Person Directory

  • Riferimento
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

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.