Face Recognition Operations - Find Similar From Face List

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Dato faceId del viso di query, per cercare i visi simili da un elenco di volti. Un 'faceListId' viene creato da Create Face List.A 'faceListId' is created by Create Face List.
A seconda dell'input, l'elenco di visi simili restituiti contiene faceId o persistedFaceId classificati in base alla somiglianza.

Trova simile ha due modalità di lavoro, "matchPerson" e "matchFace". "matchPerson" è la modalità predefinita che tenta di trovare visi della stessa persona possibile usando soglie interne della stessa persona. È utile trovare le altre foto di una persona nota. Si noti che verrà restituito un elenco vuoto se nessun viso supera le soglie interne. La modalità "matchFace" ignora le soglie della stessa persona e restituisce comunque visi simili classificati, anche la somiglianza è bassa. Può essere usato nei casi come la ricerca di volti celebrità.

Il 'recognitionModel' associato alla query faceId deve essere uguale a quello usato dall'elenco viso di destinazione.

POST {endpoint}/face/{apiVersion}/findsimilars

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	faceId del viso della query. L'utente deve prima chiamare "Detect" per ottenere un faceId valido. Si noti che questo faceId non è persistente e scadrà 24 ore dopo la chiamata di rilevamento.
faceListId	True	string	Un elenco di visi univoco specificato dall'utente esistente, creato in "Create Face List". Face List contiene un set di persistedFaceId che sono persistenti e non scadranno mai.
maxNumOfCandidatesReturned		integer	Numero di facce simili superiori restituite. L'intervallo valido è [1, 1000]. Il valore predefinito è 20.
mode		FindSimilarMatchMode	Modalità di ricerca del viso simile. Può essere 'matchPerson' o 'matchFace'. Il valore predefinito è 'matchPerson'.

Risposte

Nome	Tipo	Descrizione
200 OK	FindSimilarResult[]	Una chiamata riuscita restituisce una matrice dei visi più simili rappresentati in faceId se il parametro di input è faceIds o persistedFaceId se il parametro di input è faceListId o largeFaceListId.
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

Find Similar from FaceList

Esempio di richiesta

HTTP

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

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "maxNumOfCandidatesReturned": 3,
  "mode": "matchPerson",
  "faceListId": "your_face_list_id"
}

Risposta di esempio

Codice di stato:

200

[
  {
    "confidence": 0.8,
    "faceId": "015839fb-fbd9-4f79-ace9-7675fc2f1dd9"
  }
]

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.
FindSimilarResult	Corpo della risposta per trovare un'operazione del viso simile.

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.

FindSimilarResult

Corpo della risposta per trovare un'operazione del viso simile.

Nome	Tipo	Descrizione
confidence	number	Valore di attendibilità del candidato. Maggiore è la fiducia, più simile. Intervallo compreso tra [0,1].
faceId	string	faceId del viso candidato quando viene trovato in base a faceId. faceId viene creato da "Detect" e scadrà 24 ore dopo la chiamata di rilevamento.
persistedFaceId	string	persistedFaceId del viso candidato quando viene trovato da faceListId o largeFaceListId. persistedFaceId nell'elenco dei volti o nell'elenco dei volti di grandi dimensioni è persistente e non scadrà.