Freigeben über


ILargeFaceListOperations.CreateWithHttpMessagesAsync Methode

Definition

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, die von Face - Find Similar verwendet wird. <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 Szenarien 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/>

  • Free-Tarif-Abonnementkontingent: 64 große Gesichtslisten.
  • S0-Tarif-Abonnementkontingent: 1.000.000 große Gesichtslisten. <br/> "recognitionModel" sollte angegeben werden, um dieser großen Gesichtsliste zuzuordnen. Der Standardwert für "recognitionModel" ist "recognition_01". Wenn das neueste Modell erforderlich ist, geben Sie in diesem Parameter explizit das modell an, das Sie benötigen. Neue Gesichter, die einer vorhandenen großen Gesichtsliste hinzugefügt werden, verwenden das Erkennungsmodell, das bereits der Auflistung 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>
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>>

Die Header, die der Anforderung hinzugefügt werden.

cancellationToken
CancellationToken

Das Abbruchtoken.

Gibt zurück

Ausnahmen

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

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist

Gilt für: