Dela via


Person Group Operations - Train Large Person Group

Skicka en träningsuppgift för en stor persongrupp. Träning är ett viktigt steg som endast en tränad stor persongrupp kan användas av "Identifiera från stor persongrupp".
Träningsuppgiften är en asynkron uppgift. Träningstiden beror på antalet personposter och deras ansikten i en stor persongrupp. Det kan vara på flera sekunder, eller upp till en halvtimme för 1 000 000 personer. Om du vill kontrollera träningsstatusen använder du "Get Large Person Group Training Status".

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/train

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.

Reguljärt uttrycksmönster: ^[a-z0-9-_]+$

Svar

Name Typ Description
202 Accepted

Ett lyckat anrop returnerar en tom svarstext.

Sidhuvuden

operation-Location: string

Other Status Codes

FaceErrorResponse

Ett oväntat felsvar.

Sidhuvuden

x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Azure AI Face-prenumeration.

Typ: apiKey
I: header

AADToken

The Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://api.example.com/oauth2/authorize
Token-webbadress: https://api.example.com/oauth2/token

Omfattningar

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

Exempel

Train LargePersonGroup

Exempelbegäran

POST {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id/train

Exempelsvar

operation-Location: https://contoso.com/operationstatus

Definitioner

Name Description
FaceError

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

FaceErrorResponse

Ett svar som innehåller felinformation.

FaceError

Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i 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.