Dela via


Person Group Operations - Train Person Group

Skicka en persongruppsträningsuppgift. Utbildning är ett viktigt steg att endast en tränad persongrupp kan användas av "Identifiera från persongrupp".
Träningsuppgiften är en asynkron uppgift. Träningstiden beror på antalet personposter och deras ansikten i en persongrupp. Det kan ta flera sekunder till minuter. Om du vill kontrollera träningsstatusen använder du "Get Person Group Training Status".

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/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).

personGroupId
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 PersonGroup

Exempelbegäran

POST {endpoint}/face/v1.2-preview.1/persongroups/your_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.