Face class

Paket:: @azure/cognitiveservices-face

Klasse, die ein Gesicht darstellt.

Konstruktoren

Erstellen Sie ein Gesicht.

Methoden

detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams)	Erkennen von menschlichen Gesichtern in einem Bild, Zurückgeben von Gesichtsrechtecken und optional mit FaceIds, Landmarks und Attributen. Es wird kein Bild gespeichert. Nur das extrahierte Gesichtsfeature wird auf dem Server gespeichert. Die FaceId ist ein Bezeichner des Gesichtsfeatures und wird in Gesicht - Identifizieren, Gesicht - Überprüfenund Gesicht - Suchen ähnlichenverwendet. Die gespeicherten Gesichtsfeatures laufen ab und werden nach dem ursprünglichen Erkennungsaufruf nach faceIdTimeToLive gelöscht. Optionale Parameter umfassen faceId, Landmarks und Attribute. Zu den Attributen gehören Alter, Geschlecht, Kopfpose, Lächeln, Gesichtshair, Brille, Emotion, Haar, Make-up, Okklusion, Zubehör, Weichzeichner, Belichtung, Lärm, Masken und QualitätForRecognition. Einige der ergebnisse, die für bestimmte Attribute zurückgegeben werden, sind möglicherweise nicht sehr genau. JPEG, PNG, GIF (der erste Frame) und BMP-Format werden unterstützt. Die zulässige Bilddateigröße beträgt 1 KB bis 6 MB. Für ein Bild können bis zu 100 Gesichter zurückgegeben werden. Gesichter werden nach der Größe des Gesichtsrechtecks von groß bis klein bewertet. Optimale Ergebnisse beim Abfragen von Gesicht - Identifizieren von, Gesicht - Überprüfenund Gesicht - Suchen nach ähnlichen ('returnFaceId' ist wahr), verwenden Sie Gesichter, die: Frontal, klar und mit einer Mindestgröße von 200 x 200 Pixel (100 Pixel zwischen Augen) sind. Die minimale erkennbare Gesichtsgröße beträgt 36 x 36 Pixel in einem Bild, das nicht größer als 1920 x 1080 Pixel ist. Bilder mit Abmessungen, die größer als 1920 x 1080 Pixel sind, benötigen eine proportional größere Mindestgröße. Es können verschiedene "detectionModel"-Werte bereitgestellt werden. Informationen zum Verwenden und Vergleichen verschiedener Erkennungsmodelle finden Sie unter Angeben eines Erkennungsmodells Es werden verschiedene "recognitionModel"-Werte bereitgestellt. Wenn Nachverfolgungsvorgänge wie Verify, Identify, Find Similar erforderlich sind, geben Sie das Erkennungsmodell mit dem Parameter "recognitionModel" an. Der Standardwert für "recognitionModel" ist "recognition_01", falls das neueste Modell erforderlich ist, geben Sie bitte explizit das modell an, das Sie in diesem Parameter benötigen. Nach der Angabe werden die erkannten FaceIds dem angegebenen Erkennungsmodell zugeordnet. Weitere Details finden Sie unter Angeben eines Erkennungsmodells.
detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams, ServiceCallback<DetectedFace[]>)
detectWithStream(HttpRequestBody, ServiceCallback<DetectedFace[]>)
detectWithUrl(string, FaceDetectWithUrlOptionalParams)	Erkennen von menschlichen Gesichtern in einem Bild, Zurückgeben von Gesichtsrechtecken und optional mit FaceIds, Landmarks und Attributen. Es wird kein Bild gespeichert. Nur das extrahierte Gesichtsfeature wird auf dem Server gespeichert. Die FaceId ist ein Bezeichner des Gesichtsfeatures und wird in Gesicht - Identifizieren, Gesicht - Überprüfenund Gesicht - Suchen ähnlichenverwendet. Die gespeicherten Gesichtsfeatures laufen ab und werden nach dem ursprünglichen Erkennungsaufruf nach faceIdTimeToLive gelöscht. Optionale Parameter umfassen faceId, Landmarks und Attribute. Zu den Attributen gehören Alter, Geschlecht, Kopfpose, Lächeln, Gesichtshair, Brille, Emotion, Haar, Make-up, Okklusion, Zubehör, Weichzeichner, Belichtung, Lärm, Masken und QualitätForRecognition. Einige der ergebnisse, die für bestimmte Attribute zurückgegeben werden, sind möglicherweise nicht sehr genau. JPEG, PNG, GIF (der erste Frame) und BMP-Format werden unterstützt. Die zulässige Bilddateigröße beträgt 1 KB bis 6 MB. Für ein Bild können bis zu 100 Gesichter zurückgegeben werden. Gesichter werden nach der Größe des Gesichtsrechtecks von groß bis klein bewertet. Optimale Ergebnisse beim Abfragen von Gesicht - Identifizieren von, Gesicht - Überprüfenund Gesicht - Suchen nach ähnlichen ('returnFaceId' ist wahr), verwenden Sie Gesichter, die: Frontal, klar und mit einer Mindestgröße von 200 x 200 Pixel (100 Pixel zwischen Augen) sind. Die minimale erkennbare Gesichtsgröße beträgt 36 x 36 Pixel in einem Bild, das nicht größer als 1920 x 1080 Pixel ist. Bilder mit Abmessungen, die größer als 1920 x 1080 Pixel sind, benötigen eine proportional größere Mindestgröße. Es können verschiedene "detectionModel"-Werte bereitgestellt werden. Informationen zum Verwenden und Vergleichen verschiedener Erkennungsmodelle finden Sie unter Angeben eines Erkennungsmodells. Es werden verschiedene "recognitionModel"-Werte bereitgestellt. Wenn Nachverfolgungsvorgänge wie Verify, Identify, Find Similar erforderlich sind, geben Sie das Erkennungsmodell mit dem Parameter "recognitionModel" an. Der Standardwert für "recognitionModel" ist "recognition_01", falls das neueste Modell erforderlich ist, geben Sie bitte explizit das modell an, das Sie in diesem Parameter benötigen. Nach der Angabe werden die erkannten FaceIds dem angegebenen Erkennungsmodell zugeordnet. Weitere Details finden Sie unter Angeben eines Erkennungsmodells.
detectWithUrl(string, FaceDetectWithUrlOptionalParams, ServiceCallback<DetectedFace[]>)
detectWithUrl(string, ServiceCallback<DetectedFace[]>)
findSimilar(string, FaceFindSimilarOptionalParams)	Die FaceId einer Abfrageseite zum Durchsuchen der ähnlich aussehenden Gesichter aus einem FaceId-Array, einer Gesichtsliste oder einer großen Gesichtsliste. faceId-Array enthält die Gesichter, die von Face - Detect With URL oder Face - Detect With Streamerstellt werden, was nach der Erstellung durch faceIdTimeToLive abläuft. Eine "faceListId" wird von FaceList erstellt – Erstellen sie mit persistedFaceIds, die nicht ablaufen. Und eine "largeFaceListId" wird von LargeFaceList erstellt – Erstellen Sie mit persistedFaceIds, die ebenfalls nicht ablaufen. Je nach Eingabe enthält die zurückgegebene Liste ähnlicher Gesichter FaceIds oder persistedFaceIds, die nach Ähnlichkeit bewertet wurden. Die Suche ähnelt zwei Arbeitsmodi: "matchPerson" und "matchFace". "matchPerson" ist der Standardmodus, in dem versucht wird, Gesichter derselben Person wie möglich mithilfe interner Schwellenwerte für dieselbe Person zu finden. Es ist nützlich, die anderen Fotos einer bekannten Person zu finden. Beachten Sie, dass eine leere Liste zurückgegeben wird, wenn keine Gesichter die internen Schwellenwerte überschreiten. Der Modus "matchFace" ignoriert Schwellenwerte für die gleiche Person und gibt trotzdem gleichrangige Gesichter zurück, auch wenn die Ähnlichkeit niedrig ist. Es kann in den Fällen verwendet werden, wie die Suche nach prominenten Gesichtern. Das "recognitionModel", das der FaceId des Abfragegesichts zugeordnet ist, sollte mit dem "recognitionModel" übereinstimmen, das vom Target FaceId-Array, der Gesichtsliste oder der großen Gesichtsliste verwendet wird.
findSimilar(string, FaceFindSimilarOptionalParams, ServiceCallback<SimilarFace[]>)
findSimilar(string, ServiceCallback<SimilarFace[]>)
group(string[], RequestOptionsBase)	Dividieren Sie kandidatengesichtige Gesichter auf der Grundlage der Gesichtsähnlichkeit in Gruppen. Die Ausgabe ist eine oder mehrere nicht zusammenhängende Gesichtsgruppen und eine unübersichtlicher Gruppe. Eine Gesichtsgruppe enthält Gesichter, die ähnlich aussehen, oft der gleichen Person. Gesichtsgruppen werden nach Gruppengröße, d. h. anzahl der Gesichter, bewertet. Beachten Sie, dass Gesichter, die derselben Person angehören, möglicherweise in mehrere Gruppen im Ergebnis aufgeteilt werden. MessyGroup ist eine spezielle Gesichtsgruppe mit Gesichtern, die keine ähnliche Gegenseite von originalen Gesichtern finden können. Die messyGroup wird nicht im Ergebnis angezeigt, wenn alle Gesichter ihre Entsprechungen gefunden haben. Die Gruppen-API benötigt mindestens 2 Kandidatensichten und höchstens 1000. Wir empfehlen, Gesicht zu testen – Überprüfen Sie, wenn Sie nur 2 Kandidatensichten haben. Das "recognitionModel", das den FaceIds der Abfragegesichtsblätter zugeordnet ist, sollte identisch sein.
group(string[], RequestOptionsBase, ServiceCallback<GroupResult>)
group(string[], ServiceCallback<GroupResult>)
identify(string[], FaceIdentifyOptionalParams)	1:n-Identifikation, um die nächstgelegenen Übereinstimmungen der spezifischen Abfrageperson von einer Personengruppe oder einer großen Personengruppe zu finden. Für jedes Gesicht im FaceIds-Array berechnet Face Identify Ähnlichkeiten zwischen dem Abfragegesicht und allen Gesichtern in der Personengruppe (gegeben von personGroupId) oder einer großen Personengruppe (gegeben durch largePersonGroupId) und gibt Kandidatenperson(en) für dieses Gesicht zurück, die nach Ähnlichkeitsvertrauen bewertet wurden. Die Personengruppe/große Personengruppe sollte geschult werden, um sie zur Identifizierung vorzubereiten. Weitere Informationen finden Sie in PersonGroup - Train and LargePersonGroup - Train. Bemerkungen: Der Algorithmus ermöglicht es mehreren Gesichtern, unabhängig von derselben Anforderung zu identifizieren, aber nicht mehr als 10 Gesichter. Jede Person in der Personengruppe/großen Personengruppe könnte mehr als ein Gesicht haben, aber nicht mehr als 248 Gesichter. Eine höhere Gesichtsbildqualität bedeutet eine bessere Identifikationsgenauigkeit. Berücksichtigen Sie qualitativ hochwertige Gesichter: Frontal-, Klar- und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen Augen) oder größer. Die Anzahl der zurückgegebenen Kandidaten wird durch maxNumOfCandidatesReturned und confidenceThreshold eingeschränkt. Wenn keine Person identifiziert wird, sind die zurückgegebenen Kandidaten ein leeres Array. Probieren Sie Gesicht – Suchen Sie ähnliche, wenn Sie ähnliche Gesichter aus einer Gesichtsliste/einer großen Gesichtsliste anstelle einer Personengruppe/einer großen Personengruppe finden müssen. Das "recognitionModel", das den FaceIds der Abfragegesichtsblätter zugeordnet ist, sollte mit dem "recognitionModel" übereinstimmen, das von der Zielgruppe oder großen Personengruppe verwendet wird.
identify(string[], FaceIdentifyOptionalParams, ServiceCallback<IdentifyResult[]>)
identify(string[], ServiceCallback<IdentifyResult[]>)
verifyFaceToFace(string, string, RequestOptionsBase)	Überprüfen Sie, ob zwei Gesichter einer Person angehören oder ob ein Gesicht zu einer Person gehört. Bemerkungen: Eine höhere Gesichtsbildqualität bedeutet eine bessere Identifikationsgenauigkeit. Berücksichtigen Sie qualitativ hochwertige Gesichter: Frontal-, Klar- und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen Augen) oder größer. Für die Szenarien, die für die Genauigkeit sensibel sind, legen Sie bitte Ihr eigenes Urteil fest. Das "recognitionModel", das den FaceIds der Abfragegesichtsblätter zugeordnet ist, sollte mit dem "recognitionModel" übereinstimmen, das vom Ziel-, Personengruppen- oder großen Personengruppen verwendet wird.
verifyFaceToFace(string, string, RequestOptionsBase, ServiceCallback<VerifyResult>)
verifyFaceToFace(string, string, ServiceCallback<VerifyResult>)
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams)	Überprüfen Sie, ob zwei Gesichter zu derselben Person gehören. Vergleicht eine Gesichts-ID mit einer Person-ID
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams, ServiceCallback<VerifyResult>)
verifyFaceToPerson(string, string, ServiceCallback<VerifyResult>)

