Person Group Operations - Create Large Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Skapa en ny stor persongrupp med användardefinerade largePersonGroupId, namn, en valfri userData och recognitionModel.
En stor persongrupp är en container som innehåller uppladdade persondata, inklusive ansiktsigenkänningsfunktionerna. Den kan innehålla upp till 1 000 000 entiteter.

När du har skapat den använder du "Skapa stor persongruppsperson" för att lägga till person i gruppen och anropar "Träna stor persongrupp" för att förbereda den här gruppen för "Identifiera från stor persongrupp".

Ingen avbildning kommer att lagras. Endast personens extraherade ansiktsfunktioner och userData lagras på servern tills "Delete Large Person Group Person" eller "Delete Large Person Group" anropas.

"recognitionModel" ska anges för att associeras med den här stora persongruppen. Standardvärdet för "recognitionModel" är "recognition_01", om den senaste modellen behövs anger du uttryckligen den modell som du behöver i den här parametern. Nya ansikten som läggs till i en befintlig stor persongrupp använder igenkänningsmodellen som redan är associerad med samlingen. Befintliga ansiktsfunktioner i en stor persongrupp kan inte uppdateras till funktioner som extraheras av en annan version av igenkänningsmodellen.

Anteckning

• • Prenumerationskvot på kostnadsfri nivå: 1 000 stora Grupper.
  • Prenumerationskvot på S0-nivå: 1 000 000 stora Grupper.

PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
apiVersion	path	True	string	API-version
endpoint	path	True	string uri	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com).
largePersonGroupId	path	True	string	ID för containern. Regex pattern: ^[a-z0-9-_]+$

Begärandetext

Name	Obligatorisk	Typ	Description
name	True	string	Användardefinierat namn, maxlängden är 128.
recognitionModel		RecognitionModel	Den "recognitionModel" som är associerad med den här ansiktslistan. "recognitionModel"-värden som stöds är "recognition_01", "recognition_02, "recognition_03" och "recognition_04". Standardvärdet är "recognition_01". "recognition_04" rekommenderas eftersom dess noggrannhet förbättras på ansikten som bär masker jämfört med "recognition_03", och dess övergripande noggrannhet förbättras jämfört med "recognition_01" och "recognition_02".
userData		string	Valfria användardefinierade data. Längden får inte överstiga 16 K.

Svar

Name	Typ	Description
200 OK		Begäran har slutförts.
Other Status Codes	FaceErrorResponse	Ett oväntat felsvar. Headers x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Ansiktsprenumeration på Azure AI.

Type: apiKey
In: header

AADToken

Azure Active Directory OAuth2-flödet

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

Exempel

Create LargePersonGroup

Sample Request

HTTP

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

Status code:

200

Definitioner

Name	Description
FaceError	Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ett svar som innehåller felinformation.

FaceError

Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på följande länk: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
message	string	En mänsklig läsbar representation av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.