Dela via

Face List Operations - Train Large Face List

  • Referens
Tjänst:
Azure AI Services
API-version:
v1.2-preview.1

Skicka en träningsuppgift för stor ansiktslista.

Träning är ett viktigt steg att endast en tränad stor ansiktslista kan användas av "Hitta liknande från stor ansiktslista".

Träningsuppgiften är en asynkron uppgift. Träningstiden beror på antalet ansiktsposter i en stor ansiktslista. Det kan vara i sekunder, eller upp till en halvtimme för 1 000 000 ansikten. Om du vill kontrollera att träningen har slutförts använder du "Hämta träningsstatus för stor ansiktslista".

POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/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).
largeFaceListId
 path True

string

Giltigt tecken är bokstav i gemener eller siffror eller "-" eller "_", maximal längd är 64.

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 LargeFaceList

Exempelbegäran

POST {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id/train

Exempelsvar

Statuskod:
202 
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.