Details zum Konstruktor

Face(FaceClientContext)

Erstellen Sie ein Gesicht.

new Face(client: FaceClientContext)

Parameter

client: FaceClientContext

Verweisen auf den Dienstclient.

Details zur Methode

detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams)

Erkennen von menschlichen Gesichtern in einem Bild, Zurückgeben von Gesichtsrechtecken und optional mit FaceIds, Landmarks und Attributen.

Es wird kein Bild gespeichert. Nur das extrahierte Gesichtsfeature wird auf dem Server gespeichert. Die FaceId ist ein Bezeichner des Gesichtsfeatures und wird in Gesicht - Identifizieren, Gesicht - Überprüfenund Gesicht - Suchen ähnlichenverwendet. Die gespeicherten Gesichtsfeatures laufen ab und werden nach dem ursprünglichen Erkennungsaufruf nach faceIdTimeToLive gelöscht.
Optionale Parameter umfassen faceId, Landmarks und Attribute. Zu den Attributen gehören Alter, Geschlecht, Kopfpose, Lächeln, Gesichtshair, Brille, Emotion, Haar, Make-up, Okklusion, Zubehör, Weichzeichner, Belichtung, Lärm, Masken und QualitätForRecognition. Einige der ergebnisse, die für bestimmte Attribute zurückgegeben werden, sind möglicherweise nicht sehr genau.
JPEG, PNG, GIF (der erste Frame) und BMP-Format werden unterstützt. Die zulässige Bilddateigröße beträgt 1 KB bis 6 MB.
Für ein Bild können bis zu 100 Gesichter zurückgegeben werden. Gesichter werden nach der Größe des Gesichtsrechtecks von groß bis klein bewertet.
Optimale Ergebnisse beim Abfragen von Gesicht - Identifizieren von, Gesicht - Überprüfenund Gesicht - Suchen nach ähnlichen ('returnFaceId' ist wahr), verwenden Sie Gesichter, die: Frontal, klar und mit einer Mindestgröße von 200 x 200 Pixel (100 Pixel zwischen Augen) sind.
Die minimale erkennbare Gesichtsgröße beträgt 36 x 36 Pixel in einem Bild, das nicht größer als 1920 x 1080 Pixel ist. Bilder mit Abmessungen, die größer als 1920 x 1080 Pixel sind, benötigen eine proportional größere Mindestgröße.
Es können verschiedene "detectionModel"-Werte bereitgestellt werden. Informationen zum Verwenden und Vergleichen verschiedener Erkennungsmodelle finden Sie unter Angeben eines Erkennungsmodells
Es werden verschiedene "recognitionModel"-Werte bereitgestellt. Wenn Nachverfolgungsvorgänge wie Verify, Identify, Find Similar erforderlich sind, geben Sie das Erkennungsmodell mit dem Parameter "recognitionModel" an. Der Standardwert für "recognitionModel" ist "recognition_01", falls das neueste Modell erforderlich ist, geben Sie bitte explizit das modell an, das Sie in diesem Parameter benötigen. Nach der Angabe werden die erkannten FaceIds dem angegebenen Erkennungsmodell zugeordnet. Weitere Details finden Sie unter Angeben eines Erkennungsmodells.

