FaceListOperations.CreateWithHttpMessagesAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paquet:

Microsoft.Azure.CognitiveServices.Vision.Face v2.8.0-preview.3

Source:

FaceListOperations.cs

Crée une liste de visages vide avec les valeurs faceListId, name, éventuellement userData et recognitionModel spécifiées par l’utilisateur. Jusqu’à 64 listes de visages sont autorisées dans un abonnement. <br /> Liste de visages est une liste de visages, jusqu’à 1 000 visages, et utilisée par Visage - Rechercher similaire. <br /> Après la création, l’utilisateur doit utiliser FaceList - Add Face pour importer les visages. Les visages sont stockés sur le serveur jusqu’à ce que FaceList - Delete soit appelé. <br /> Rechercher similaire est utilisé pour des scénarios tels que la recherche de visages ressemblant à des célébrités, un filtrage de visage similaire ou comme une identification de visage de manière légère. Mais si l’utilisation réelle est d’identifier une personne, utilisez PersonGroup / LargePersonGroup et Face - Identifier. <br /> Pensez à LargeFaceList lorsque le nombre de visages est grand. Il peut prendre en charge jusqu’à 1 000 000 visages. 'recognitionModel' doit être spécifié à associer à cette liste de visages. La valeur par défaut de « recognitionModel » est « recognition_01 ». Si le modèle le plus récent est nécessaire, spécifiez explicitement le modèle dont vous avez besoin dans ce paramètre. Les nouveaux visages ajoutés à une liste de visages existante utilisent le modèle de reconnaissance déjà associé à la collection. Les fonctionnalités de visage existantes dans une liste de visages ne peuvent pas être mises à jour vers des fonctionnalités extraites par une autre version du modèle de reconnaissance.

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse> CreateWithHttpMessagesAsync (string faceListId, string name, string userData = default, string recognitionModel = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateWithHttpMessagesAsync : string * string * string * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse>
override this.CreateWithHttpMessagesAsync : string * string * string * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse>

Public Function CreateWithHttpMessagesAsync (faceListId As String, name As String, Optional userData As String = Nothing, Optional recognitionModel As String = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse)

Paramètres

faceListId

String

ID référençant une liste de visages particulière.

name

String

Nom défini par l’utilisateur, la longueur maximale est 128.

userData

String

Données spécifiées par l’utilisateur. La longueur ne doit pas dépasser 16 Ko.

recognitionModel

String

Les valeurs possibles sont les suivantes : « recognition_01 », « recognition_02 »

customHeaders

Dictionary<String,List<String>>

En-têtes qui seront ajoutés à la requête.

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<HttpOperationResponse>

Implémente

CreateWithHttpMessagesAsync(String, String, String, String, Dictionary<String,List<String>>, CancellationToken)

Exceptions

APIErrorException

Levée lorsque l’opération a retourné un code status non valide

ValidationException

Levée lorsqu’un paramètre requis a la valeur Null

ArgumentNullException

Levée lorsqu’un paramètre requis a la valeur Null