Partager via


IFaceOperations.GroupWithHttpMessagesAsync Méthode

Définition

Divisez les visages des candidats en groupes en fonction de la similarité des visages.< Br/>

  • La sortie est un ou plusieurs groupes de visages disjoints et un messyGroup. Un groupe de visages contient des visages qui ont une apparence similaire, souvent de la même personne. Les groupes de visages sont classés par taille de groupe, c’est-à-dire par nombre de visages. Notez que les visages appartenant à une même personne peuvent être divisés en plusieurs groupes dans le résultat.
  • MessyGroup est un groupe de visages spécial contenant des visages qui ne peuvent pas trouver un visage équivalent similaire à celui des visages d’origine. Le messyGroup n’apparaît pas dans le résultat si tous les visages ont trouvé leurs équivalents.
  • L’API de groupe a besoin d’au moins 2 visages candidats et de 1 000 au maximum. Nous vous suggérons d’essayer Visage - Vérifier si vous n’avez que 2 visages candidats.
  • Les faceIds « recognitionModel » associés aux visages de requête doivent être identiques.
public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>> GroupWithHttpMessagesAsync (System.Collections.Generic.IList<Guid> faceIds, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GroupWithHttpMessagesAsync : System.Collections.Generic.IList<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>>
Public Function GroupWithHttpMessagesAsync (faceIds As IList(Of Guid), Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of GroupResult))

Paramètres

faceIds
IList<Guid>

Tableau de faceId candidat créé par Face - Detect. Le maximum est de 1 000 visages

customHeaders
Dictionary<String,List<String>>

En-têtes qui seront ajoutés à la demande.

cancellationToken
CancellationToken

Jeton d'annulation.

Retours

Exceptions

Levée lorsque l’opération a retourné un code status non valide

Levée lorsque la réponse ne peut pas être désérialisée

Levée lorsqu’un paramètre requis a la valeur Null

S’applique à