AI Metadata Optimizer

概要

Brightcove Metadata Optimizer

Brightcove AI Metadata Optimizer は、テキストトラック、オーディオ、ビジュアル分析を活用して、自動的に動画メタデータを生成します。これにより、コンテンツが見つけやすくなり、一貫性を保ちながら公開基準に準拠した状態を維持することができます。

Metadata Optimizer には、Video Cloud UI の 3 つの主要な操作画面からアクセスできます:

動画アップロード時
動画詳細ページ内
Media モジュールでの一括選択時

Metadata Optimizer の設定

高度なオプティマイザーの有効化

デフォルトでは、標準オプティマイザーはテキストトラックを使用してメタデータを提案します。高度オプティマイザーはオーディオとビジュアルの両方を分析し、より豊富なメタデータを生成します。

高度オプティマイザーをデフォルトで有効化する手順:

管理者メニューで カスタムフィールド → メタデータ生成 を選択します。
一般設定 で 高度なメタデータオプティマイザーを有効にする（視覚解析付き） をオンに切り替えます。
保存をクリックします。

このページでの追加設定

デフォルトのメタデータ言語

一般設定 内の デフォルトのメタデータ言語 ドロップダウンで、メタデータ生成に使用される言語を設定します。デフォルトは英語です。

生成されるメタデータ

生成されるメタデータ セクションでは、アップロード時または一括選択時にオプティマイザーが生成するメタデータフィールドを定義します。各フィールドのオン／オフを切り替え、文字数制限 を設定します:

名前
短い説明
タグ
長い説明

公開前に承認を必須にする場合は、公開前に生成されたメタデータを確認する チェックボックスを有効にします。有効化すると、すべての取り込み済み動画およびすべての一括メタデータオプティマイザー呼び出しのデフォルト動作になります。

タグルール

ルールと最適化 配下で新規をクリックして、カスタム タグルール を追加します。各ルールごとにタグを定義し、それが動画コンテンツとどのように関連するかを記述します。タグルールにより、生成されるメタデータを組織の分類体系に整合させます。

スタイルトレーニング用の参照サンプル

スタイルトレーニング用の参照サンプル セクションに、最大10件の動画 ID を入力します。オプティマイザーはこれらの高品質なサンプルを使用して、新たに生成されるメタデータのフォーマットやトーンを合わせます。

Metadata Optimizer の使用方法

取り込み時（Upload モジュール）

アップロードモジュールに移動し、メタデータを生成 を選択します。
（オプション）提案を事前に承認したい場合は、公開前にメタデータを確認 を選択します。
アップロードを完了します。メタデータは自動的に生成されます。

レビューが有効化されている場合:

メタデータが生成されたがレビューが必要な場合、Media モジュールのステータス列に黄色の注意アイコンが表示されます。
Media モジュールの動画詳細ページを開き、提案を承認するか追加提案をリクエストし、その後メタデータを公開用に承認します。

動画詳細ページから

Media モジュールに移動し、動画を選択します。
動画にテキストトラックがあることを確認します。ない場合は、自動キャプションを生成するかテキストトラックをアップロードするよう促されます。
概要タブで メタデータを生成 をクリックします。
メタデータを選択・編集します:
- 希望するオプションを選択します。
- 必要に応じて手動で編集します。
保存をクリックします。

多言語メタデータ

多言語メタデータが有効になっている場合、2つの方法でメタデータを設定できます:

一度生成し、その後翻訳

主要言語でメタデータを生成します。
その言語のみで保存するか、有効化されているすべての言語に翻訳を適用します。

言語ごとに生成

動画詳細ページで言語ビューを切り替えます。
メタデータを生成 をクリックし、各言語ごとに同じ手順を繰り返します。

一括メタデータ生成

Media モジュールで動画を選択します。
… → メタデータを生成 をクリックします。
公開前にレビューするか、レビューをスキップするかを選択します。

レビューが有効化されている場合:

メタデータが生成されたがレビューが必要な場合、Media モジュールのステータス列に黄色の注意アイコンが表示されます。
Media モジュールの各動画詳細ページを開き、提案を承認するか、追加提案をリクエストします。

API アクセス

AI メタデータ強化ジョブの作成/取得/削除

エンドポイント（スコープ video-cloud/video/read が必要）:

POST | GET | DELETE https://ingest.api.brightcove.com/v1/accounts/{account_id}/video/{video_id}/ai/metadata-enhancement/{language}

POST ペイロードフィールド

fields_to_generate: オプションの文字列リスト。対応可能: names, long_descriptions, short_descriptions, tags。空または省略時は 4 つすべてが生成されます。
skip_review: オプションのブール値。true の場合、最初に生成された提案が自動的に保存され、既存の値を上書きする可能性があります。提案されたタグは既存のタグに追加されます。多言語が有効な場合、レビューをスキップすると常に主要言語ビューに書き込まれます。
auto_translate: オプションのブール値。true の場合、生成されたメタデータが主要言語ビューに適用されたあと、translation_request（例: languages リスト）で定義した副次言語ビューへ、対象フィールドが自動翻訳され、1 回のリクエストでメタデータ生成と翻訳が完了します。true にできるのは skip_review も true のときのみです。それ以外の場合は省略するか false にしてください（無効な組み合わせは API で拒否されます）。
use_tag_architecture: オプションのブール値。true の場合、ユーザー定義のカスタムタグルールが適用されます（/v1/accounts/{account_id}/ai/metadata-enhancement/tags を参照）。
references: オプションの動画 ID リスト。スタイルの参考として使用されます。
character_limits: オプションのマッピング。names | long_descriptions | short_descriptions | tags をキーに最大文字数を数値で指定。
translation_request: オプションのオブジェクト（多言語アカウント向け）。主要言語以外のビューへメタデータを翻訳する対象ロケールを指定します。必要なのは languages のみです。BCP-47 の文字列配列（例: ["es-ES", "fr-FR"]）。この API では他のキーは使用されません。 注意: タグは翻訳されません。translation_request を指定し、かつ auto_translate: true でない場合、他のトップレベルの POST フィールドはすべて無視されます（翻訳のみのジョブ）。skip_review と auto_translate がどちらも true のときは、生成オプション（fields_to_generate など）と translation_request（多くの場合 languages のみ）を組み合わせられ、主要言語メタデータの生成・保存後に、指定したビューへ対象フィールドを 1 つのジョブで翻訳できます。

