Démarrage rapide : Utiliser l’API

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.

Azure AI Video Indexer consolide plusieurs technologies audio et vidéo d’intelligence artificielle (IA) proposées par Microsoft dans un seul service intégré, ce qui simplifie le développement. Azure AI Video Indexer est conçu pour permettre aux développeurs de se concentrer sur l’utilisation des technologies IA multimédias sans se soucier de la mise à l’échelle, de la portée mondiale, de la disponibilité et de la fiabilité des plateformes cloud. Vous pouvez utiliser l’API pour charger vos fichiers, obtenir des insights vidéo détaillés, obtenir des URL d’insights incorporés, des widgets de lecteur, etc.

Lorsque vous visitez le site web Azure AI Video Indexerpour la première fois, un compte d’essai est automatiquement créé pour vous. Avec le compte d’essai, vous obtenez un certain nombre de minutes d’indexation gratuite. Vous pourrez ajouter un compte payant par la suite. Avec l’option payante, vous payez pour les minutes d’indexation. Pour plus d’informations sur les comptes disponibles (options essai et payante), consultez Types de comptes Azure AI Video Indexer.

Cet article explique comment utiliser l’API Azure AI Video Indexer.

Prérequis

Chargez un fichier multimédia. Il existe deux manières :

1. Chargez un fichier multimédia dans l’URL de votre choix (recommandé). Vous pouvez utiliser un emplacement réseau public. Après avoir chargé le fichier, vous pouvez case activée si le fichier est accessible à AVI en le copiant et en le collant dans la barre d’emplacement de votre navigateur. Si vous pouvez lire le fichier multimédia, il est probable que VI puisse également y accéder. Si vous souhaitez sécuriser l’emplacement de stockage à l’aide de Stockage Azure Blob, chargez le fichier et obtenez une URL SAP. Pour plus d’informations sur l’obtention d’une URL sécurisée pour votre fichier, consultez Stockage Blob Azure URL SAS. Cette URL est utilisée pour copier votre fichier dans Azure AI Video Indexer pour l’indexation.

2. Envoyez le fichier vidéo à un tableau d’octets dans le corps de la requête. Pour plus d’informations sur le chargement d’un fichier multimédia en tant que tableau d’octets dans un corps de requête, consultez Charger un objet blob avec .NET.

Remarque

Les requêtes d’API sont limitées à 10 par seconde ou à 120 par minute.

S’abonner à l’API

Important

• Vous devez utiliser le même e-mail que celui que vous avez utilisé lorsque vous vous êtes inscrit à Azure AI Video Indexer.
• Les comptes Google et Microsoft (Outlook/Live) personnels ne peuvent être utilisés que pour les comptes d’évaluation. Les comptes connectés à Azure nécessitent l’ID Entra.
• Il ne peut y avoir qu’un seul compte actif par e-mail. Si un utilisateur tente de se connecter avec user@gmail.com pour LinkedIn et après avec user@gmail.com pour Google, ce dernier affiche une page d’erreur, indiquant que l’utilisateur existe déjà.
• Les clés doivent être protégées. Les clés doivent uniquement être utilisées par votre code serveur. Elles ne doivent pas être disponibles côté client (.js, .html, etc.).

1. Connectez-vous au portail des développeurs de l’API Azure AI Video Indexer.
2. Abonnez-vous en sélectionnant l’onglet Produits . Ensuite, sélectionnez Autorisation et abonnement. Les nouveaux utilisateurs sont automatiquement abonnés à l’API Autorisation.
3. Recherchez, copiez et enregistrez les clés primaires et secondaires. Vous trouverez votre abonnement dans votre profil. Les clés primaires et secondaires se trouvent dans la section Abonnements .
4. Sélectionnez le lien Afficher pour la clé primaire et la clé secondaire. Copiez et collez-les dans un éditeur de texte jusqu’à ce que vous soyez prêt à les utiliser dans votre fichier de variables d’environnement.

Obtenir un jeton d’accès à l’aide de l’API d’autorisation

Vous ne souhaitez pas accorder un accès complet à chaque utilisateur pour votre application. Il existe plusieurs niveaux d’accès pour VI.

Level	Afficher des vidéos	Traiter des vidéos	Afficher les projets	Traiter des projets	Afficher les comptes	Gérer les comptes
Lecteur vidéo	✔️
Contributeur vidéo	✔️	✔️
Lecteur de projet	✔️		✔️
Contributeur de projet	✔️	✔️	✔️	✔️
Lecteur de compte	✔️		✔️		✔️
Contributeur de compte	✔️	✔️	✔️	✔️	✔️	✔️

Créer et envoyer la demande de jeton d’accès

Définissez le subscription-id, le , resource-group-namele VI account-name dans la requête et définissez le scope corps de la demande et permissionType le paramètre dans le corps de la requête sur le niveau d’accès dont vous avez besoin.

Par exemple, si vous souhaitez fournir l’accès à un utilisateur afin qu’il puisse travailler avec des projets, mais ne peut pas fonctionner avec des comptes, définissez la permissionType valeur « Contributeur » et « scope Projet ». Si vous définissez des autorisations pour un projet, fournissez le projectId.

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"
}

Exemple de réponse

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

Pour plus d’exemples de définition des types d’étendue et d’autorisation, consultez l’API REST VI.

Commencer à utiliser votre API

Vous êtes prêt à commencer à utiliser l’API. Rechercher la description détaillée de chaque API REST Azure AI Video Indexer.

Pour obtenir un exemple détaillé d’utilisation des clés dans votre fichier de variable d’environnement et l’utilisation de jetons d’accès, consultez l’exemple Azure AI Video Indexer.

Recommandations

• Lorsque vous appelez l’API qui obtient des aperçus pour la vidéo spécifiée, vous obtenez une sortie JSON détaillée en tant que contenu de réponse. Pour plus d’informations sur la sortie JSON renvoyée, consultez cet article.
• La sortie JSON produite par l’API contient des éléments Insights et SummarizedInsights. Nous vous recommandons vivement d’utiliser Insights et de ne pas utiliser SummarizedInsights (qui est présent pour la compatibilité descendante).
• Nous vous déconseillons d’utiliser directement des données du dossier d’artefacts à des fins de production. Les artefacts sont des sorties intermédiaires du processus d’indexation et sont des sorties brutes des différents moteurs IA qui analysent les vidéos. Le schéma des artefacts peut changer au fil du temps.
• Utilisez l’API Get Video Index , comme décrit dans Obtenir des insights et des artefacts générés par l’API et nonget-Video-Artifact-Download-Url.