Face Recognition Operations - Identify From Large Person Group

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Identificazione da 1 a molti per trovare le corrispondenze più vicine della persona di query specifica da un gruppo di persone di grandi dimensioni.
Per ogni viso nella matrice faceIds, Face Identify calcola le analogie tra il viso della query e tutti i visi nel gruppo di persone large (dato da largePersonGroupId) e restituirà le persone candidate per il viso classificato in base alla confidenza di somiglianza. Il gruppo di persone di grandi dimensioni deve essere sottoposto a training per prepararlo per l'identificazione. Per altre informazioni, vedere "Train Large 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/un gruppo di persone di grandi dimensioni.
  • I faceId "recognitionModel" associati ai visi della query devono essere uguali a "recognitionModel" usati dal gruppo di persone di destinazione o dal gruppo di persone di grandi dimensioni.

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].
largePersonGroupId	True	string	largePersonGroupId del gruppo large person di destinazione, creato da "Create Large Person Group". 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 LargePersonGroup

Esempio di richiesta

HTTP

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

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