Personnaliser un modèle de personne avec l’API Azure AI Video Indexer

  • Article

Important

En raison de l’annonce de mise hors service d’Azure Media Services, Azure AI Video Indexer annonce les ajustements des fonctionnalités d’Azure AI Video Indexer. Consultez les modifications relatives à la mise hors service Azure Media Service (AMS) pour comprendre ce que cela signifie pour votre compte Azure AI Video Indexer. Consultez le guide de préparation de la mise hors service AMS : Mise à jour et migration vi.

Remarque

L’accès aux fonctionnalités d’identification faciale, de personnalisation et de reconnaissance de la notoriété est limité en fonction des critères d’éligibilité et d’utilisation afin de prendre en charge nos principes d’IA responsable. Les fonctionnalités d’identification faciale, de personnalisation et de reconnaissance de la notoriété ne sont disponibles que pour les clients et partenaires managés par Microsoft. Utilisez le Formulaire d’admission de la reconnaissance faciale pour demander l’accès.

Azure AI Video Indexer prend en charge la détection des visages et la reconnaissance des célébrités pour le contenu vidéo. La fonctionnalité de reconnaissance de célébrités couvre environ un million de visages en fonction de la source de données couramment demandée comme IMDB, Wikipédia et les principaux influenceurs LinkedIn. Les visages qui ne sont pas reconnus par la fonctionnalité de reconnaissance de célébrités sont détectés, mais sont laissés sans nom. Après avoir chargé votre vidéo dans Azure AI Video Indexer et renvoyé les résultats, vous pouvez revenir en arrière et nommer les visages qui n’ont pas été reconnus. Une fois que vous étiquetez un visage avec un nom, le visage et le nom sont ajoutés au modèle de personne de votre compte. Azure AI Video Indexer reconnaîtra ensuite ce visage dans vos futures vidéos et vidéos passées.

Vous pouvez utiliser l’API Azure AI Video Indexer pour modifier les visages détectés dans une vidéo, comme décrit dans cette rubrique. Vous pouvez également utiliser le site web Azure AI Video Indexer, comme décrit dans Personnaliser le modèle de personne à l’aide du site web Azure AI Video Indexer.

Gestion de plusieurs modèles de personne

Azure AI Video Indexer prend en charge plusieurs modèles de personne par compte. Cette fonctionnalité est actuellement disponible uniquement via les API Azure AI Video Indexer.

Si votre compte est adapté à différents scénarios d’utilisation, vous souhaiterez peut-être créer plusieurs modèles de personne par compte. Par exemple, si votre contenu est lié au sport, vous pouvez créer un modèle de personne distinct par sport (football, basketball, soccer, etc.).

Une fois un modèle créé, vous pouvez l’utiliser en fournissant l’ID d’un modèle de personne spécifique lors du chargement /de l’indexation ou de la réindexation d’une vidéo. La formation du modèle sur un nouveau visage dans une vidéo met à jour le modèle personnalisé spécifique auquel la vidéo était associée.

Chaque compte possède une limite de 50 modèles de personne. Si vous n’avez pas besoin de la prise en charge de plusieurs modèles de personne, n’affectez aucun ID de modèle de personne à votre vidéo lors de son chargement/indexation ou de sa réindexation. Dans ce cas, Azure AI Video Indexer utilise le modèle de personne personnalisé par défaut dans votre compte.

Créer un nouveau modèle de personne

Pour créer un nouveau modèle de personne sur le compte spécifié, utilisez l'API Créer un modèle de personne.

La réponse fournit le nom et l’ID généré du modèle de personne que vous venez de créer au format de l’exemple ci-dessous.

{
    "id": "227654b4-912c-4b92-ba4f-641d488e3720",
    "name": "Example Person Model"
}

Utilisez ensuite la valeur id pour le paramètre personModelId lors du chargement d’une vidéo à indexer ou de la réindexation d’une vidéo.

Supprimer un modèle de personne

Pour supprimer un modèle de personne personnalisé sur le compte spécifié, utilisez l'API Supprimer un modèle de personne.

Une fois le modèle de personne supprimé, l’index des vidéos actuelles utilisant le modèle supprimé restera inchangé jusqu’à ce que vous les réindexiez. Lors de la réindexation, les visages nommés dans le modèle supprimé ne seront pas reconnus par Azure AI Video Indexer dans vos vidéos actuelles indexées à l’aide de ce modèle, mais les visages seront toujours détectés. Les vidéos actuelles indexées à l’aide du modèle supprimé utiliseront désormais le modèle de personne par défaut de votre compte. Si des faces du modèle supprimé sont également nommées dans le modèle par défaut de votre compte, ces visages continueront d’être reconnus dans les vidéos.

Aucun contenu n’est retourné en cas de suppression effective du modèle de personne.

Obtenir tous les modèles de personne

Pour obtenir tous les modèles de personne sur le compte spécifié, utilisez l'API Obtenir un modèle de personne.

La réponse fournit une liste de tous les modèles de personne de votre compte (dont le modèle de personne par défaut du compte spécifié), ainsi que le nom et l’ID de chacun au format de l’exemple ci-dessous.

[
    {
        "id": "59f9c326-b141-4515-abe7-7d822518571f",
        "name": "Default"
    }, 
    {
        "id": "9ef2632d-310a-4510-92e1-cc70ae0230d4",
        "name": "Test"
    }
]

Vous pouvez choisir le modèle que vous souhaitez utiliser pour une vidéo en utilisant la valeur id du modèle de personne pour le paramètre personModelId lors du chargement d’une vidéo à indexer ou de la réindexation d’une vidéo.

Mettre à jour un visage

Cette commande vous permet de mettre à jour un visage dans votre vidéo avec un nom à l’aide de l’ID de la vidéo et l’ID du visage. Cette action met ensuite à jour le modèle de personne auquel la vidéo était associée lors de son chargement/indexation ou de sa réindexation. Si aucun modèle de personne n’était attribué, elle met à jour le modèle de personne du compte par défaut.

Le système reconnaît alors les occurrences du même visage dans vos autres vidéos actuelles partageant le même modèle de personne. La reconnaissance du visage dans vos autres vidéos actuelles peut prendre un certain temps pour entrer en vigueur, car il s’agit d’un processus de traitement par lots.

Vous pouvez mettre à jour un visage reconnu par Azure AI Video Indexer comme une célébrité avec un nouveau nom. Le nouveau nom affecté est prioritaire sur la reconnaissance de célébrités intégrée.

Pour mettre à jour le visage, utilisez l'API Mettre à jour un visage dans une vidéo.

Les noms sont uniques pour les modèles person. Par conséquent, si vous donnez deux visages différents dans le même modèle de personne la même name valeur de paramètre, Azure AI Video Indexer affiche les visages comme la même personne et les converge une fois que vous réindexez votre vidéo.