function detectWithStream(image: HttpRequestBody, options?: FaceDetectWithStreamOptionalParams): Promise<FaceDetectWithStreamResponse>

Parameter

image: HttpRequestBody

Ein Bildstream.

options: FaceDetectWithStreamOptionalParams

Die optionalen Parameter

Gibt zurück

Promise<FaceDetectWithStreamResponse>

Promise<Models.FaceDetectWithStreamResponse>

detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams, ServiceCallback<DetectedFace[]>)

function detectWithStream(image: HttpRequestBody, options: FaceDetectWithStreamOptionalParams, callback: ServiceCallback<DetectedFace[]>)

Parameter

image: HttpRequestBody

Ein Bildstream.

options: FaceDetectWithStreamOptionalParams

Die optionalen Parameter

callback: ServiceCallback<DetectedFace[]>

Der Rückruf

detectWithStream(HttpRequestBody, ServiceCallback<DetectedFace[]>)

function detectWithStream(image: HttpRequestBody, callback: ServiceCallback<DetectedFace[]>)

Parameter

image: HttpRequestBody

Ein Bildstream.

callback: ServiceCallback<DetectedFace[]>

Der Rückruf

detectWithUrl(string, FaceDetectWithUrlOptionalParams)

Erkennen von menschlichen Gesichtern in einem Bild, Zurückgeben von Gesichtsrechtecken und optional mit FaceIds, Landmarks und Attributen.

