クイック スタート: API を使用する
重要
Azure Media Services の提供終了に伴う Azure Video Indexer コンテンツの移行期限が過ぎ去りました。 詳細については、 再登録ガイド を参照してください。
Azure AI Video Indexer は、Microsoft が提供するさまざまなオーディオおよびビデオの人工知能 (AI) テクノロジが 1 つに統合されたサービスです。このサービスを利用すると、開発がより簡単になります。 Azure AI Video Indexer は、クラウド プラットフォームの規模、グローバルなリーチ、可用性、信頼性を気にすることなく、開発者がメディア AI テクノロジの使用に集中できるように設計されています。 API を使用すると、ファイルのアップロード、詳細なビデオ分析情報の取得、埋め込み可能な分析情報の URL、プレイヤー ウィジェットなどを取得できます。
初めて Azure AI Video Indexer Web サイトにアクセスすると、試用版アカウントが自動的に作成されます。 試用版アカウントでは、一定分数の無料インデックス作成を利用できます。 後で有料アカウントを追加できます。 有料オプションでは、インデックス化された分数に対して支払います。 使用できるアカウント (試用版と有料オプション) の詳細については、「Azure AI Video Indexer アカウントの種類」を参照してください。
この記事では、 Azure AI Video Indexer API を使用する方法について説明します。
前提条件
メディア ファイルをアップロードします。 次の 2 つの方法があります。
メディア ファイルを好みの URL にアップロードします (推奨)。 パブリック ネットワークの場所を使用できます。 ファイルをアップロードした後、ファイルをコピーしてブラウザーの場所バーに貼り付けることで、AVI にアクセスできるかどうかを確認できます。 メディアファイルを再生できる場合は、VIもアクセスできる可能性があります。 Azure Storage BLOB を使用してストレージの場所をセキュリティで保護する場合は、ファイルをアップロードして SAS URL を取得します。 ファイルのセキュリティで保護された URL の取得の詳細については、「 Azure Blob Storage の SAS URLを参照してください。 この URL は、インデックス作成のためにファイルを Azure AI Video Indexer にコピーするために使用されます。
要求本文でビデオ ファイルにバイト配列を送信します。 要求本文でメディア ファイルをバイト配列としてアップロードする方法の詳細については、「 .NET を使用した BLOB のアップロードを参照してください。
Note
1 秒あたり 10 個の要求および 1 分あたり 120 個の要求という API 要求制限があります。
API にサブスクライブする
重要
- Azure AI Video Indexer にサインアップしたときに使用したのと同じ電子メールを使用する必要があります。
- 個人用の Google アカウントと Microsoft (Outlook/Live) アカウントは試用アカウントにのみ使用できます。 Azure に接続されているアカウントには Entra ID が必要です。
- 1 つのメール アドレスで有効にすることができるアカウントは 1 つのみです。 ユーザーが user@gmail.com を使用して LinkedIn にサインインし、後から user@gmail.com を使用して Google にサインインしようとすると、ユーザーは既に存在しているというエラー ページが表示されます。
- キーは保護する必要があります。 キーはサーバー コードでのみ使用してください。 クライアント側 (.js、.html など) では使用できないようにします。
- Azure AI Video Indexer API 開発者ポータルにサインイン。
- Products タブを選択してサブスクライブします。次に、Authorizationを選択してサブスクライブします。 新しいユーザーは自動的に Authorization にサブスクライブされます。
- プライマリ キーとセカンダリ キーを見つけてコピーして保存します。 サブスクリプションは、 Profile で確認できます。 プライマリ キーとセカンダリ キーは、 Subscriptions セクションにあります。
- 主キーとセカンダリ キーの両方の Show リンクを選択します。 環境変数ファイルで使用する準備ができるまで、テキスト エディターにコピーして貼り付けます。
Authorization API を使用してアクセス トークンを取得する
アプリケーションのすべてのユーザーにフル アクセス権を付与する必要はありません。 VIにはいくつかのレベルのアクセスがあります。
| Level | ビデオを表示する | ビデオを処理する | プロジェクトを表示する | プロジェクトの処理 | アカウントの表示 | 取引先企業を管理する |
|---|---|---|---|---|---|---|
| ビデオ リーダー | ✔️ | |||||
| ビデオ共同作成者 | ✔️ | ✔️ | ||||
| プロジェクト リーダー | ✔️ | ✔️ | ||||
| プロジェクト共同作成者 | ✔️ | ✔️ | ✔️ | ✔️ | ||
| アカウント閲覧者 | ✔️ | ✔️ | ✔️ | |||
| アカウント共同作成者 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
アクセス トークン要求を作成して送信する
要求の subscription-id、 resource-group-name、VI account-name を設定し、要求本文の scope および permissionType パラメーターを必要なアクセス レベルに設定します。
たとえば、ユーザーがプロジェクトを操作できるがアカウントを操作できないようにユーザーにアクセス権を付与する場合は、 permissionType を "共同作成者" に設定し、 scope を "Project" に設定します。プロジェクトのアクセス許可を設定する場合は、 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"
}
サンプル応答
{
"accessToken": "<jwt token of 1260 characters length>"
}
スコープとアクセス許可の種類の設定の詳細な例については、 VI REST APIを参照してください。
API を使い始める
これで、API の使用を開始する準備ができました。 各 Azure AI Video Indexer REST API の詳細な説明を参照してください。
環境変数ファイルでキーを使用し、アクセス トークンを使用する詳細な例については、Azure AI Video Indexer サンプルを参照してください。
推奨事項
- 指定されたビデオのビデオ分析情報を取得する API を呼び出すと、応答コンテンツとして詳細な JSON 出力を取得できます。 返される JSON の詳細については、こちらの記事を参照してください。
- API によって生成される JSON 出力には、
InsightsおよびSummarizedInsightsの要素が含まれています。Insightsを使用し、SummarizedInsights(後方互換対応のために存在) は使用しないことを強くお勧めします。 - 運用目的では、成果物フォルダーから直接データを使用することはお勧めしません。 アーティファクトは、インデックス作成プロセスの中間出力であり、ビデオを分析するさまざまな AI エンジンの生出力です。 成果物スキーマは、時間の経過と同時に変更される可能性があります。
- Get Video Index API と Get-Video-Artifact-Download-Url を使用します。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示