Face List Operations - Train Large Face List

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Een trainingstaak voor een grote gezichtslijst indienen.

Training is een cruciale stap die alleen een getrainde grote gezichtslijst kan worden gebruikt door 'Zoeken vergelijkbaar van grote gezichtslijst'.

De trainingstaak is een asynchrone taak. De trainingstijd is afhankelijk van het aantal gezichtsvermeldingen in een grote gezichtslijst. Het kan in seconden of maximaal een half uur duren voor 1.000.000 gezichten. Als u de voltooiing van de training wilt controleren, gebruikt u Trainingsstatus voor grote gezichten ophalen.

POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/train

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string uri	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Geldig teken is een letter in kleine letters of cijfers of '-' of '_', de maximumlengte is 64. Regex-patroon: ^[a-z0-9-_]+$

Antwoorden

Name	Type	Description
202 Accepted		Een geslaagde aanroep retourneert een lege antwoordtekst. Kopteksten operation-Location: string
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Train LargeFaceList

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

202

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

Definities

Name	Description
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.