Es wird kein Bild gespeichert. Nur das extrahierte Gesichtsfeature wird auf dem Server gespeichert. Die FaceId ist ein Bezeichner des Gesichtsfeatures und wird in Gesicht - Identifizieren, Gesicht - Überprüfenund Gesicht - Suchen ähnlichenverwendet. Die gespeicherten Gesichtsfeatures laufen ab und werden nach dem ursprünglichen Erkennungsaufruf nach faceIdTimeToLive gelöscht.
Optionale Parameter umfassen faceId, Landmarks und Attribute. Zu den Attributen gehören Alter, Geschlecht, Kopfpose, Lächeln, Gesichtshair, Brille, Emotion, Haar, Make-up, Okklusion, Zubehör, Weichzeichner, Belichtung, Lärm, Masken und QualitätForRecognition. Einige der ergebnisse, die für bestimmte Attribute zurückgegeben werden, sind möglicherweise nicht sehr genau.
JPEG, PNG, GIF (der erste Frame) und BMP-Format werden unterstützt. Die zulässige Bilddateigröße beträgt 1 KB bis 6 MB.
Für ein Bild können bis zu 100 Gesichter zurückgegeben werden. Gesichter werden nach der Größe des Gesichtsrechtecks von groß bis klein bewertet.
Optimale Ergebnisse beim Abfragen von Gesicht - Identifizieren von, Gesicht - Überprüfenund Gesicht - Suchen nach ähnlichen ('returnFaceId' ist wahr), verwenden Sie Gesichter, die: Frontal, klar und mit einer Mindestgröße von 200 x 200 Pixel (100 Pixel zwischen Augen) sind.
Die minimale erkennbare Gesichtsgröße beträgt 36 x 36 Pixel in einem Bild, das nicht größer als 1920 x 1080 Pixel ist. Bilder mit Abmessungen, die größer als 1920 x 1080 Pixel sind, benötigen eine proportional größere Mindestgröße.
Es können verschiedene "detectionModel"-Werte bereitgestellt werden. Informationen zum Verwenden und Vergleichen verschiedener Erkennungsmodelle finden Sie unter Angeben eines Erkennungsmodells.
Es werden verschiedene "recognitionModel"-Werte bereitgestellt. Wenn Nachverfolgungsvorgänge wie Verify, Identify, Find Similar erforderlich sind, geben Sie das Erkennungsmodell mit dem Parameter "recognitionModel" an. Der Standardwert für "recognitionModel" ist "recognition_01", falls das neueste Modell erforderlich ist, geben Sie bitte explizit das modell an, das Sie in diesem Parameter benötigen. Nach der Angabe werden die erkannten FaceIds dem angegebenen Erkennungsmodell zugeordnet. Weitere Details finden Sie unter Angeben eines Erkennungsmodells.

