Face List Operations - Train Large Face List

Service:

Azure AI Services

Version d'API:

v1.2-preview.1

Envoyez une tâche d’entraînement de liste de visages volumineuse.

L’entraînement est une étape cruciale que seule une liste de visages volumineuse entraînée peut être utilisée par « Rechercher des visages similaires à partir d’une grande liste de visages ».

La tâche d’entraînement est une tâche asynchrone. Le temps d’entraînement dépend du nombre d’entrées de visage dans une liste de visages volumineux. Il peut s’agir en secondes, ou jusqu’à une demi-heure pour 1 000 000 visages. Pour vérifier l’achèvement de l’entraînement, utilisez « Obtenir l’état d’entraînement de la liste des visages volumineux ».

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
apiVersion	path	True	string	Version de l’API
endpoint	path	True	string uri	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://{nom-ressource}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Le caractère valide est la lettre en minuscules ou en chiffres ou '-' ou '_', la longueur maximale est 64. Modèle d’expression régulière: ^[a-z0-9-_]+$

Réponses

Nom	Type	Description
202 Accepted		Un appel réussi retourne un corps de réponse vide. En-têtes operation-Location: string
Other Status Codes	FaceErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Clé secrète de votre abonnement Azure AI Face.

Type: apiKey
Dans: header

AADToken

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: accessCode
URL d’autorisation: https://api.example.com/oauth2/authorize
URL du jeton: https://api.example.com/oauth2/token

Étendues

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

Exemples

Train LargeFaceList

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:

202

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

Définitions

Nom	Description
FaceError	Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Réponse contenant les détails de l’erreur.

FaceError

Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
message	string	Représentation lisible par l’homme de l’erreur.

FaceErrorResponse

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	FaceError	Objet d’erreur.