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 |
---|---|---|---|---|
api
|
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). |
large
|
path | True |
string |
ID för containern. Reguljärt uttrycksmönster: |
Svar
Name | Typ | Description |
---|---|---|
202 Accepted |
Ett lyckat anrop returnerar en tom svarstext. Sidhuvuden operation-Location: string |
|
Other Status Codes |
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 |
---|---|
Face |
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. |
Face |
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 |
Felobjektet. |