Face class
Klasse die een gezicht vertegenwoordigt.
Constructors
| Face(Face |
Een gezicht maken. |
Methoden
| detect |
Detecteer menselijke gezichten in een afbeelding, retourneer gezichtsrechthoeken en eventueel met faceIds, oriëntatiepunten en kenmerken.
|
| detect |
|
| detect |
|
| detect |
Detecteer menselijke gezichten in een afbeelding, retourneer gezichtsrechthoeken en eventueel met faceIds, oriëntatiepunten en kenmerken.
|
| detect |
|
| detect |
|
| find |
Gezien de faceId van het querygezicht, kunt u zoeken in vergelijkbare gezichten uit een faceId-matrix, een gezichtslijst of een grote gezichtslijst. faceId-matrix bevat de gezichten die zijn gemaakt door Face - Detect With Url of Face - Detect With Stream, die verlopen op het moment dat is opgegeven door faceIdTimeToLive na het maken. Er wordt een 'faceListId' gemaakt door FaceList : maak met persistenteFaceIds die niet verlopen. En een 'largeFaceListId' wordt gemaakt door LargeFaceList - Maak met persistenteFaceIds die ook niet verlopen. Afhankelijk van de invoer bevat de geretourneerde lijst met vergelijkbare gezichten faceIds of persistentedFaceIds gerangschikt op gelijkenis.
|
| find |
|
| find |
|
| group(string[], Request |
Deel kandidaatgezichten in groepen op basis van gelijkenis met gezichten.
|
| group(string[], Request |
|
| group(string[], Service |
|
| identify(string[], Face |
1-op-veel identificatie om de dichtstbijzijnde overeenkomsten te vinden van de specifieke query persoon gezicht uit een persoonsgroep of grote persoonsgroep.
Opmerkingen:
|
| identify(string[], Face |
|
| identify(string[], Service |
|
| verify |
Controleer of twee gezichten tot dezelfde persoon behoren of of één gezicht tot een persoon behoort.
|
| verify |
|
| verify |
|
| verify |
Controleer of twee gezichten tot dezelfde persoon behoren. Vergelijkt een gezichts-id met een persoons-id |
| verify |
|
| verify |
Constructordetails
Face(FaceClientContext)
Een gezicht maken.
new Face(client: FaceClientContext)Parameters
- client
- FaceClientContext
Verwijzing naar de serviceclient.
Methodedetails
detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams)
Detecteer menselijke gezichten in een afbeelding, retourneer gezichtsrechthoeken en eventueel met faceIds, oriëntatiepunten en kenmerken.
- Er wordt geen installatiekopieën opgeslagen. Alleen de geëxtraheerde gezichtsfunctie wordt op de server opgeslagen. De faceId is een id van de gezichtsfunctie en wordt gebruikt in Face - Identificeer, Gezicht - Controleeren Gezicht - Vind vergelijkbare. De opgeslagen gezichtsfuncties verlopen en worden verwijderd op het moment dat is opgegeven door faceIdTimeToLive na de oorspronkelijke detectieaanroep.
- Optionele parameters omvatten faceId, oriëntatiepunten en kenmerken. Kenmerken zijn leeftijd, geslacht, headPose, glimlach, facialHair, bril, emotie, haar, make-up, occlusie, accessoires, vervagen, blootstelling, ruis, masker en kwaliteitForRecognition. Sommige resultaten die worden geretourneerd voor specifieke kenmerken, zijn mogelijk niet zeer nauwkeurig.
- JPEG-, PNG-, GIF-, GIF-indeling (het eerste frame) en BMP-indeling worden ondersteund. De toegestane grootte van het afbeeldingsbestand is van 1 KB tot 6 MB.
- Er kunnen maximaal 100 gezichten worden geretourneerd voor een afbeelding. Gezichten worden gerangschikt op gezichtsrechthoekgrootte van groot naar klein.
- Voor optimale resultaten bij het uitvoeren van query's op Face - Identificeer, Gezicht - Controleeren Gezicht - Vind vergelijkbare ('returnFaceId' is waar), gebruikt u gezichten die zijn: frontaal, helder en met een minimale grootte van 200x200 pixels (100 pixels tussen ogen).
- De minimale detecteerbare gezichtsgrootte is 36x36 pixels in een afbeelding die niet groter is dan 1920x1080 pixels. Afbeeldingen met afmetingen die hoger zijn dan 1920x1080 pixels hebben een proportioneel grotere minimale gezichtsgrootte nodig.
- Er kunnen verschillende 'detectionModel'-waarden worden opgegeven. Als u verschillende detectiemodellen wilt gebruiken en vergelijken, raadpleegt u Een detectiemodel opgeven
- Er worden verschillende 'recognitionModel'-waarden opgegeven. Als opvolgingsbewerkingen zoals Verifiëren, Identificeren, Zoeken vergelijkbaar nodig zijn, geeft u het herkenningsmodel op met de parameter recognitionModel. De standaardwaarde voor recognitionModel is 'recognition_01' als het meest recente model nodig is, geeft u expliciet het model op dat u nodig hebt in deze parameter. Zodra dit is opgegeven, worden de gedetecteerde faceIds gekoppeld aan het opgegeven herkenningsmodel. Zie Geef een herkenningsmodel opvoor meer informatie.
function detectWithStream(image: HttpRequestBody, options?: FaceDetectWithStreamOptionalParams): Promise<FaceDetectWithStreamResponse>Parameters
- image
- HttpRequestBody
Een afbeeldingsstroom.
De optionele parameters
Retouren
Promise<FaceDetectWithStreamResponse>
Beloof<modellen.FaceDetectWithStreamResponse>
detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams, ServiceCallback<DetectedFace[]>)
function detectWithStream(image: HttpRequestBody, options: FaceDetectWithStreamOptionalParams, callback: ServiceCallback<DetectedFace[]>)Parameters
- image
- HttpRequestBody
Een afbeeldingsstroom.
De optionele parameters
- callback
De callback
detectWithStream(HttpRequestBody, ServiceCallback<DetectedFace[]>)
function detectWithStream(image: HttpRequestBody, callback: ServiceCallback<DetectedFace[]>)Parameters
- image
- HttpRequestBody
Een afbeeldingsstroom.
- callback
De callback
detectWithUrl(string, FaceDetectWithUrlOptionalParams)
Detecteer menselijke gezichten in een afbeelding, retourneer gezichtsrechthoeken en eventueel met faceIds, oriëntatiepunten en kenmerken.
Er wordt geen installatiekopieën opgeslagen. Alleen de geëxtraheerde gezichtsfunctie wordt op de server opgeslagen. De faceId is een id van de gezichtsfunctie en wordt gebruikt in Face - Identificeer, Gezicht - Controleeren Gezicht - Vind vergelijkbare. De opgeslagen gezichtsfuncties verlopen en worden verwijderd op het moment dat is opgegeven door faceIdTimeToLive na de oorspronkelijke detectieaanroep.
Optionele parameters omvatten faceId, oriëntatiepunten en kenmerken. Kenmerken zijn leeftijd, geslacht, headPose, glimlach, facialHair, bril, emotie, haar, make-up, occlusie, accessoires, vervagen, blootstelling, ruis, masker en kwaliteitForRecognition. Sommige resultaten die worden geretourneerd voor specifieke kenmerken, zijn mogelijk niet zeer nauwkeurig.
JPEG-, PNG-, GIF-, GIF-indeling (het eerste frame) en BMP-indeling worden ondersteund. De toegestane grootte van het afbeeldingsbestand is van 1 KB tot 6 MB.
Er kunnen maximaal 100 gezichten worden geretourneerd voor een afbeelding. Gezichten worden gerangschikt op gezichtsrechthoekgrootte van groot naar klein.
Voor optimale resultaten bij het uitvoeren van query's op Face - Identificeer, Gezicht - Controleeren Gezicht - Vind vergelijkbare ('returnFaceId' is waar), gebruikt u gezichten die zijn: frontaal, helder en met een minimale grootte van 200x200 pixels (100 pixels tussen ogen).
De minimale detecteerbare gezichtsgrootte is 36x36 pixels in een afbeelding die niet groter is dan 1920x1080 pixels. Afbeeldingen met afmetingen die hoger zijn dan 1920x1080 pixels hebben een proportioneel grotere minimale gezichtsgrootte nodig.
Er kunnen verschillende 'detectionModel'-waarden worden opgegeven. Als u verschillende detectiemodellen wilt gebruiken en vergelijken, raadpleegt u Een detectiemodel opgeven.
Er worden verschillende 'recognitionModel'-waarden opgegeven. Als opvolgingsbewerkingen zoals Verifiëren, Identificeren, Zoeken vergelijkbaar nodig zijn, geeft u het herkenningsmodel op met de parameter recognitionModel. De standaardwaarde voor recognitionModel is 'recognition_01' als het meest recente model nodig is, geeft u expliciet het model op dat u nodig hebt in deze parameter. Zodra dit is opgegeven, worden de gedetecteerde faceIds gekoppeld aan het opgegeven herkenningsmodel. Zie Geef een herkenningsmodel opvoor meer informatie.
function detectWithUrl(url: string, options?: FaceDetectWithUrlOptionalParams): Promise<FaceDetectWithUrlResponse>Parameters
- url
-
string
Openbaar toegankelijke URL van een afbeelding
- options
- FaceDetectWithUrlOptionalParams
De optionele parameters
Retouren
Promise<FaceDetectWithUrlResponse>
Beloof<Models.FaceDetectWithUrlResponse>
detectWithUrl(string, FaceDetectWithUrlOptionalParams, ServiceCallback<DetectedFace[]>)
function detectWithUrl(url: string, options: FaceDetectWithUrlOptionalParams, callback: ServiceCallback<DetectedFace[]>)Parameters
- url
-
string
Openbaar toegankelijke URL van een afbeelding
- options
- FaceDetectWithUrlOptionalParams
De optionele parameters
- callback
De callback
detectWithUrl(string, ServiceCallback<DetectedFace[]>)
function detectWithUrl(url: string, callback: ServiceCallback<DetectedFace[]>)Parameters
- url
-
string
Openbaar toegankelijke URL van een afbeelding
- callback
De callback
findSimilar(string, FaceFindSimilarOptionalParams)
Gezien de faceId van het querygezicht, kunt u zoeken in vergelijkbare gezichten uit een faceId-matrix, een gezichtslijst of een grote gezichtslijst. faceId-matrix bevat de gezichten die zijn gemaakt door Face - Detect With Url of Face - Detect With Stream, die verlopen op het moment dat is opgegeven door faceIdTimeToLive na het maken. Er wordt een 'faceListId' gemaakt door FaceList : maak met persistenteFaceIds die niet verlopen. En een 'largeFaceListId' wordt gemaakt door LargeFaceList - Maak met persistenteFaceIds die ook niet verlopen. Afhankelijk van de invoer bevat de geretourneerde lijst met vergelijkbare gezichten faceIds of persistentedFaceIds gerangschikt op gelijkenis.
Zoeken op vergelijkbare manier heeft twee werkmodi, 'matchPerson' en 'matchFace'. "matchPerson" is de standaardmodus waarmee wordt geprobeerd gezichten van dezelfde persoon te vinden door interne drempelwaarden van dezelfde persoon te gebruiken. Het is handig om de andere foto's van een bekende persoon te vinden. Houd er rekening mee dat er een lege lijst wordt geretourneerd als er geen gezichten voldoen aan de interne drempelwaarden. De 'matchFace'-modus negeert drempelwaarden van dezelfde persoon en retourneert toch gerangschikte vergelijkbare gezichten, zelfs de gelijkenis is laag. Het kan worden gebruikt in de gevallen zoals het doorzoeken van beroemdheidsgezichten.
Het 'recognitionModel' dat is gekoppeld aan de faceId van het querygezicht, moet hetzelfde zijn als het 'recognitionModel' dat wordt gebruikt door de doel-faceId-matrix, gezichtslijst of grote gezichtslijst.
function findSimilar(faceId: string, options?: FaceFindSimilarOptionalParams): Promise<FaceFindSimilarResponse>Parameters
- faceId
-
string
FaceId van het query-gezicht. De gebruiker moet Face aanroepen - Detecteren eerst om een geldige faceId te krijgen. Houd er rekening mee dat deze faceId niet behouden blijft en verloopt op het moment dat is opgegeven door faceIdTimeToLive na de detectieaanroep
- options
- FaceFindSimilarOptionalParams
De optionele parameters
Retouren
Promise<FaceFindSimilarResponse>
Beloof<Models.FaceFindSimilarResponse>
findSimilar(string, FaceFindSimilarOptionalParams, ServiceCallback<SimilarFace[]>)
function findSimilar(faceId: string, options: FaceFindSimilarOptionalParams, callback: ServiceCallback<SimilarFace[]>)Parameters
- faceId
-
string
FaceId van het query-gezicht. De gebruiker moet Face aanroepen - Detecteren eerst om een geldige faceId te krijgen. Houd er rekening mee dat deze faceId niet behouden blijft en verloopt op het moment dat is opgegeven door faceIdTimeToLive na de detectieaanroep
- options
- FaceFindSimilarOptionalParams
De optionele parameters
- callback
De callback
findSimilar(string, ServiceCallback<SimilarFace[]>)
function findSimilar(faceId: string, callback: ServiceCallback<SimilarFace[]>)Parameters
- faceId
-
string
FaceId van het query-gezicht. De gebruiker moet Face aanroepen - Detecteren eerst om een geldige faceId te krijgen. Houd er rekening mee dat deze faceId niet behouden blijft en verloopt op het moment dat is opgegeven door faceIdTimeToLive na de detectieaanroep
- callback
De callback
group(string[], RequestOptionsBase)
Deel kandidaatgezichten in groepen op basis van gelijkenis met gezichten.
- De uitvoer is een of meer niet-aaneengesloten gezichtsgroepen en een rommelige groep. Een gezichtsgroep bevat gezichten met een vergelijkbare blik, vaak van dezelfde persoon. Gezichtsgroepen worden gerangschikt op groepsgrootte, bijvoorbeeld het aantal gezichten. U ziet dat gezichten die tot dezelfde persoon behoren, mogelijk worden gesplitst in verschillende groepen in het resultaat.
- MessyGroup is een speciale gezichtsgroep met gezichten die geen vergelijkbare tegenhanger van oorspronkelijke gezichten kunnen vinden. De rommeligeGroup wordt niet weergegeven in het resultaat als alle gezichten hun tegenhangers hebben gevonden.
- Groeps-API heeft ten minste 2 kandidaat-gezichten en maximaal 1000 nodig. We raden u aan om gezicht te proberen: controleer wanneer u slechts 2 kandidaatgezichten hebt.
- Het 'recognitionModel' dat is gekoppeld aan de faceIds van de querygezichten, moet hetzelfde zijn.
function group(faceIds: string[], options?: RequestOptionsBase): Promise<FaceGroupResponse>Parameters
- faceIds
-
string[]
Matrix van kandidaat faceId gemaakt door Face - Detect. Het maximum is 1000 gezichten
- options
- RequestOptionsBase
De optionele parameters
Retouren
Promise<FaceGroupResponse>
Promise<Models.FaceGroupResponse->
group(string[], RequestOptionsBase, ServiceCallback<GroupResult>)
function group(faceIds: string[], options: RequestOptionsBase, callback: ServiceCallback<GroupResult>)Parameters
- faceIds
-
string[]
Matrix van kandidaat faceId gemaakt door Face - Detect. Het maximum is 1000 gezichten
- options
- RequestOptionsBase
De optionele parameters
- callback
De callback
group(string[], ServiceCallback<GroupResult>)
function group(faceIds: string[], callback: ServiceCallback<GroupResult>)Parameters
- faceIds
-
string[]
Matrix van kandidaat faceId gemaakt door Face - Detect. Het maximum is 1000 gezichten
- callback
De callback
identify(string[], FaceIdentifyOptionalParams)
1-op-veel identificatie om de dichtstbijzijnde overeenkomsten te vinden van de specifieke query persoon gezicht uit een persoonsgroep of grote persoonsgroep.
Voor elk gezicht in de faceIds-matrix berekent Face Identify overeenkomsten tussen het querygezicht en alle gezichten in de persoonsgroep (gegeven door personGroupId) of een grote persoonsgroep (gegeven door largePersonGroupId) en retourneert u kandidaat-persoon(en) voor dat gezicht gerangschikt op gelijkenisvertrouwen. De groep/grote persoonsgroep moet worden getraind om deze gereed te maken voor identificatie. Zie meer in PersonGroup - Train en LargePersonGroup - Train.
Opmerkingen:
- Met het algoritme kunnen meerdere gezichten onafhankelijk worden geïdentificeerd op dezelfde aanvraag, maar niet meer dan 10 gezichten.
- Elke persoon in de groep/grote persoon kan meer dan één gezicht hebben, maar niet meer dan 248 gezichten.
- Een hogere afbeeldingskwaliteit van het gezicht betekent een betere identificatieprecisie. Overweeg gezichten van hoge kwaliteit: frontaal, helder en gezichtsgrootte is 200x200 pixels (100 pixels tussen ogen) of groter.
- Het aantal geretourneerde kandidaten wordt beperkt door maxNumOfCandidatesReturned en confidenceThreshold. Als er geen persoon wordt geïdentificeerd, zijn de geretourneerde kandidaten een lege matrix.
- Probeer Gezicht - Vergelijkbare zoeken wanneer u vergelijkbare gezichten uit een gezichtslijst/grote gezichtslijst moet vinden in plaats van een groep/grote persoonsgroep.
- Het 'recognitionModel' dat is gekoppeld aan de faceIds van de querygezichten, moet hetzelfde zijn als het 'recognitionModel' dat wordt gebruikt door de doelgroep of grote persoonsgroep.
function identify(faceIds: string[], options?: FaceIdentifyOptionalParams): Promise<FaceIdentifyResponse>Parameters
- faceIds
-
string[]
Matrix van faceIds van querygezichten, gemaakt door het gezicht - Detecteren. Elk van de gezichten wordt onafhankelijk geïdentificeerd. Het geldige aantal faceIds ligt tussen [1, 10].
- options
- FaceIdentifyOptionalParams
De optionele parameters
Retouren
Promise<FaceIdentifyResponse>
Beloof<modellen.FaceIdentifyResponse>
identify(string[], FaceIdentifyOptionalParams, ServiceCallback<IdentifyResult[]>)
function identify(faceIds: string[], options: FaceIdentifyOptionalParams, callback: ServiceCallback<IdentifyResult[]>)Parameters
- faceIds
-
string[]
Matrix van faceIds van querygezichten, gemaakt door het gezicht - Detecteren. Elk van de gezichten wordt onafhankelijk geïdentificeerd. Het geldige aantal faceIds ligt tussen [1, 10].
- options
- FaceIdentifyOptionalParams
De optionele parameters
- callback
De callback
identify(string[], ServiceCallback<IdentifyResult[]>)
function identify(faceIds: string[], callback: ServiceCallback<IdentifyResult[]>)Parameters
- faceIds
-
string[]
Matrix van faceIds van querygezichten, gemaakt door het gezicht - Detecteren. Elk van de gezichten wordt onafhankelijk geïdentificeerd. Het geldige aantal faceIds ligt tussen [1, 10].
- callback
De callback
verifyFaceToFace(string, string, RequestOptionsBase)
Controleer of twee gezichten tot dezelfde persoon behoren of of één gezicht tot een persoon behoort.
Opmerkingen:
- Een hogere afbeeldingskwaliteit van het gezicht betekent een betere identificatieprecisie. Overweeg gezichten van hoge kwaliteit: frontaal, helder en gezichtsgrootte is 200x200 pixels (100 pixels tussen ogen) of groter.
- Voor de scenario's die gevoelig zijn voor nauwkeurigheid, moet u uw eigen oordeel geven.
- Het 'recognitionModel' dat is gekoppeld aan de faceIds van de querygezichten, moet hetzelfde zijn als het 'recognitionModel' dat wordt gebruikt door het doelgezicht, de personengroep of de grote persoonsgroep.
function verifyFaceToFace(faceId1: string, faceId2: string, options?: RequestOptionsBase): Promise<FaceVerifyFaceToFaceResponse>Parameters
- faceId1
-
string
FaceId van het eerste gezicht, afkomstig van Face - Detecteren
- faceId2
-
string
FaceId van het tweede gezicht, afkomstig van Face - Detecteren
- options
- RequestOptionsBase
De optionele parameters
Retouren
Promise<FaceVerifyFaceToFaceResponse>
Beloof<modellen.FaceVerifyFaceToFaceResponse>
verifyFaceToFace(string, string, RequestOptionsBase, ServiceCallback<VerifyResult>)
function verifyFaceToFace(faceId1: string, faceId2: string, options: RequestOptionsBase, callback: ServiceCallback<VerifyResult>)Parameters
- faceId1
-
string
FaceId van het eerste gezicht, afkomstig van Face - Detecteren
- faceId2
-
string
FaceId van het tweede gezicht, afkomstig van Face - Detecteren
- options
- RequestOptionsBase
De optionele parameters
- callback
De callback
verifyFaceToFace(string, string, ServiceCallback<VerifyResult>)
function verifyFaceToFace(faceId1: string, faceId2: string, callback: ServiceCallback<VerifyResult>)Parameters
- faceId1
-
string
FaceId van het eerste gezicht, afkomstig van Face - Detecteren
- faceId2
-
string
FaceId van het tweede gezicht, afkomstig van Face - Detecteren
- callback
De callback
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams)
Controleer of twee gezichten tot dezelfde persoon behoren. Vergelijkt een gezichts-id met een persoons-id
function verifyFaceToPerson(faceId: string, personId: string, options?: FaceVerifyFaceToPersonOptionalParams): Promise<FaceVerifyFaceToPersonResponse>Parameters
- faceId
-
string
FaceId van het gezicht, afkomstig van Face - Detecteren
- personId
-
string
Geef een bepaalde persoon op in een personengroep of een groep met grote personen. personId wordt gemaakt in PersonGroup Person - Create or LargePersonGroup Person - Create.
De optionele parameters
Retouren
Promise<FaceVerifyFaceToPersonResponse>
Beloof<modellen.FaceVerifyFaceToPersonResponse>
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams, ServiceCallback<VerifyResult>)
function verifyFaceToPerson(faceId: string, personId: string, options: FaceVerifyFaceToPersonOptionalParams, callback: ServiceCallback<VerifyResult>)Parameters
- faceId
-
string
FaceId van het gezicht, afkomstig van Face - Detecteren
- personId
-
string
Geef een bepaalde persoon op in een personengroep of een groep met grote personen. personId wordt gemaakt in PersonGroup Person - Create or LargePersonGroup Person - Create.
De optionele parameters
- callback
De callback
verifyFaceToPerson(string, string, ServiceCallback<VerifyResult>)
function verifyFaceToPerson(faceId: string, personId: string, callback: ServiceCallback<VerifyResult>)Parameters
- faceId
-
string
FaceId van het gezicht, afkomstig van Face - Detecteren
- personId
-
string
Geef een bepaalde persoon op in een personengroep of een groep met grote personen. personId wordt gemaakt in PersonGroup Person - Create or LargePersonGroup Person - Create.
- callback
De callback