Person Group Operations - Add Large Person Group Person Face From Url

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Voeg een gezicht toe aan een persoon in een grote personengroep voor gezichtsidentificatie of -verificatie.
Als u een afbeelding met meerdere gezichten wilt verwerken, kan het invoervlak worden opgegeven als een afbeelding met een targetFace-rechthoek. Het retourneert een persistenteFaceId die het toegevoegde gezicht vertegenwoordigt. Er wordt geen installatiekopieën opgeslagen. Alleen de geëxtraheerde gezichtsfuncties worden opgeslagen op de server totdat Het gezicht van grote personengroep verwijderen, 'Grote persoon groep persoon verwijderen' of 'Grote persoon groep verwijderen' wordt aangeroepen.

Houd er rekening mee dat persistentFaceId verschilt van faceId die wordt gegenereerd door 'Detect'.

• • Hogere afbeeldingskwaliteit van gezicht betekent betere herkenningsprecisie. Overweeg gezichten van hoge kwaliteit: frontaal, helder en gezichtsgrootte is 200x200 pixels (100 pixels tussen ogen) of groter.
  • Elke persoon kan maximaal 248 gezichten bevatten.
  • 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.
  • De rechthoek targetFace moet één gezicht bevatten. Nul of meerdere gezichten worden beschouwd als een fout. Als de opgegeven 'targetFace'-rechthoek niet wordt geretourneerd door 'Detecteren', is er geen garantie om het gezicht te detecteren en toe te voegen.
  • Uit detecteerbare gezichtsgrootte (36x36 - 4096x4096 pixels), grote hoofdhouding of grote occlusies leiden tot storingen.
  • 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 https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces

Met optionele parameters:

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string uri	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).
largePersonGroupId	path	True	string	Id van de container. Regex-patroon: ^[a-z0-9-_]+$
personId	path	True	string uuid	Id van de persoon.
detectionModel	query		DetectionModel	Het 'detectionModel' dat is gekoppeld aan de gedetecteerde faceIds. Ondersteunde 'detectionModel'-waarden zijn 'detection_01', 'detection_02' en 'detection_03'. De standaardwaarde is 'detection_01'.
targetFace	query		integer[]	Een gezichtsrechthoek om het doelvlak op te geven dat aan een persoon moet worden toegevoegd, in de notatie targetFace=left,top,width,height.
userData	query		string	Door de gebruiker verstrekte gegevens die aan het gezicht zijn gekoppeld. De groottelimiet is 1K.

Aanvraagbody

Name	Vereist	Type	Description
url	True	string	URL van invoerafbeelding.

Antwoorden

Name	Type	Description
200 OK	AddFaceResult	Een geslaagde aanroep retourneert een nieuwe persistenteFaceId.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

Name	Description
https://cognitiveservices.azure.com/.default

Voorbeelden

Add Face in LargePersonGroup Person from Url

Voorbeeldaanvraag

HTTP

POST {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces?targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

{
  "url": "https://microsoft.com/example.jpg"
}

Voorbeeldrespons

Statuscode:

200

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}

Definities

Name	Description
AddFaceResult	Antwoordtekst voor het toevoegen van gezicht.
DetectionModel	Het 'detectionModel' dat is gekoppeld aan de gedetecteerde faceIds. Ondersteunde 'detectionModel'-waarden zijn 'detection_01', 'detection_02' en 'detection_03'. De standaardwaarde is 'detection_01'.
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.

AddFaceResult

Antwoordtekst voor het toevoegen van gezicht.

Name	Type	Description
persistedFaceId	string	Permanente Face ID van het toegevoegde gezicht, dat behouden blijft en niet verloopt. Verschilt van faceId die wordt gemaakt in 'Detecteren' en verloopt binnen 24 uur na de detectieaanroep.

DetectionModel

Het 'detectionModel' dat is gekoppeld aan de gedetecteerde faceIds. Ondersteunde 'detectionModel'-waarden zijn 'detection_01', 'detection_02' en 'detection_03'. De standaardwaarde is 'detection_01'.

Name	Type	Description
detection_01	string	Het standaarddetectiemodel. Aanbevolen voor gezichtsdetectie in de buurt van frontale gezichten. Voor scenario's met uitzonderlijk grote hoek (hoofdhouding) gezichten, occluded gezichten of verkeerde afdrukstand, kunnen de gezichten in dergelijke gevallen niet worden gedetecteerd.
detection_02	string	Detectiemodel uitgebracht in 2019 met verbeterde nauwkeurigheid, met name op kleine, zij- en wazige gezichten.
detection_03	string	Detectiemodel uitgebracht in 2021 februari met verbeterde nauwkeurigheid, met name op kleine gezichten.

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.