FaceListOperations.CreateWithHttpMessagesAsync Método

Definição

Namespace:

Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Pacote:

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

Origem:

FaceListOperations.cs

Crie uma lista de rostos vazia com o faceListId especificado pelo usuário, o nome, um userData opcional e o recognitionModel. Até 64 listas de rostos são permitidas em uma assinatura. <br /> Face list é uma lista de rostos, até 1.000 rostos e usada por Face - Localizar Semelhante. <br/> Após a criação, o usuário deve usar FaceList – Adicionar Rosto para importar os rostos. Os rostos são armazenados no servidor até que FaceList – Delete seja chamado. <br /> Find Similar é usado para cenários como encontrar rostos semelhantes a celebridades, filtragem facial semelhante ou como uma identificação facial de forma leve. Mas se o uso real for identificar a pessoa, use PersonGroup / LargePersonGroup e Face - Identifique. <br /> Considere LargeFaceList quando o número de rosto for grande. Ele pode dar suporte a até 1.000.000 rostos. 'recognitionModel' deve ser especificado para associar a essa lista de rostos. O valor padrão para 'recognitionModel' é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário nesse parâmetro. Novos rostos adicionados a uma lista de rostos existente usarão o modelo de reconhecimento que já está associado à coleção. Os recursos de rosto existentes em uma lista de rostos não podem ser atualizados para recursos extraídos por outra versão do modelo de reconhecimento.

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

ID que faz referência a uma lista de rostos específica.

name

String

Nome definido pelo usuário, o comprimento máximo é 128.

userData

String

Dados especificados pelo usuário. O comprimento não deve exceder 16 KB.

recognitionModel

String

Os valores possíveis incluem: 'recognition_01', 'recognition_02'

customHeaders

Dictionary<String,List<String>>

Cabeçalhos que serão adicionados à solicitação.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<HttpOperationResponse>

Implementações

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

Exceções

APIErrorException

Gerada quando a operação retornou um código de status inválido

ValidationException

Gerado quando um parâmetro necessário é nulo

ArgumentNullException

Gerado quando um parâmetro necessário é nulo