function detectWithUrl(url: string, options?: FaceDetectWithUrlOptionalParams): Promise<FaceDetectWithUrlResponse>

Parameter

url: string

Öffentlich erreichbare URL eines Bilds

options: FaceDetectWithUrlOptionalParams

Die optionalen Parameter

Gibt zurück

Promise<FaceDetectWithUrlResponse>

Promise<Models.FaceDetectWithUrlResponse>

detectWithUrl(string, FaceDetectWithUrlOptionalParams, ServiceCallback<DetectedFace[]>)

function detectWithUrl(url: string, options: FaceDetectWithUrlOptionalParams, callback: ServiceCallback<DetectedFace[]>)

Parameter

url: string

Öffentlich erreichbare URL eines Bilds

options: FaceDetectWithUrlOptionalParams

Die optionalen Parameter

callback: ServiceCallback<DetectedFace[]>

Der Rückruf

detectWithUrl(string, ServiceCallback<DetectedFace[]>)

function detectWithUrl(url: string, callback: ServiceCallback<DetectedFace[]>)

Parameter

url: string

Öffentlich erreichbare URL eines Bilds

callback: ServiceCallback<DetectedFace[]>

Der Rückruf

findSimilar(string, FaceFindSimilarOptionalParams)

Die FaceId einer Abfrageseite zum Durchsuchen der ähnlich aussehenden Gesichter aus einem FaceId-Array, einer Gesichtsliste oder einer großen Gesichtsliste. faceId-Array enthält die Gesichter, die von Face - Detect With URL oder Face - Detect With Streamerstellt werden, was nach der Erstellung durch faceIdTimeToLive abläuft. Eine "faceListId" wird von FaceList erstellt – Erstellen sie mit persistedFaceIds, die nicht ablaufen. Und eine "largeFaceListId" wird von LargeFaceList erstellt – Erstellen Sie mit persistedFaceIds, die ebenfalls nicht ablaufen. Je nach Eingabe enthält die zurückgegebene Liste ähnlicher Gesichter FaceIds oder persistedFaceIds, die nach Ähnlichkeit bewertet wurden.
Die Suche ähnelt zwei Arbeitsmodi: "matchPerson" und "matchFace". "matchPerson" ist der Standardmodus, in dem versucht wird, Gesichter derselben Person wie möglich mithilfe interner Schwellenwerte für dieselbe Person zu finden. Es ist nützlich, die anderen Fotos einer bekannten Person zu finden. Beachten Sie, dass eine leere Liste zurückgegeben wird, wenn keine Gesichter die internen Schwellenwerte überschreiten. Der Modus "matchFace" ignoriert Schwellenwerte für die gleiche Person und gibt trotzdem gleichrangige Gesichter zurück, auch wenn die Ähnlichkeit niedrig ist. Es kann in den Fällen verwendet werden, wie die Suche nach prominenten Gesichtern.
Das "recognitionModel", das der FaceId des Abfragegesichts zugeordnet ist, sollte mit dem "recognitionModel" übereinstimmen, das vom Target FaceId-Array, der Gesichtsliste oder der großen Gesichtsliste verwendet wird.

