Person Group Operations - Create Large Person Group
Creatie een nieuwe large person-groep met door de gebruiker opgegeven largePersonGroupId, naam, een optionele userData en recognitionModel.
Een large person group is een container met de geüploade persoonsgegevens, inclusief de gezichtsherkenningsfuncties. Het kan maximaal 1.000.000 entiteiten bevatten.
Nadat u het hebt gemaakt, gebruikt u 'Creatie Grote persoon groepspersoon' om persoon toe te voegen aan de groep en roept u 'Groep grote personen trainen' aan om deze groep gereed te maken voor 'Identificeren van grote personengroep'.
Er wordt geen afbeelding opgeslagen. Alleen de geëxtraheerde gezichtsfunctie(en) en userData van de persoon worden op de server opgeslagen totdat 'Delete Large Person Group Person' of 'Delete Large Person Group' wordt aangeroepen.
'recognitionModel' moet worden opgegeven om te koppelen aan deze groep met grote personen. 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 worden toegevoegd aan een bestaande groep grote personen, gebruiken het herkenningsmodel dat al aan de verzameling is gekoppeld. Bestaande gezichtsfuncties in een groep met grote personen kunnen niet worden bijgewerkt naar functies die zijn geëxtraheerd door een andere versie van het herkenningsmodel.
Notitie
-
- Quotum voor gratis abonnementen: 1.000 Large Person Groepen.
- Abonnementsquotum voor S0-lagen: 1.000.000 Large Person Groepen.
PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
api
|
path | True |
string |
API-versie |
endpoint
|
path | True |
string uri |
Ondersteunde Cognitive Services-eindpunten (protocol- en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com). |
large
|
path | True |
string |
Id van de container. Regex pattern: |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
name | True |
string |
Door de gebruiker gedefinieerde naam, maximale lengte is 128. |
recognitionModel |
Recognition |
Het 'recognitionModel' dat aan deze gezichtslijst is gekoppeld. Ondersteunde waarden voor recognitionModel 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 is verbeterd op gezichten die maskers dragen in vergelijking met "recognition_03", en de algehele nauwkeurigheid ervan is 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 |
Een onverwachte foutreactie. Headers 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 OAuth2-stroom van Azure Active Directory
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Name | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Voorbeelden
Create LargePersonGroup
Sample Request
PUT {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id
{
"name": "your_large_person_group_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Sample Response
Definities
Name | Description |
---|---|
Face |
Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die door de Face-service worden geretourneerd: https://aka.ms/face-error-codes-and-messages. |
Face |
Een antwoord met foutdetails. |
FaceError
Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die door de Face-service worden geretourneerd: 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 door mensen leesbare weergave van de fout. |
FaceErrorResponse
Een antwoord met foutdetails.
Name | Type | Description |
---|---|---|
error |
Het foutobject. |