Personalizar um modelo de Marcas 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.

O Azure AI Video Indexer dá suporte à deteção de marca a partir de fala e texto visual durante a indexação e reindexação de conteúdo de vídeo e áudio. O recurso de deteção de marca identifica menções a produtos, serviços e empresas sugeridas pelo banco de dados de marcas do Bing. Por exemplo, se a Microsoft for mencionada em conteúdo de vídeo ou áudio ou se aparecer em texto visual em um vídeo, o Azure AI Video Indexer a detetará como uma marca no conteúdo. Um modelo personalizado de Marcas permite excluir determinadas marcas de serem detetadas e incluir marcas que deveriam fazer parte do seu modelo e que podem não estar no banco de dados de marcas do Bing. Para obter mais informações, veja Descrição geral.

Nota

Se o seu vídeo foi indexado antes de adicionar uma marca, você precisa reindexá-lo.

Você pode usar as APIs do Azure AI Video Indexer para criar, usar e editar modelos personalizados de Marcas 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 marcas usando o site do Azure AI Video Indexer.

Criar uma Marca

A API de criação de uma marca cria uma nova marca personalizada e a adiciona ao modelo Marcas personalizado para a conta especificada.

Nota

A configuração enabled (no corpo) como true coloca a marca na lista Incluir para o Azure AI Video Indexer detetar. A configuração enabled como false coloca a marca na lista Excluir, para que o Azure AI Video Indexer não a detete.

Alguns outros parâmetros que você pode definir no corpo:

  • O referenceUrl valor pode ser qualquer site de referência para a marca, como um link para sua página na Wikipédia.
  • O tags valor é uma lista de tags para a marca. Essa tag aparece no campo Categoria da marca no site do Azure AI Video Indexer. Por exemplo, a marca "Azure" pode ser marcada ou categorizada como "Cloud".

Response

A resposta fornece informações sobre a marca que você acabou de criar seguindo o formato do exemplo abaixo.

{
  "referenceUrl": "https://en.wikipedia.org/wiki/Example",
  "id": 97974,
  "name": "Example",
  "accountId": "SampleAccountId",
  "lastModifierUserName": "SampleUserName",
  "created": "2018-04-25T14:59:52.7433333",
  "lastModified": "2018-04-25T14:59:52.7433333",
  "enabled": true,
  "description": "This is an example",
  "tags": [
    "Tag1",
    "Tag2"
  ]
}

Excluir uma marca

A API de exclusão de uma marca remove uma marca do modelo Marcas personalizado para a conta especificada. A conta é especificada no accountId parâmetro. Uma vez chamada com sucesso, a marca não estará mais nas listas Incluir ou Excluir marcas.

Response

Não há conteúdo devolvido quando a marca é excluída com êxito.

Obter uma marca específica

A API get a brand permite pesquisar os detalhes de uma marca no modelo Brands personalizado para a conta especificada usando o ID da marca.

Response

A resposta fornece informações sobre a marca que você pesquisou (usando o ID da marca) seguindo o formato do exemplo abaixo.

{
  "referenceUrl": "https://en.wikipedia.org/wiki/Example",
  "id": 128846,
  "name": "Example",
  "accountId": "SampleAccountId",
  "lastModifierUserName": "SampleUserName",
  "created": "2018-01-06T13:51:38.3666667",
  "lastModified": "2018-01-11T13:51:38.3666667",
  "enabled": true,
  "description": "This is an example",
  "tags": [
    "Tag1",
    "Tag2"
  ]
}

Nota

enabledser definido como true significa que a marca está na lista Incluir para o Azure AI Video Indexer detetar, e enabled ser false significa que a marca está na lista Excluir, portanto, o Azure AI Video Indexer não a detetará.

Atualizar uma marca específica

A atualização de uma API de marca permite pesquisar os detalhes de uma marca no modelo Marcas personalizado para a conta especificada usando o ID da marca.

Response

A resposta fornece as informações atualizadas sobre a marca que você atualizou seguindo o formato do exemplo abaixo.

{
  "referenceUrl": null,
  "id": 97974,
  "name": "Example",
  "accountId": "SampleAccountId",
  "lastModifierUserName": "SampleUserName",
  "Created": "2018-04-25T14:59:52.7433333",
  "lastModified": "2018-04-25T15:37:50.67",
  "enabled": false,
  "description": "This is an update example",
  "tags": [
    "Tag1",
    "NewTag2"
  ]
}

Obtenha todas as Marcas

A API get all brands retorna todas as marcas no modelo personalizado Brands para a conta especificada, independentemente de a marca estar na lista Incluir ou Excluir marcas.

Response

A resposta fornece uma lista de todas as marcas na sua conta e cada um dos seus detalhes seguindo o formato do exemplo abaixo.

[
    {
        "ReferenceUrl": null,
        "id": 97974,
        "name": "Example",
        "accountId": "AccountId",
        "lastModifierUserName": "UserName",
        "Created": "2018-04-25T14:59:52.7433333",
        "LastModified": "2018-04-25T14:59:52.7433333",
        "enabled": true,
        "description": "This is an example",
        "tags": ["Tag1", "Tag2"]
    },
    {
        "ReferenceUrl": null,
        "id": 97975,
        "name": "Example2",
        "accountId": "AccountId",
        "lastModifierUserName": "UserName",
        "Created": "2018-04-26T14:59:52.7433333",
        "LastModified": "2018-04-26T14:59:52.7433333",
        "enabled": false,
        "description": "This is another example",
        "tags": ["Tag1", "Tag2"]
    },
]

Nota

A marca chamada Exemplo está na lista Incluir para o Azure AI Video Indexer detetar, e a marca chamada Example2 está na lista Excluir, portanto, o Azure AI Video Indexer não a detetará.

Obter configurações de modelo do Brands

A API get brands settings retorna as configurações do modelo Brands na conta especificada. As configurações do modelo Marcas representam se a deteção do banco de dados de marcas do Bing está habilitada ou não. Se as marcas do Bing não estiverem habilitadas, o Azure AI Video Indexer detetará apenas marcas do modelo personalizado de Marcas da conta especificada.

Response

A resposta mostra se as marcas do Bing estão habilitadas seguindo o formato do exemplo abaixo.

{
  "state": true,
  "useBuiltIn": true
}

Nota

useBuiltIn ser definido como true representa que as marcas do Bing estão habilitadas. Se useBuiltin for falso, as marcas do Bing serão desativadas. O state valor pode ser ignorado porque foi preterido.

Atualizar configurações de modelo de marcas

A API de marcas de atualização atualiza as configurações do modelo Marcas na conta especificada. As configurações do modelo Marcas representam se a deteção do banco de dados de marcas do Bing está habilitada ou não. Se as marcas do Bing não estiverem habilitadas, o Azure AI Video Indexer detetará apenas marcas do modelo personalizado de Marcas da conta especificada.

O useBuiltIn sinalizador definido como true significa que as marcas do Bing estão habilitadas. Se useBuiltin for falso, as marcas do Bing serão desativadas.

Response

Não há conteúdo retornado quando a configuração do modelo Marcas é atualizada com êxito.