function findSimilar(faceId: string, options?: FaceFindSimilarOptionalParams): Promise<FaceFindSimilarResponse>

Parameter

faceId: string

FaceId des Abfragegesichts. Der Benutzer muss "Face" anrufen – Erkennen Sie zuerst, um eine gültige FaceId zu erhalten. Beachten Sie, dass diese faceId nicht beibehalten wird und zu dem zeitpunkt abläuft, der von faceIdTimeToLive nach dem Erkennungsaufruf angegeben wurde.

options: FaceFindSimilarOptionalParams

Die optionalen Parameter

Gibt zurück

Promise<FaceFindSimilarResponse>

Promise<Models.FaceFindSimilarResponse>

findSimilar(string, FaceFindSimilarOptionalParams, ServiceCallback<SimilarFace[]>)

function findSimilar(faceId: string, options: FaceFindSimilarOptionalParams, callback: ServiceCallback<SimilarFace[]>)

Parameter

faceId: string

options: FaceFindSimilarOptionalParams

Die optionalen Parameter

callback: ServiceCallback<SimilarFace[]>

Der Rückruf

findSimilar(string, ServiceCallback<SimilarFace[]>)

function findSimilar(faceId: string, callback: ServiceCallback<SimilarFace[]>)

Parameter

faceId: string

callback: ServiceCallback<SimilarFace[]>

Der Rückruf

group(string[], RequestOptionsBase)

Dividieren Sie kandidatengesichtige Gesichter auf der Grundlage der Gesichtsähnlichkeit in Gruppen.

Die Ausgabe ist eine oder mehrere nicht zusammenhängende Gesichtsgruppen und eine unübersichtlicher Gruppe. Eine Gesichtsgruppe enthält Gesichter, die ähnlich aussehen, oft der gleichen Person. Gesichtsgruppen werden nach Gruppengröße, d. h. anzahl der Gesichter, bewertet. Beachten Sie, dass Gesichter, die derselben Person angehören, möglicherweise in mehrere Gruppen im Ergebnis aufgeteilt werden.
MessyGroup ist eine spezielle Gesichtsgruppe mit Gesichtern, die keine ähnliche Gegenseite von originalen Gesichtern finden können. Die messyGroup wird nicht im Ergebnis angezeigt, wenn alle Gesichter ihre Entsprechungen gefunden haben.
Die Gruppen-API benötigt mindestens 2 Kandidatensichten und höchstens 1000. Wir empfehlen, Gesicht zu testen – Überprüfen Sie, wenn Sie nur 2 Kandidatensichten haben.
Das "recognitionModel", das den FaceIds der Abfragegesichtsblätter zugeordnet ist, sollte identisch sein.

function group(faceIds: string[], options?: RequestOptionsBase): Promise<FaceGroupResponse>

Parameter

faceIds: string[]

Array von Kandidaten faceId erstellt von Face - Detect. Maximal 1000 Gesichter

options: RequestOptionsBase

Die optionalen Parameter

Gibt zurück

