Face Recognition Operations - Find Similar

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Dato faceId del viso della query, per cercare i visi simili da una matrice faceId. Una matrice faceId contiene i visi creati da Detect.
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à.

L'elemento 'recognitionModel' associato al faceId della query deve essere uguale a quello usato dalla matrice faceId 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.
faceIds	True	string[]	Matrice di faceId candidati. Tutti vengono creati da "Detect" e i faceId scadranno 24 ore dopo la chiamata di rilevamento. Il numero di faceId è limitato a 1000.
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 among Face IDs

Esempio di richiesta

HTTP

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

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "maxNumOfCandidatesReturned": 3,
  "mode": "matchPerson",
  "faceIds": [
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7"
  ]
}

Risposta di esempio

Codice di stato:

200

[
  {
    "confidence": 0.9,
    "persistedFaceId": "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à.