GET レスポンスフィールド

ジョブオブジェクトはメタデータ強化ジョブのモデルに一致します（値がないフィールドは返されません。オプションのフィールドは省略される場合があります）。

account_id: 文字列
video_id: 文字列
job_id: 文字列
language: 文字列
created_at: 文字列（例: 2025-09-18）
status: 文字列（processing | finished | failed）
error: オプションの文字列。ジョブが失敗した場合やエラー内容を示す場合に含まれます（例: status が failed のとき）
names: オプションの文字列のリスト（ジョブが結果を生成したときの提案または適用済みの値。多くの場合 status が finished のとき）
short_descriptions: オプションの文字列のリスト（同上）
long_descriptions: オプションの文字列のリスト（同上）
tags: オプションの文字列リストのリスト。例: [["tag1", "tag2", …]]（同上）
skip_review: オプションのブール値。含まれる場合、POST で skip_review により自動適用で作成されたジョブであることを示します
from_ingestion_job: オプションのブール値。true のとき、Dynamic Ingest のトランスクリプション要求に含まれた metadata_optimizer から作成されたジョブです

提案を破棄または適用するかに関わらず、結果が不要になったら DELETE を呼び出してください。"finished" ステータスは提案が準備され、ユーザーによるレビュー待ちであることを意味します。

POST で作成されたジョブが成功すると、DELETE で明示的に削除されるまで GET で取得可能です。同じ動画と言語で新しいジョブを作成すると、前のジョブのデータは GET において置き換えられます。

skip_review を指定して作成されたジョブについては、DELETE を呼び出す必要はありません。これらは finished または failed を返す GET の後、間もなく自動削除されます。

すべての AI メタデータ強化ジョブの一覧取得

GET https://ingest.api.brightcove.com/v1/accounts/{account_id}/ai/metadata-enhancement/jobs
        Scope: video-cloud/video/read
        Response: ジョブ オブジェクトのリスト（単一ジョブ GET と同じ形式）

AI メタデータ強化タグルールの取得/更新

GET | PUT https://ingest.api.brightcove.com/v1/accounts/{account_id}/ai/metadata-enhancement/tags
        スコープ、リクエスト、レスポンス形式は Autocaption Dictionary エンドポイント: /accounts/{account_id}/autocaption-dictionary と同じ

取り込み時に AI メタデータ強化をリクエスト

Ingest API に、新しいフィールドが既存リクエストへ追加されました:

POST /v1/accounts/{account_id}/videos/{video_id}/ingest-requests
        {
          "transcriptions": [
            {
              "srclang": "en-US",
              "label": "English",
              "kind": "captions",
              "status": "published",
              "metadata_optimizer": {
                "language": "en-US",
                "fields_to_generate": ["names", "short_descriptions", "tags", "long_descriptions"],
                "skip_review": false
              }
            }
          ]
        }

メタデータの生成・適用・翻訳を 1 回の取り込みで行う場合は、autodetect ではなく明示の srclang を使い、skip_review と auto_translate を true にし、languages のみの translation_request を追加します。トランスクリプトファイルの取り込み — 取り込み時の AI メタデータ強化を参照してください。

取り込みリクエストに metadata_optimizer を含めると、メタデータ強化ジョブが作成されます。これは同じ GET/DELETE ジョブエンドポイントで追跡または削除できます。skip_review: true の場合も同様の考慮が適用されます。

よくある質問（FAQ）

この機能の制限は何ですか？
標準オプティマイザーはテキストトラックのみを使用します。高度オプティマイザーはビジュアルも分析します。動画にキャプションがない場合は、自動生成が可能です（再トランスコードが必要な場合があります）。
どの言語がサポートされていますか？
Metadata Optimizer は 40 以上の言語をサポートしています。英語（米国、英国、オーストラリアなど）、スペイン語（スペイン、米国）、フランス語（フランス、カナダ）、ドイツ語、イタリア語、日本語、韓国語、中国語（簡体字・繁体字）など、多くの言語が含まれます。
メタデータの自動公開を防ぐことはできますか？
はい。レビューオプションを有効にすると、メタデータは適用前に承認が必要になります。
Universal Translator を使って Metadata Optimizer 用のテキストトラックを生成できますか？
はい。Metadata Optimizer は Brightcove Universal Translator、Brightcove Autocaptions、標準フォーマットに対応したサードパーティキャプションツールと連携して動作します。
サードパーティのキャプションは対応していますか？
はい、Brightcove 以外のキャプションにも対応しています。
さらに提案を表示するために「再生成」をクリックするとクレジットは消費されますか？
いいえ。クレジットはメタデータ作成をトリガーしたときにのみ消費されます。同じセッション内で再生成を使って追加の提案を取得しても、追加のクレジットは消費されません。