Promise<FaceGroupResponse>

Zusage<Models.FaceGroupResponse>

group(string[], RequestOptionsBase, ServiceCallback<GroupResult>)

function group(faceIds: string[], options: RequestOptionsBase, callback: ServiceCallback<GroupResult>)

Parameter

faceIds: string[]

Array von Kandidaten faceId erstellt von Face - Detect. Maximal 1000 Gesichter

options: RequestOptionsBase

Die optionalen Parameter

callback: ServiceCallback<GroupResult>

Der Rückruf

group(string[], ServiceCallback<GroupResult>)

function group(faceIds: string[], callback: ServiceCallback<GroupResult>)

Parameter

faceIds: string[]

Array von Kandidaten faceId erstellt von Face - Detect. Maximal 1000 Gesichter

callback: ServiceCallback<GroupResult>

Der Rückruf

identify(string[], FaceIdentifyOptionalParams)

1:n-Identifikation, um die nächstgelegenen Übereinstimmungen der spezifischen Abfrageperson von einer Personengruppe oder einer großen Personengruppe zu finden.
Für jedes Gesicht im FaceIds-Array berechnet Face Identify Ähnlichkeiten zwischen dem Abfragegesicht und allen Gesichtern in der Personengruppe (gegeben von personGroupId) oder einer großen Personengruppe (gegeben durch largePersonGroupId) und gibt Kandidatenperson(en) für dieses Gesicht zurück, die nach Ähnlichkeitsvertrauen bewertet wurden. Die Personengruppe/große Personengruppe sollte geschult werden, um sie zur Identifizierung vorzubereiten. Weitere Informationen finden Sie in PersonGroup - Train and LargePersonGroup - Train.

Bemerkungen:

Der Algorithmus ermöglicht es mehreren Gesichtern, unabhängig von derselben Anforderung zu identifizieren, aber nicht mehr als 10 Gesichter.
Jede Person in der Personengruppe/großen Personengruppe könnte mehr als ein Gesicht haben, aber nicht mehr als 248 Gesichter.
Eine höhere Gesichtsbildqualität bedeutet eine bessere Identifikationsgenauigkeit. Berücksichtigen Sie qualitativ hochwertige Gesichter: Frontal-, Klar- und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen Augen) oder größer.
Die Anzahl der zurückgegebenen Kandidaten wird durch maxNumOfCandidatesReturned und confidenceThreshold eingeschränkt. Wenn keine Person identifiziert wird, sind die zurückgegebenen Kandidaten ein leeres Array.
Probieren Sie Gesicht – Suchen Sie ähnliche, wenn Sie ähnliche Gesichter aus einer Gesichtsliste/einer großen Gesichtsliste anstelle einer Personengruppe/einer großen Personengruppe finden müssen.
Das "recognitionModel", das den FaceIds der Abfragegesichtsblätter zugeordnet ist, sollte mit dem "recognitionModel" übereinstimmen, das von der Zielgruppe oder großen Personengruppe verwendet wird.

function identify(faceIds: string[], options?: FaceIdentifyOptionalParams): Promise<FaceIdentifyResponse>

Parameter

faceIds: string[]

Array von Abfragegesichts-FaceIds, erstellt vom Face - Detect. Jede der Gesichter wird unabhängig voneinander identifiziert. Die gültige Anzahl von FaceIds liegt zwischen [1, 10].

options: FaceIdentifyOptionalParams

Die optionalen Parameter

Gibt zurück

Promise<FaceIdentifyResponse>

Promise<Models.FaceIdentifyResponse>

identify(string[], FaceIdentifyOptionalParams, ServiceCallback<IdentifyResult[]>)

function identify(faceIds: string[], options: FaceIdentifyOptionalParams, callback: ServiceCallback<IdentifyResult[]>)

Parameter

faceIds: string[]

Array von Abfragegesichts-FaceIds, erstellt vom Face - Detect. Jede der Gesichter wird unabhängig voneinander identifiziert. Die gültige Anzahl von FaceIds liegt zwischen [1, 10].

options: FaceIdentifyOptionalParams

Die optionalen Parameter

callback: ServiceCallback<IdentifyResult[]>

Der Rückruf

identify(string[], ServiceCallback<IdentifyResult[]>)

function identify(faceIds: string[], callback: ServiceCallback<IdentifyResult[]>)

Parameter

faceIds: string[]

Array von Abfragegesichts-FaceIds, erstellt vom Face - Detect. Jede der Gesichter wird unabhängig voneinander identifiziert. Die gültige Anzahl von FaceIds liegt zwischen [1, 10].

