すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:ハイライトマッシュアップ

    ドキュメントセンター

    ApsaraVideo VOD:ハイライトマッシュアップ

    最終更新日:Jul 03, 2025

    このトピックでは、ハイライトマッシュアップのパラメーターについて説明します。

    重要

    • 関連操作を呼び出すときは、メディアアセットの OSS URL のリージョンが OpenAPI エンドポイントのリージョンと同じである必要があります。

    • サポートされているリージョン：中国 (上海)、中国 (北京)、中国 (杭州)、中国 (深セン)、米国 (シリコンバレー)、シンガポール。

    • 動画には字幕または人間の声のいずれかが含まれている必要があります。どちらも含まれていない素材はサポートされていません。

    • [your-bucket]、[your-region-id]、[your-file-name]、[your-file-path] などのドキュメント内のパラメーター例とメディア ID（例：「****9d46c8b4548681030f6e****」）は、実際の値に置き換えてください。

    関連 API

    • ハイライトマッシュアップジョブを送信するには、 SubmitScreenMediaHighlightsJob をご参照ください。主要なパラメーター (InputConfig、EditingConfig、および OutputConfig) のデータ構造については、以下のセクションで説明します。

    • バッチ動画制作ジョブの詳細を取得するには、 GetBatchMediaProducingJob をご参照ください。

    InputConfig

    InputConfig を構成して、動画、ナレーション、BGM、ステッカーなどの入力素材を設定します。

    パラメーター

    タイプ

    説明

    例

    必須

    MediaArray

    List<String>

    • 動画素材。メディア ID または OSS URL のリストを指定できます。動画の合計再生時間は最大 2 時間、動画の最大数は 20 です。

    • サポートされているファイル形式については、動画形式 をご参照ください。

    例

    はい

    HighlightStrategy

    HighlightStrategy

    ハイライトマッシュアップの方法。

    例

    いいえ

    OpeningArray

    List<Media>

    • 固定イントロクリップ。制作ごとに 1 つがランダムに選択されます。メディア ID または OSS URL のリストを指定できます。最大数は 20 です。

    • 画像と動画をアップロードできます。サポートされている形式については、動画形式 と 画像形式 をご参照ください。

    例

    いいえ

    EndingArray

    List<Media>

    • 固定アウトロクリップ。制作ごとに 1 つがランダムに選択されます。メディア ID または OSS URL のリストを指定できます。最大数は 20 です。

    • 画像と動画をアップロードできます。サポートされている形式については、動画形式 と 画像形式 をご参照ください。

    例

    いいえ

    TitleArray

    List<String>

    タイトル。制作ごとに 1 つがランダムに選択されます。最大 50 個のタイトルを指定でき、各タイトルは 50 文字以内です。

    ["ブレントウッドのコストコのグランドオープン","カリフォルニア州最大の コストコ"]

    いいえ

    SubHeadingArray

    List<SubHeading>

    字幕。最大 5 レベルの見出しを設定できます。

    例

    いいえ

    StickerArray

    List<Sticker>

    • ステッカー。制作ごとに 1 つが ランダムに選択 されます。最大 50 個のメディア ID または OSS URL を指定できます。

    • サポートされている形式については、画像形式 をご参照ください。

    例

    いいえ

    BackgroundMusicArray

    List<String>

    • BGM。制作ごとに 1 曲が ランダムに選択 されます。最大 50 個のメディア ID または OSS URL を指定できます。

    • サポートされている形式については、音声形式 をご参照ください。

    例

    いいえ

    BackgroundImageArray

    List<String>

    • 背景画像。制作ごとに 1 つの画像が ランダムに選択 されます。最大 50 個のメディア ID または OSS URL を指定できます。

    • サポートされている形式については、画像形式 をご参照ください。

    例

    いいえ

    説明

    ステッカー、BGM、および背景画像のランダム選択ルール:

    10 個の対応する素材を配列で提供し、出力ビデオの数を 20 に設定した場合、1 から 10 までの乱数が生成されます（たとえば、3）。このランダムに生成された番号から始めて、システムは各ビデオ出力に対して順番に素材を選択します。配列の最後に達すると、先頭（1）に戻り、シーケンスを続行します。

    HighlightStrategy

    パラメータ

    データ型

    説明

    例

    必須

    IntroConfig

    JSON

    Mode: ハイライトセクションのイントロを設定します

    • Auto: ハイライトセクションのイントロとして、最も印象的な部分を自動的に選択します。

    • Disabled: 追加のイントロは追加されません。

    デフォルト値：Disabled。

    {"Mode":"Disabled"}

    いいえ

    TargetDurationConfig

    TargetDurationConfig

    出力動画の予想再生時間。

    {"TargetDuration": 180, "SpeedRange": [0.95, 1]}

    いいえ

    PlotPacingType

    String

    ハイライトセクションのプロットペース。 デフォルト値：Normal。 有効値：

    • Slow

    • Normal

    • Fast

    Slow

    いいえ

    TargetDurationConfig

    パラメーター

    タイプ

    説明

    例

    必須

    TargetDuration

    Float

    • 固定イントロ、アウトロ、ハイライトイントロを除く、すべてのハイライトクリップの予想合計再生時間（秒単位）。実際の再生時間は、指定された値とわずかに異なる場合があります。指定しない場合、再生時間はプロットに基づいて自動的に調整されます。

    • 有効値：5 秒以上で、素材の合計再生時間以下。

    180

    いいえ

    SpeedRange

    List<String>

    動画の速度設定。

    出力動画を一定の速度で再生したい場合は、範囲の開始値と終了値を同じ値に設定します（例：[1.2, 1.2]）。これは、再生速度が 1.2 に固定されていることを意味します。

    出力動画の実際の再生時間を TargetDuration にできるだけ近づけたい場合は、許容できる速度範囲を設定します。効果の例：

    • TargetDuration が 10 で、SpeedRange が [0.95,1] であると仮定すると、速度調整前の許容再生時間は 10 ～ 10.526 秒です。最終出力再生時間の計算：

      • 元の出力再生時間が 10.5 秒の場合、許容範囲 [10,10.526] 内にあります。この場合、速度は 10/10.5 ≈ 0.9524 に設定されます。実際の出力再生時間は 10 秒です。

      • 元の出力再生時間が 11 秒で、許容範囲を超えている場合、速度は SpeedRange の下限である 0.95× に従って調整されます。したがって、実際の出力再生時間 = 11 秒 × 0.95 = 10.45 秒です。

    [0.95, 1]

    いいえ

    メディア

    パラメーター

    タイプ

    説明

    例

    必須

    MediaId

    String

    メディアアセットの ID です。

    ****b4549dfvc88681030f6e****

    MediaId または MediaURL のいずれかを指定する必要があります。

    両方が指定されている場合、MediaId が優先されます。

    MediaURL

    String

    メディアファイルへの OSS URL です。

    形式: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4

    例: http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4

    In

    Float

    動画素材の場合、このパラメーターは素材のインポイントを秒単位で指定します。

    0

    いいえ

    Out

    Float

    動画素材の場合、このパラメーターは素材のアウトポイントを秒単位で指定します。

    5

    いいえ

    Duration

    Float

    画像素材の場合、このパラメーターは画像の表示時間を秒単位で指定します。

    2

    いいえ

    DyncFrames

    Integer

    GIF素材の場合、このパラメーターはアニメーション画像のフレーム数を指定します。

    25

    いいえ

    例

    {
  "MediaArray": [
    "****9d46c8b42f4581030f6e****",
    "****9d46c8b4frtf81030f6e****",
    "****9d46c8b4asdf81030f6e****",
    "****9d46c8b43d3481030f6e****"
  ],
  "HighlightStrategy": {
    "IntroConfig": {
      "Mode": "Disabled"  // 無効
    }
  },
  "OpeningArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "EndingArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "TitleArray": [
    "Grand opening of Costco in Brentwood", // ブレントウッドのコストコのグランドオープン
    "Largest Costco in California" // カリフォルニア州最大の コストコ
  ],
  "SubHeadingArray": [
    {
      "Level": 1,
      "TitleArray": [
        "Subtitle 1", // サブタイトル 1
        "Subtitle 2" // サブタイトル 2
      ]
    },
    {
      "Level": 3,
      "TitleArray": [
        "Level 3 Subtitle" // レベル 3 サブタイトル
      ]
    }
  ],
  "StickerArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300,
      "Opacity": 0.6
    },
    {
      "MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png", // http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300
    }
  ],
  "BackgroundMusicArray": [
    "****b4549d46c88681030f6e****",
    "****549d46c88b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].mp3" // http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].mp3
  ],
  "BackgroundImageArray": [
    "****6c886b4549d481030f6e****",
    "****9d46c8548b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png" // http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png
  ]
}

    EditingConfig

    EditingConfig を構成して、マテリアル音量や位置など、ビデオ制作設定を指定します。

    パラメーター

    タイプ

    説明

    例

    必須

    MediaConfig

    JSON

    入力ビデオマテリアルの構成。

    例

    いいえ

    TitleConfig

    JSON

    タイトル構成。ここで字幕を設定できます。

    例

    いいえ

    SubHeadingConfig

    JSON

    複数レベルの見出し構成。ここで字幕を設定できます。

    JSON フィールド：

    例

    いいえ

    BackgroundMusicConfig

    JSON

    BGM 構成。

    例

    いいえ

    BackgroundImageConfig

    JSON

    背景画像の構成。このパラメーターは、InputConfig で背景画像が指定されていない場合にのみ有効になります。

    例

    いいえ

    ProcessConfig

    JSON

    ビデオ編集の構成。

    例

    FECanvas

    JSON

    プレビューレンダリング用のキャンバス構成。

    {"Width": 1080,"Height": 1920}

    いいえ

    ProduceConfig

    JSON

    標準のビデオ編集および制作構成。詳細については、「EditingProduceConfig」をご参照ください。

    {"AutoRegisterInputVodMedia":true,"OutputWebmTransparentChannel":true,"CoverConfig":{"StartTime":3.3},"AudioChannelCopy":"left","PipelineId":"xxxd54a97cff4108b555b01166d4bxxx","MaxBitrate":5000,"KeepOriginMaxBitrate":false,"KeepOriginVideoMaxFps":false}

    いいえ

    ProcessConfig

    パラメーター

    タイプ

    説明

    例

    必須

    AllowVfxEffect

    ブール値

    エフェクトを追加するかどうかを指定します。デフォルト値: false。

    true

    いいえ

    VfxEffectProbability

    Float

    各ビデオクリップにエフェクトを適用する確率。有効な値: 0.0～1.0。デフォルト値: 0.5。

    小数点以下 2 桁までサポートしています。

    0.6

    いいえ

    VfxFirstClipEffectList

    List<String>

    • 指定した場合、出力ビデオの最初のクリップのエフェクトは、指定された VfxFirstClipEffectList から選択されます。

    • 空のままにした場合、出力ビデオの最初のクリップのエフェクトは、次のエフェクトからランダムに選択されます: "slightshow", "starfieldshinee", "starfieldshinee2", "starsparkle", "colorfulripples", "starfield"。

    • エフェクトのプレビューについては、「エフェクト例」をご参照ください。

    ["slightshow","starfieldshinee"]

    いいえ

    VfxNotFirstClipEffectList

    List<String>

    • 指定した場合、出力ビデオの最初のクリップ以外のクリップのエフェクトは、指定された VfxNotFirstClipEffectList から選択されます。

    • 空のままにした場合、最初のクリップ以外のクリップのエフェクトは、次のエフェクトから選択されます: "zoomslight", "zoom", "zoominout", "slightshake"。

    • エフェクトのプレビューについては、「エフェクト例」をご参照ください。

    ["zoomslight","zoom"]

    いいえ

    AllowTransition

    ブール値

    トランジション効果を追加するかどうかを指定します。デフォルト値: false。

    true

    いいえ

    TransitionDuration

    Float

    トランジションの継続時間（秒）。トランジションの継続時間が（クリップの継続時間 - 1 秒）より長い場合、トランジション効果はそのクリップに適用されません。

    デフォルト値: 0.5 秒。

    0.5

    いいえ

    TransitionList

    List<String>

    カスタムトランジション効果リスト。AllowTransition が true に設定されている場合、リストからランダムなトランジション効果が選択されて制作に使用されます。使用可能なトランジション効果については、「トランジション効果の例」をご参照ください。

    空のままにした場合、次のトランジション効果からランダムに選択されます: "linearblur", "colordistance", "crosshatch", "dreamyzoom", "doomscreentransition_up"

    ["directional", "linearblur"]

    いいえ

    UseUniformTransition

    ブール値

    1 つの出力ビデオ全体で同じトランジション効果を使用するかどうかを指定します。

    デフォルト値: true。

    true

    いいえ

    AllowFilter

    ブール値

    カスタムフィルターを追加するかどうかを指定します。デフォルト値: false。

    false

    いいえ

    FilterList

    List<String>

    カスタムフィルター効果リスト。AllowFilter が true に設定されている場合、このリストからランダムなフィルターが選択されて制作に使用されます。使用可能なフィルターについては、「フィルター例」をご参照ください。空のままにした場合、フィルターは追加されません。

    ["m1", "m2"]

    いいえ

    例

    {
  "MediaConfig": {
    "Volume": 0 // デフォルトでは、ビデオマテリアルはミュートされています。
  },
  "TitleConfig": {
    "Alignment": "TopCenter",
    "AdaptMode": "AutoWrap",
    "Font": "Alibaba PuHuiTi 2.0 95 ExtraBold",
    "SizeRequestType": "Nominal",
    "Y": 0.1, // 出力ビデオが縦モードの場合のタイトルの Y 座標。
    "Y": 0.05, // 出力ビデオが横モードの場合のタイトルの Y 座標。
    "Y": 0.08 // 出力ビデオが正方形モードの場合のタイトルの Y 座標。
  },
   "SubHeadingConfig": {
    "1": {
      "Y": 0.3,
      "FontSize": 40
    },
    "3": {
      "Y": 0.5,
      "FontSize": 30
    }
  },
  "BackgroundMusicConfig": {
    "Volume": 0.2,   // デフォルトでは、BGM の音量は 20% です。
    "Style": null
  },
  "ProcessConfig": {
    "AllowVfxEffect": false,	  // エフェクトを追加するかどうかを指定します。
    "AllowTransition": false,	  // トランジションを追加するかどうかを指定します。
  }
}

    TemplateConfig

    TemplateConfig は、バッチ動画制作の共通パラメーターです。動画制作テンプレートを指定します。詳細なパラメーターと例については、「TemplateConfig」をご参照ください。

    OutputConfig

    OutputConfig を構成して、ストレージの場所、命名規則、サイズ、出力ビデオの数などの出力設定を指定します。

    パラメータ

    タイプ

    説明

    例

    必須

    MediaURL

    String

    OSS に出力ビデオを保存する場所。

    プレースホルダー {index} が必要です。

    形式: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4

    例: http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4

    GeneratePreviewOnly が false に設定されていて、出力が OSS に保存される場合は必須です。

    StorageLocation

    String

    ApsaraVideo VOD に出力ビデオを保存する場所。

    形式: [your-vod-bucket].oss-[your-region-id].aliyuncs.com

    例: outin-****6c886b4549d481030f6e****.oss-cn-shanghai.aliyuncs.com

    GeneratePreviewOnly が false に設定されていて、出力が VOD に保存される場合は必須です。

    FileName

    String

    出力ファイルの命名規則。

    プレースホルダー {index} が必要です。

    形式: [your-file-name]__{index}.mp4

    例: example_{index}.mp4

    GeneratePreviewOnly が false に設定されていて、出力が VOD に保存される場合は必須です。

    GeneratePreviewOnly

    ブール値

    • true に設定すると、現在のタスクは実際の制作を行わずにプレビュー用のタイムラインのみを生成します。出力ファイルの保存場所を指定する必要はありません。デフォルト値: false。

    • タスク完了後、GetBatchMediaProducingJob を呼び出してタスクの結果をクエリします。返されるサブタスクリストには、編集プロジェクト ID が含まれています。 GetEditingProject を呼び出して、プレビュータイムラインを取得できます。

    false

    いいえ

    Count

    Integer

    出力ビデオの数。現在のバージョンでは、1 つの出力のみをサポートしています。

    1

    いいえ

    Width

    Integer

    出力ビデオの幅 (ピクセル単位)。

    1080

    はい

    Height

    Integer

    出力ビデオの高さ (ピクセル単位)。

    1920

    はい

    Video

    JSONObject

    CRF やコーデックなど、出力ビデオのストリーム構成。

    {"Crf": 27}

    いいえ

    例

    {
 	"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name]_{index}.mp4", // 出力ファイルの URL
 	"Count": 1, // 出力ファイルの数
 	"Width": 1080, // 出力ビデオの幅
 	"Height": 1920, // 出力ビデオの高さ
 	"Video": {"Crf": 27}, // ビデオの設定
        "GeneratePreviewOnly":false // プレビューのみを生成するかどうか
}

    処理ロジック

    システムは、次のタスクを実行します。

    • MediaArrayEdit で指定されたビデオ素材を、配列に表示される順序で分析および処理します。

    • HighlightStrategy に基づいて、ハイライトセクションのイントロとアウトロを設定します。

    • OpeningArray と EndingArray に基づいて、ハイライトセクションの前後に固定イントロ（プレロール）とアウトロ（ポストロール）を設定します。

    • バッチビデオ制作 API を呼び出すときに設定されたパラメーターは、テンプレートで設定されたパラメーターよりも優先されます。TemplateConfig を設定している場合、システムはまず API 設定から空でないパラメーターを読み取ります。API 設定で空のままになっているパラメーターについては、システムはテンプレートの値を読み取ります。

    参考文献