Face Recognition Operations - Find Similar
Wenn Sie die faceId des Abfragegesichts angeben, um die ähnlich aussehenden Gesichter aus einem faceId-Array zu durchsuchen. Ein faceId-Array enthält die von Detect erstellten Gesichter.
Abhängig von der Eingabe enthält die zurückgegebene Liste ähnlicher Gesichter faceIds oder persistedFaceIds, die nach Ähnlichkeit sortiert sind.
Find similar hat zwei Arbeitsmodi, "matchPerson" und "matchFace". "matchPerson" ist der Standardmodus, in dem versucht wird, Gesichter derselben Person so wie möglich zu finden, indem interne Schwellenwerte für dieselbe Person verwendet werden. Es ist nützlich, andere Fotos einer bekannten Person zu finden. Beachten Sie, dass eine leere Liste zurückgegeben wird, wenn keine Gesichter die internen Schwellenwerte überschreiten. Der "matchFace"-Modus ignoriert Schwellenwerte für dieselbe Person und gibt trotzdem ähnliche Gesichter zurück, auch wenn die Ähnlichkeit gering ist. Es kann in den Fällen verwendet werden, wie z. B. die Suche nach prominenten Gesichtern.
Das "recognitionModel", das der Abfrage-FaceId zugeordnet ist, sollte mit dem "recognitionModel" identisch sein, das vom Ziel-FaceId-Array verwendet wird.
POST {endpoint}/face/{apiVersion}/findsimilars
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
api
|
path | True |
string |
API-Version |
endpoint
|
path | True |
string uri |
Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com). |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
faceId | True |
string |
faceId des Abfragegesichts. Der Benutzer muss zuerst "Detect" aufrufen, um eine gültige FaceId zu erhalten. Beachten Sie, dass diese faceId nicht beibehalten wird und 24 Stunden nach dem Erkennungsaufruf abläuft. |
faceIds | True |
string[] |
Ein Array von Kandidaten-FaceIds. Alle werden von "Detect" erstellt, und die faceIds laufen 24 Stunden nach dem Erkennungsaufruf ab. Die Anzahl der FaceIds ist auf 1000 begrenzt. |
maxNumOfCandidatesReturned |
integer |
Die Anzahl der zurückgegebenen oberen ähnlichen Gesichter. Der gültige Bereich ist [1, 1000]. Der Standardwert ist 20. |
|
mode |
Find |
Ähnlicher Gesichtssuchemodus. Es kann "matchPerson" oder "matchFace" sein. Der Standardwert ist "matchPerson". |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Bei einem erfolgreichen Aufruf wird ein Array mit den ähnlichsten Gesichtern zurückgegeben, die in faceId dargestellt werden, wenn der Eingabeparameter faceIds oder persistedFaceId ist, wenn der Eingabeparameter faceListId oder largeFaceListId ist. |
|
Other Status Codes |
Eine unerwartete Fehlerantwort. Headers x-ms-error-code: string |
Sicherheit
Ocp-Apim-Subscription-Key
Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.
Type:
apiKey
In:
header
AADToken
Der Azure Active Directory OAuth2-Flow
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Name | Beschreibung |
---|---|
https://cognitiveservices.azure.com/.default |
Beispiele
Find Similar among Face IDs
Sample Request
POST {endpoint}/face/v1.1-preview.1/findsimilars
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"maxNumOfCandidatesReturned": 3,
"mode": "matchPerson",
"faceIds": [
"015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
"be386ab3-af91-4104-9e6d-4dae4c9fddb7"
]
}
Sample Response
[
{
"confidence": 0.9,
"persistedFaceId": "015839fb-fbd9-4f79-ace9-7675fc2f1dd9"
}
]
Definitionen
Name | Beschreibung |
---|---|
Face |
Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages. |
Face |
Eine Antwort, die Fehlerdetails enthält. |
Find |
Antworttext für die Suche nach ähnlichen Gesichtsoperationen. |
FaceError
Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Einer der vom Server definierten Fehlercodes. |
message |
string |
Eine für Menschen lesbare Darstellung des Fehlers. |
FaceErrorResponse
Eine Antwort, die Fehlerdetails enthält.
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
FindSimilarResult
Antworttext für die Suche nach ähnlichen Gesichtsoperationen.
Name | Typ | Beschreibung |
---|---|---|
confidence |
number |
Vertrauenswert des Kandidaten. Je höher die Zuverlässigkeit, desto ähnlicher. Bereich zwischen [0,1]. |
faceId |
string |
faceId des Kandidatengesichts, wenn von faceIds gefunden wird. faceId wird von "Detect" erstellt und läuft 24 Stunden nach dem Erkennungsaufruf ab. |
persistedFaceId |
string |
persistedFaceId des Kandidatengesichts, wenn es durch faceListId oder largeFaceListId gefunden wird. persistedFaceId in Gesichtsliste/große Gesichtsliste wird beibehalten und läuft nicht ab. |