IFaceOperations インターフェイス

定義

FaceOperations 操作。

public interface IFaceOperations
type IFaceOperations = interface
Public Interface IFaceOperations
派生

メソッド

DetectWithStreamWithHttpMessagesAsync(Stream, Nullable<Boolean>, Nullable<Boolean>, IList<FaceAttributeType>, String, Nullable<Boolean>, String, Nullable<Int32>, Dictionary<String,List<String>>, CancellationToken)

FaceOperations 操作。

DetectWithUrlWithHttpMessagesAsync(String, Nullable<Boolean>, Nullable<Boolean>, IList<FaceAttributeType>, String, Nullable<Boolean>, String, Nullable<Int32>, Dictionary<String,List<String>>, CancellationToken)

FaceOperations 操作。

FindSimilarWithHttpMessagesAsync(Guid, String, String, IList<Nullable<Guid>>, Nullable<Int32>, FindSimilarMatchMode, Dictionary<String,List<String>>, CancellationToken)

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

GroupWithHttpMessagesAsync(IList<Guid>, Dictionary<String,List<String>>, CancellationToken)

顔の類似性に基づいて候補の顔をグループに分割します。<Br/>

  • 出力は、1 つ以上の分離された顔グループと messyGroup です。 顔グループには、多くの場合、同じ人物に似た顔が含まれています。 顔グループは、グループ サイズ (顔の数) によってランク付けされます。 同じ人物に属する顔が、結果の複数のグループに分割される可能性があることに注意してください。
  • MessyGroup は、元の顔から類似した顔を見つけることができない顔を含む特殊な顔グループです。 すべての顔が対応する顔を見つけた場合、結果に messyGroup は表示されません。
  • グループ API には、少なくとも 2 つの候補顔と最大 1000 個が必要です。 顔の候補が 2 つしかない場合は 、Face - Verify を試してみることをお勧めします。
  • クエリの顔に関連付けられている 'recognitionModel' faceIds は同じである必要があります。
IdentifyWithHttpMessagesAsync(IList<Guid>, String, String, String, IList<String>, Nullable<Int32>, Nullable<Double>, Dictionary<String, List<String>>, CancellationToken)

FaceOperations 操作。

VerifyFaceToFaceWithHttpMessagesAsync(Guid, Guid, Dictionary<String,List<String>>, CancellationToken)

2 つの顔が同一人物に属しているか 1 つの顔が 1 人の人物に属しているかを確認します。 <br/> 解説:<br />

  • 顔の画質が高いほど、識別精度が向上します。 前面、透明、顔サイズは 200 x 200 ピクセル (目の間に 100 ピクセル) 以上の高品質な顔を検討してください。
  • 精度に敏感なシナリオについては、ご自身で判断してください。
  • クエリ顔に関連付けられている 'recognitionModel' faceIds は、ターゲットの顔、人物グループ、または大きな人物グループで使用される 'recognitionModel' と同じである必要があります。
VerifyFaceToPersonWithHttpMessagesAsync(Guid, Guid, String, String, Dictionary<String,List<String>>, CancellationToken)

2 つの顔が同じ人物に属しているかどうかを確認します。 顔 ID と人物 ID を比較します

拡張メソッド

DetectWithStreamAsync(IFaceOperations, Stream, Nullable<Boolean>, Nullable<Boolean>, IList<FaceAttributeType>, String, Nullable<Boolean>, String, Nullable<Int32>, CancellationToken)

FaceOperations 操作。

DetectWithUrlAsync(IFaceOperations, String, Nullable<Boolean>, Nullable<Boolean>, IList<FaceAttributeType>, String, Nullable<Boolean>, String, Nullable<Int32>, CancellationToken)

FaceOperations 操作。

FindSimilarAsync(IFaceOperations, Guid, String, String, IList<Nullable<Guid>>, Nullable<Int32>, FindSimilarMatchMode, CancellationToken)

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

GroupAsync(IFaceOperations, IList<Guid>, CancellationToken)

顔の類似性に基づいて候補の顔をグループに分割します。<Br/>

  • 出力は、1 つ以上の分離された顔グループと messyGroup です。 顔グループには、多くの場合、同じ人物に似た顔が含まれています。 顔グループは、グループ サイズ (顔の数) によってランク付けされます。 同じ人物に属する顔が、結果の複数のグループに分割される可能性があることに注意してください。
  • MessyGroup は、元の顔から類似した顔を見つけることができない顔を含む特殊な顔グループです。 すべての顔が対応する顔を見つけた場合、結果に messyGroup は表示されません。
  • グループ API には、少なくとも 2 つの候補顔と最大 1000 個が必要です。 顔の候補が 2 つしかない場合は 、Face - Verify を試してみることをお勧めします。
  • クエリの顔に関連付けられている 'recognitionModel' faceIds は同じである必要があります。
IdentifyAsync(IFaceOperations, IList<Guid>, String, String, String, IList<String>, Nullable<Int32>, Nullable<Double>, CancellationToken)

FaceOperations 操作。

VerifyFaceToFaceAsync(IFaceOperations, Guid, Guid, CancellationToken)

2 つの顔が同一人物に属しているか 1 つの顔が 1 人の人物に属しているかを確認します。 <br/> 解説:<br />

  • 顔の画質が高いほど、識別精度が向上します。 前面、透明、顔サイズは 200 x 200 ピクセル (目の間に 100 ピクセル) 以上の高品質な顔を検討してください。
  • 精度に敏感なシナリオについては、ご自身で判断してください。
  • クエリ顔に関連付けられている 'recognitionModel' faceIds は、ターゲットの顔、人物グループ、または大きな人物グループで使用される 'recognitionModel' と同じである必要があります。
VerifyFaceToPersonAsync(IFaceOperations, Guid, Guid, String, String, CancellationToken)

2 つの顔が同じ人物に属しているかどうかを確認します。 顔 ID と人物 ID を比較します

適用対象