callback: ServiceCallback<IdentifyResult[]>

Der Rückruf

verifyFaceToFace(string, string, RequestOptionsBase)

Überprüfen Sie, ob zwei Gesichter einer Person angehören oder ob ein Gesicht zu einer Person gehört.
Bemerkungen:

Eine höhere Gesichtsbildqualität bedeutet eine bessere Identifikationsgenauigkeit. Berücksichtigen Sie qualitativ hochwertige Gesichter: Frontal-, Klar- und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen Augen) oder größer.
Für die Szenarien, die für die Genauigkeit sensibel sind, legen Sie bitte Ihr eigenes Urteil fest.
Das "recognitionModel", das den FaceIds der Abfragegesichtsblätter zugeordnet ist, sollte mit dem "recognitionModel" übereinstimmen, das vom Ziel-, Personengruppen- oder großen Personengruppen verwendet wird.

function verifyFaceToFace(faceId1: string, faceId2: string, options?: RequestOptionsBase): Promise<FaceVerifyFaceToFaceResponse>

Parameter

faceId1: string

FaceId des ersten Gesichtes, kommt von Face - Detect

faceId2: string

FaceId des zweiten Gesichts, kommt von Face - Detect

options: RequestOptionsBase

Die optionalen Parameter

Gibt zurück

Promise<FaceVerifyFaceToFaceResponse>

Promise<Models.FaceVerifyFaceToFaceResponse>

verifyFaceToFace(string, string, RequestOptionsBase, ServiceCallback<VerifyResult>)

function verifyFaceToFace(faceId1: string, faceId2: string, options: RequestOptionsBase, callback: ServiceCallback<VerifyResult>)

Parameter

faceId1: string

FaceId des ersten Gesichtes, kommt von Face - Detect

faceId2: string

FaceId des zweiten Gesichts, kommt von Face - Detect

options: RequestOptionsBase

Die optionalen Parameter

callback: ServiceCallback<VerifyResult>

Der Rückruf

verifyFaceToFace(string, string, ServiceCallback<VerifyResult>)

function verifyFaceToFace(faceId1: string, faceId2: string, callback: ServiceCallback<VerifyResult>)

Parameter

faceId1: string

FaceId des ersten Gesichtes, kommt von Face - Detect

faceId2: string

FaceId des zweiten Gesichts, kommt von Face - Detect

callback: ServiceCallback<VerifyResult>

Der Rückruf

verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams)

Überprüfen Sie, ob zwei Gesichter zu derselben Person gehören. Vergleicht eine Gesichts-ID mit einer Person-ID

function verifyFaceToPerson(faceId: string, personId: string, options?: FaceVerifyFaceToPersonOptionalParams): Promise<FaceVerifyFaceToPersonResponse>

Parameter

faceId: string

FaceId des Gesichtes, kommt von Face - Detect

personId: string

Geben Sie eine bestimmte Person in einer Personengruppe oder einer großen Personengruppe an. personId wird in PersonGroup Person - Create or LargePersonGroup Person - Create - Create.

options: FaceVerifyFaceToPersonOptionalParams

Die optionalen Parameter

Gibt zurück

Promise<FaceVerifyFaceToPersonResponse>

Promise<Models.FaceVerifyFaceToPersonResponse>

verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams, ServiceCallback<VerifyResult>)

function verifyFaceToPerson(faceId: string, personId: string, options: FaceVerifyFaceToPersonOptionalParams, callback: ServiceCallback<VerifyResult>)

Parameter

faceId: string

FaceId des Gesichtes, kommt von Face - Detect

personId: string

Geben Sie eine bestimmte Person in einer Personengruppe oder einer großen Personengruppe an. personId wird in PersonGroup Person - Create or LargePersonGroup Person - Create - Create.

options: FaceVerifyFaceToPersonOptionalParams

Die optionalen Parameter

callback: ServiceCallback<VerifyResult>

Der Rückruf

verifyFaceToPerson(string, string, ServiceCallback<VerifyResult>)

function verifyFaceToPerson(faceId: string, personId: string, callback: ServiceCallback<VerifyResult>)

Parameter

faceId: string

FaceId des Gesichtes, kommt von Face - Detect

personId: string

Geben Sie eine bestimmte Person in einer Personengruppe oder einer großen Personengruppe an. personId wird in PersonGroup Person - Create or LargePersonGroup Person - Create - Create.

callback: ServiceCallback<VerifyResult>

Der Rückruf