FaceListOperations.CreateWithHttpMessagesAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.CognitiveServices.Vision.Face

Ensamblado:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paquete:

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

Source:

FaceListOperations.cs

Crea una lista de caras vacía con el elemento faceListId especificado por el usuario, el elemento name, un elemento opcional userData y el elemento recognitionModel. Se permiten hasta 64 listas de caras en una suscripción. <br/> Face list es una lista de caras, hasta 1000 caras, y usada por Face - Find Similar. <br/> After creation, el usuario debe usar FaceList - Add Face para importar las caras. Las caras se almacenan en el servidor hasta que se llama a FaceList- Delete . <br/> Find Similar se usa para escenarios como buscar caras similares a celebridades, filtrado de caras similares o como una identificación facial clara. Pero si el uso real es para identificar a la persona, use PersonGroup / LargePersonGroup y Face - Identify. <br /> Please consider LargeFaceList when the face number is large. Puede admitir hasta 1000 000 caras. Se debe especificar 'recognitionModel' para asociarlo a esta lista de caras. El valor predeterminado de "recognitionModel" es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita en este parámetro. Las caras nuevas que se agregan a una lista de caras existentes usarán el modelo de reconocimiento que ya está asociado a la colección. Las características de caras existentes de una lista de caras no se pueden actualizar a las características extraídas por otra versión del modelo de reconocimiento.

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)

Parámetros

faceListId

String

Identificador que hace referencia a una lista de caras determinada.

name

String

Nombre definido por el usuario, la longitud máxima es 128.

userData

String

Datos especificados por el usuario. La longitud no debe superar los 16 KB.

recognitionModel

String

Entre los valores posibles se incluyen: "recognition_01", "recognition_02"

customHeaders

Dictionary<String,List<String>>

Encabezados que se agregarán a la solicitud.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<HttpOperationResponse>

Implementaciones

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

Excepciones

APIErrorException

Se produce cuando la operación devolvió un código de estado no válido

ValidationException

Se produce cuando un parámetro obligatorio es NULL

ArgumentNullException

Se produce cuando un parámetro obligatorio es NULL