Face Recognition Operations - Identify From Person Group

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

Identificazione da 1 a molti per trovare le corrispondenze più vicine del viso specifico della persona di query da un gruppo di persone.
Per ogni viso nella matrice faceIds, Face Identify calcola le analogie tra il viso della query e tutti i visi nel gruppo person (dato da personGroupId) e restituisce le persone candidate per il viso classificato in base alla confidenza di somiglianza. Il gruppo di persone deve essere sottoposto a training per prepararlo per l'identificazione. Per altre informazioni, vedere "Train Person Group".

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.
    • Provare "Trova simile" quando è necessario trovare visi simili da un elenco di visi o da un elenco di visi di grandi dimensioni anziché da un gruppo di persone.
    • I faceId "recognitionModel" associati ai visi della query devono essere uguali a "recognitionModel" usati dal gruppo di persone di destinazione.
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].
personGroupId True

string

personGroupId del gruppo di persone di destinazione, creato da "Crea gruppo di persone". Il parametro personGroupId e largePersonGroupId non deve essere fornito contemporaneamente.
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 PersonGroup

Esempio di richiesta

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personGroupId": "your_person_group_id",
  "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.