Personalizar um modelo de Pessoa com a API do Azure AI Video Indexer

Importante

Devido ao anúncio de desativação dos Serviços de Mídia do Azure, o Azure AI Video Indexer anuncia ajustes nos recursos do Azure AI Video Indexer. Consulte Alterações relacionadas à aposentadoria do Azure Media Service (AMS) para entender o que isso significa para sua conta do Azure AI Video Indexer. Consulte o guia Preparando para a aposentadoria do AMS: VI atualização e migração.

Nota

O acesso a recursos de identificação facial, personalização e reconhecimento de celebridades é limitado com base em critérios de elegibilidade e uso, a fim de apoiar nossos princípios de IA responsável. Os recursos de identificação facial, personalização e reconhecimento de celebridades estão disponíveis apenas para clientes e parceiros gerenciados pela Microsoft. Use o formulário de admissão de Reconhecimento Facial para solicitar acesso.

O Azure AI Video Indexer dá suporte à deteção de rostos e ao reconhecimento de celebridades para conteúdo de vídeo. O recurso de reconhecimento de celebridades cobre cerca de um milhão de rostos com base em fontes de dados comumente solicitadas, como IMDB, Wikipedia e os principais influenciadores do LinkedIn. Os rostos que não são reconhecidos pelo recurso de reconhecimento de celebridades são detetados, mas não são identificados. Depois de carregar seu vídeo no Azure AI Video Indexer e obter resultados de volta, você pode voltar e nomear os rostos que não foram reconhecidos. Depois de rotular um rosto com um nome, o rosto e o nome são adicionados ao modelo Pessoa da sua conta. O Azure AI Video Indexer reconhecerá esse rosto em seus vídeos futuros e vídeos anteriores.

Você pode usar a API do Azure AI Video Indexer para editar rostos que foram detetados em um vídeo, conforme descrito neste tópico. Você também pode usar o site do Azure AI Video Indexer, conforme descrito em Personalizar modelo de pessoa usando o site do Azure AI Video Indexer.

Gerenciando vários modelos de Pessoa

O Azure AI Video Indexer dá suporte a vários modelos de Pessoa por conta. Atualmente, esse recurso está disponível apenas por meio das APIs do Azure AI Video Indexer.

Se sua conta atender a diferentes cenários de casos de uso, convém criar vários modelos de Pessoa por conta. Por exemplo, se o seu conteúdo estiver relacionado a esportes, você poderá criar um modelo de Pessoa separado para cada esporte (futebol, basquete, futebol e assim por diante).

Depois que um modelo é criado, você pode usá-lo fornecendo a ID do modelo de um modelo de Pessoa específico ao carregar/indexar ou reindexar um vídeo. O treinamento de um novo rosto para um vídeo atualiza o modelo personalizado específico ao qual o vídeo foi associado.

Cada conta tem um limite de modelos de 50 pessoas. Se você não precisar do suporte ao modelo de várias Pessoas, não atribua um ID de modelo de Pessoa ao seu vídeo ao carregar/indexar ou reindexar. Nesse caso, o Azure AI Video Indexer usa o modelo de Pessoa personalizado padrão em sua conta.

Criar um novo modelo de Pessoa

Para criar um novo modelo de Pessoa na conta especificada, use a API de criação de um modelo de pessoa.

A resposta fornece o nome e o ID do modelo gerado do modelo Person que você acabou de criar seguindo o formato do exemplo abaixo.

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

Em seguida, use o valor id para o parâmetro personModelId ao carregar um vídeo para indexar ou reindexar um vídeo.

Excluir um modelo de Pessoa

Para excluir um modelo de Pessoa personalizado da conta especificada, use a API de modelo de Excluir uma pessoa.

Depois que o modelo Pessoa for excluído com êxito, o índice dos vídeos atuais que estavam usando o modelo excluído permanecerá inalterado até que você os reindexe. Após a reindexação, os rostos que foram nomeados no modelo excluído não serão reconhecidos pelo Azure AI Video Indexer em seus vídeos atuais que foram indexados usando esse modelo, mas os rostos ainda serão detetados. Seus vídeos atuais que foram indexados usando o modelo excluído agora usarão o modelo Pessoa padrão da sua conta. Se os rostos do modelo excluído também forem nomeados no modelo padrão da sua conta, esses rostos continuarão a ser reconhecidos nos vídeos.

Não há conteúdo retornado quando o modelo Pessoa é excluído com êxito.

Obter todos os modelos Person

Para obter todos os modelos de Pessoa na conta especificada, use a API de modelo Obter uma pessoa.

A resposta fornece uma lista de todos os modelos de Pessoa na sua conta (incluindo o modelo de Pessoa padrão na conta especificada) e cada um dos seus nomes e IDs seguindo o formato do exemplo abaixo.

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

Você pode escolher qual modelo deseja usar para um vídeo usando o id valor do modelo Person para o personModelId parâmetro ao carregar um vídeo para indexar ou reindexar um vídeo.

Atualizar um rosto

Este comando permite que você atualize um rosto em seu vídeo com um nome usando o ID do vídeo e ID do rosto. Em seguida, esta ação atualiza o modelo de Pessoa ao qual o vídeo foi associado ao carregar/indexar ou reindexar. Se nenhum modelo de Pessoa tiver sido atribuído, ele atualizará o modelo de Pessoa padrão da conta.

Em seguida, o sistema reconhece as ocorrências do mesmo rosto em seus outros vídeos atuais que compartilham o mesmo modelo de Pessoa. O reconhecimento do rosto em seus outros vídeos atuais pode levar algum tempo para entrar em vigor, pois este é um processo em lote.

Você pode atualizar um rosto que o Azure AI Video Indexer reconheceu como uma celebridade com um novo nome. O novo nome que você der terá precedência sobre o reconhecimento de celebridade embutido.

Para atualizar o rosto, use a API de atualização de um rosto de vídeo .

Os nomes são exclusivos para modelos de Pessoa, portanto, se você der a dois rostos diferentes no mesmo modelo de Pessoa o mesmo name valor de parâmetro, o Azure AI Video Indexer exibirá os rostos como a mesma pessoa e os convergirá assim que você reindexar seu vídeo.