Person Group Operations - Train Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Skicka en persongruppsträningsaktivitet. Utbildning är ett viktigt steg som endast en tränad persongrupp kan användas av "Identifiera från persongrupp".
Träningsuppgiften är en asynkron aktivitet. 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. Regex pattern: ^[a-z0-9-_]+$

Svar

Name	Typ	Description
202 Accepted		Ett lyckat anrop returnerar en tom svarstext. Headers operation-Location: string
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 Azure AI Face-prenumeration.

Type: apiKey
In: header

AADToken

The Azure Active Directory OAuth2 Flow

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

Train PersonGroup

Sample Request

HTTP

POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/train

Sample Response

Status code:

202

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

Definitioner

Name	Description
FaceError	Felobjektet. Omfattande 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. Omfattande 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 läsbar återgivning av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.