Person Group Operations - Create Person Group

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Maak een nieuwe person-groep met de opgegeven personGroupId, naam, door de gebruiker verstrekte userData en recognitionModel.
Een persoonsgroep is een container met de geüploade persoonsgegevens, waaronder gezichtsherkenningsfuncties.

Nadat u de persoon hebt gemaakt, gebruikt u Persoonsgroep maken om personen toe te voegen aan de groep en roept u vervolgens 'Train Person Group' aan om deze groep voor te bereiden op 'Identificeren van persoonsgroep'.

Er wordt geen installatiekopieën opgeslagen. Alleen de uitgepakte gezichtsfuncties van de persoon en userData worden op de server opgeslagen totdat 'Persoonsgroep verwijderen' of 'Persoonsgroep verwijderen' wordt aangeroepen.

'recognitionModel' moet worden opgegeven om aan deze persoonsgroep te koppelen. 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. Nieuwe gezichten die aan een bestaande personengroep worden toegevoegd, gebruiken het herkenningsmodel dat al aan de verzameling is gekoppeld. Bestaande gezichtsfuncties in een persoonsgroep kunnen niet worden bijgewerkt naar functies die zijn geëxtraheerd door een andere versie van het herkenningsmodel.

Notitie

• • Quotum voor gratis abonnementen: 1000 Personengroepen. Elk bevat maximaal 1.000 personen.
  • Quotum voor S0-lagen: 1.000.000 Personengroepen. Elk bevat maximaal 10.000 personen.
  • als u een groter probleem met gezichtsidentificatie wilt afhandelen, kunt u overwegen grote personengroep te gebruiken.

PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}

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).
personGroupId	path	True	string	Id van de container. Regex-patroon: ^[a-z0-9-_]+$

Aanvraagbody

Name	Vereist	Type	Description
name	True	string	Door de gebruiker gedefinieerde naam, de maximale lengte is 128.
recognitionModel		RecognitionModel	Het 'recognitionModel' dat aan deze gezichtslijst is gekoppeld. Ondersteunde 'recognitionModel'-waarden zijn onder andere 'recognition_01', 'recognition_02, 'recognition_03' en 'recognition_04'. De standaardwaarde is 'recognition_01'. 'recognition_04' wordt aanbevolen omdat de nauwkeurigheid ervan wordt verbeterd op gezichten die maskers dragen in vergelijking met 'recognition_03', en de algehele nauwkeurigheid ervan wordt verbeterd in vergelijking met 'recognition_01' en 'recognition_02'.
userData		string	Optionele door de gebruiker gedefinieerde gegevens. De lengte mag niet groter zijn dan 16.000.

Antwoorden

Name	Type	Description
200 OK		De aanvraag is voltooid.
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

Create PersonGroup

Voorbeeldaanvraag

HTTP

PUT {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id

{
  "name": "your_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Voorbeeldrespons

Statuscode:

200

Definities

Name	Description
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.

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.