FaceOperations.FindSimilarWithHttpMessagesAsync メソッド

リファレンス

定義

名前空間:: Microsoft.Azure.CognitiveServices.Vision.Face

アセンブリ:: Microsoft.Azure.CognitiveServices.Vision.Face.dll

パッケージ:: Microsoft.Azure.CognitiveServices.Vision.Face v2.8.0-preview.3

ソース:: FaceOperations.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

与えられたクエリの顔の faceId に対して、faceId 配列、顔リスト、または大規模顔リストから類似の顔を検索します。 faceId 配列には、 Face - Detect によって作成された顔が含まれています。これは、作成後 24 時間後に期限切れになります。 "faceListId" は、FaceList - 有効期限が切れない persistedFaceIds を含む作成によって作成されます。また、"largeFaceListId" は LargeFaceList - Create によって作成され、また期限切れにならない persistedFaceIds を含みます。入力に応じて、返される類似した顔の一覧には、類似性によってランク付けされた faceIds または persistedFaceId が含まれます。 <br/>Find similar には、"matchPerson" と "matchFace" の 2 つの動作モードがあります。 "matchPerson" は、内部の同一人物しきい値を使用して、可能な限り同じ人物の顔を検索しようとする既定のモードです。これは、既知の人の他の写真を見つけるのに役立ちます。内部しきい値を超える顔がない場合は、空のリストが返されることに注意してください。 "matchFace" モードでは、同一人物のしきい値が無視され、ランク付けされた類似した顔が返されます。類似性が低い場合でも同様です。有名人のような顔を検索する場合に使用できます。 <br/>クエリ顔の faceId に関連付けられている 'recognitionModel' は、ターゲット faceId 配列、顔リスト、または大きな顔リストで使用される 'recognitionModel' と同じである必要があります。

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>>> FindSimilarWithHttpMessagesAsync (Guid faceId, string faceListId = default, string largeFaceListId = default, System.Collections.Generic.IList<Guid?> faceIds = default, int? maxNumOfCandidatesReturned = 20, Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode mode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode.MatchPerson, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member FindSimilarWithHttpMessagesAsync : Guid * string * string * System.Collections.Generic.IList<Nullable<Guid>> * Nullable<int> * Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>>>
override this.FindSimilarWithHttpMessagesAsync : Guid * string * string * System.Collections.Generic.IList<Nullable<Guid>> * Nullable<int> * Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>>>

Public Function FindSimilarWithHttpMessagesAsync (faceId As Guid, Optional faceListId As String = Nothing, Optional largeFaceListId As String = Nothing, Optional faceIds As IList(Of Nullable(Of Guid)) = Nothing, Optional maxNumOfCandidatesReturned As Nullable(Of Integer) = 20, Optional mode As FindSimilarMatchMode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode.MatchPerson, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of IList(Of SimilarFace)))

パラメーター

faceId: Guid

クエリ顔の FaceId。有効な faceId を取得するには、ユーザーが Face - Detect first を呼び出す必要があります。この faceId は永続化されず、検出呼び出しの 24 時間後に期限切れになることに注意してください

faceListId: String

顔リストで作成された、既存のユーザー指定の一意の候補顔リスト

顔リストを作成します。 Face list には、永続化され、期限切れになることのない persistedFaceIds のセットが含まれています。パラメーター faceListId、largeFaceListId、および faceId は同時に指定しないでください。

largeFaceListId: String

LargeFaceList - Create で作成された、既存のユーザー指定の一意の候補の大きな顔リスト。大きな顔リストには、永続化され、期限切れになることのない一連の persistedFaceId が含まれています。パラメーター faceListId、largeFaceListId、および faceId は同時に指定しないでください。

faceIds: IList<Nullable<Guid>>

候補の faceId の配列。これらはすべて Face - Detect によって作成され、faceId は検出呼び出しの 24 時間後に期限切れになります。 faceId の数は 1000 に制限されています。パラメーター faceListId、largeFaceListId、および faceId は同時に指定しないでください。