LargeFaceListOperations.CreateWithHttpMessagesAsync Methode

Definition

Namespace:

Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paket:

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

Quelle:

LargeFaceListOperations.cs

Hiermit erstellen Sie eine leere umfangreiche Gesichterliste mit benutzerseitigen Angaben für die ID der umfangreichen Gesichterliste (largeFaceListId), Name und optional Benutzerdaten (userData) und Erkennungsmodell (recognitionModel). <br /> Große Gesichtsliste ist eine Liste von Gesichtern mit bis zu 1.000.000 Gesichtern und wird von Face - Find Similar verwendet. <br /> Nach der Erstellung sollte der Benutzer LargeFaceList Face - Add verwenden, um die Gesichter zu importieren, und LargeFaceList – Train , um es für Face - FindSimilar vorzubereiten. Gesichter werden auf dem Server gespeichert, bis LargeFaceList – Delete aufgerufen wird. <br /> Find Similar wird für Szenarios wie die Suche nach prominenten Gesichtern, ähnliche Gesichtsfilterung oder als leichte Gesichtserkennung verwendet. Wenn die tatsächliche Verwendung jedoch darin besteht, eine Person zu identifizieren, verwenden Sie bitte PersonGroup / LargePersonGroup und Face - Identify. <Br/>

• Abonnementkontingent des kostenlosen Tarifs: 64 große Gesichtslisten.
• S0-Tarif-Abonnementkontingent: 1.000.000 große Gesichtslisten. <br/> "recognitionModel" sollte angegeben werden, um diese große Gesichtsliste zuzuordnen. Der Standardwert für "recognitionModel" ist "recognition_01". Wenn das neueste Modell erforderlich ist, geben Sie bitte explizit das modell an, das Sie in diesem Parameter benötigen. Neue Gesichter, die einer vorhandenen großen Gesichtsliste hinzugefügt werden, verwenden das Erkennungsmodell, das bereits der Sammlung zugeordnet ist. Vorhandene Gesichtsfeatures in einer großen Gesichtsliste können nicht auf Features aktualisiert werden, die von einer anderen Version des Erkennungsmodells extrahiert wurden.

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse> CreateWithHttpMessagesAsync (string largeFaceListId, 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 (largeFaceListId 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)

Parameter

largeFaceListId

String

Id, die auf eine bestimmte große Gesichtsliste verweist.

name

String

Benutzerdefinierter Name, maximale Länge ist 128.

userData

String

Vom Benutzer angegebene Daten. Die Länge sollte 16 KB nicht überschreiten.

recognitionModel

String

Mögliche Werte: "recognition_01", "recognition_02"

customHeaders

Dictionary<String,List<String>>

Header, die der Anforderung hinzugefügt werden.

cancellationToken

CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<HttpOperationResponse>

Implementiert

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

Ausnahmen

APIErrorException

Wird ausgelöst, wenn der Vorgang einen ungültigen status Code zurückgegeben hat.

ValidationException

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist

ArgumentNullException

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist