Partilhar via

Guia de início rápido: usar a API

  • Artigo

O Azure AI Video Indexer consolida várias tecnologias de inteligência artificial (IA) de áudio e vídeo oferecidas pela Microsoft em um serviço integrado, tornando o desenvolvimento mais simples. O Azure AI Video Indexer foi projetado para permitir que os desenvolvedores se concentrem no uso de tecnologias de IA de mídia sem se preocupar com escala, alcance global, disponibilidade e confiabilidade de plataformas de nuvem. Você pode usar a API para carregar seus arquivos, obter informações detalhadas de vídeo, obter URLs de insights incorporáveis, widgets de player e muito mais.

Quando você visita o site do Azure AI Video Indexer pela primeira vez, uma conta de avaliação é criada automaticamente para você. Com a conta de avaliação, você recebe alguns minutos de indexação gratuitos. Mais tarde, pode adicionar uma conta paga. Com a opção paga, você paga por minutos indexados. Para obter detalhes sobre as contas disponíveis (opções de avaliação e pagas), consulte Tipos de conta do Azure AI Video Indexer.

Este artigo mostra como usar a API do Azure AI Video Indexer.

Pré-requisitos

Carregue um arquivo de mídia. Existem duas formas:

  1. Carregue um ficheiro multimédia para o URL da sua escolha (recomendado). Você pode usar um local de rede pública. Depois de carregar o arquivo, você pode verificar se o arquivo está acessível ao AVI copiando-o e colando-o na barra de localização do navegador. Se você pode reproduzir o arquivo de mídia, então é provável que o VI também possa acessá-lo. Se você quiser proteger o local de armazenamento usando o Blob de Armazenamento do Azure, carregue o arquivo e obtenha uma URL SAS. Para obter mais informações sobre como obter uma URL segura para seu arquivo, consulte URLs SAS do Armazenamento de Blob do Azure. Essa URL é usada para copiar seu arquivo para o Azure AI Video Indexer para indexação.

  2. Envie ao arquivo de vídeo uma matriz de bytes no corpo da solicitação. Para obter mais informações sobre como carregar um arquivo de mídia como uma matriz de bytes em um corpo de solicitação, consulte Carregar um blob com .NET.

Nota

Há um limite de solicitações de API de 10 solicitações por segundo e até 120 solicitações por minuto.

Subscrever a API

Importante

  • Você deve usar o mesmo email usado quando se inscreveu no Azure AI Video Indexer.
  • As contas pessoais do Google e da Microsoft (Outlook/Live) só podem ser usadas para contas de avaliação. As contas conectadas ao Azure exigem o Entra ID.
  • Só pode haver uma conta ativa por e-mail. Se um usuário tentar fazer login com user@gmail.com para o LinkedIn e, posteriormente, com user@gmail.com o Google, este último exibirá uma página de erro, informando que o usuário já existe.
  • As chaves devem ser protegidas. As chaves só devem ser utilizadas pelo seu código do servidor. Eles não devem estar disponíveis no lado do cliente (.js, .html e assim por diante).
  1. Entre no portal do desenvolvedor da API do Azure AI Video Indexer.
  2. Inscreva-se selecionando a guia Produtos. Em seguida, selecione Autorização e inscreva-se. Os utilizadores novos estão automaticamente subscritos em Autorização.
  3. Encontre, copie e salve as chaves primária e secundária. Pode encontrar a sua subscrição no seu Perfil. As chaves primária e secundária estão na seção Assinaturas .
  4. Selecione o link Mostrar para a chave primária e a chave secundária. Copie-os e cole-os em um editor de texto até estar pronto para usá-los em seu arquivo de variáveis de ambiente.

Obter um token de acesso usando a API de autorização

Você não quer dar acesso total a todos os usuários do seu aplicativo. Existem vários níveis de acesso para VI.

Level Ver vídeos Processar vídeos Ver projetos Processar projetos Ver contas Gerir contas
Leitor de vídeo ✔️
Colaborador de vídeo ✔️ ✔️
Leitor de Projetos ✔️ ✔️
Colaborador do Projeto ✔️ ✔️ ✔️ ✔️
Leitor de Conta ✔️ ✔️ ✔️
Contribuidor de Conta ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Criar e enviar a solicitação de token de acesso

Defina o subscription-id, o resource-group-name, o VI account-name na solicitação e defina o scope parâmetro e permissionType no corpo da solicitação para o nível de acesso necessário.

Por exemplo, se você quiser fornecer acesso a um usuário para que ele possa trabalhar com projetos, mas não possa trabalhar com contas, defina como permissionType "Colaborador" e " scope Projeto". SE definir permissões para um projeto, forneça o projectIdarquivo .


POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.VideoIndexer/accounts/{account-name}/generateAccessToken?api-version=2024-01-01

{
  "permissionType": "Reader",
  "scope": "Project",
  "projectId": "07ec9e38d4"
}

Resposta da amostra

{
  "accessToken": "<jwt token of 1260 characters length>"
}

Para obter mais exemplos de como definir o escopo e os tipos de permissão, consulte a API REST VI.

Comece a utilizar a API

Você está pronto para começar a usar a API. Encontre a descrição detalhada de cada API REST do Azure AI Video Indexer.

Para obter um exemplo detalhado de como usar as chaves em seu arquivo de variável de ambiente e usar tokens de acesso, consulte o exemplo do Azure AI Video Indexer.

Recomendações

  • Quando chama a API que obtém informações de vídeo para o vídeo especificado, obtém uma saída JSON detalhada como conteúdo de resposta.
  • A saída JSON produzida pela API contém Insights elementos e SummarizedInsights . É altamente recomendável usar Insights e não usar SummarizedInsights (o que está presente para compatibilidade com versões anteriores).
  • Não recomendamos que você use dados diretamente da pasta de artefatos para fins de produção. Os artefatos são saídas intermediárias do processo de indexação e são saídas brutas dos vários mecanismos de IA que analisam os vídeos. O esquema de artefatos pode mudar ao longo do tempo.
  • Use a API Get Video Index e não Get-Video-Artifact-Download-Url.