全部產品
Search

搜尋本產品

    ApsaraVideo VOD：圖片疊加

    文件中心

    ApsaraVideo VOD：圖片疊加

    更新時間：Jan 29, 2026

    本文為您介紹通過OpenAPI進行視訊剪輯時圖片疊加情境的Timeline常用配置樣本，包括全程疊加圖片、指定地區疊加圖片等樣本。

    相關API

    參數說明

    參數

    說明

    圖片出現的座標

    • X：圖片左上方距離輸出視頻左上方的橫向距離。

    • Y：圖片左上方距離輸出視頻左上方的縱向距離。

    支持度百分比和像素兩種形式：

    • 當取值範圍是0～0.9999時，表示相對輸出視頻寬/高的佔比（X相對寬，Y相對高）。

    • 當取值為≥8的整數時，表示絕對像素。

    圖片在輸出視頻中所佔的大小

    • Width：圖片在輸出視頻中的寬度。

    • Height：圖片在輸出視頻中的高度。

    支持度百分比和像素兩種形式：

    • 當取值範圍是0～0.9999時，表示相對輸出視頻寬/高的佔比（Width相對寬，Height相對高）。

    • 當取值為≥8的整數時，表示絕對像素。

    圖片在輸出視頻疊加的時間區間

    • TimelineIn：圖片相對於時間軸的入點。

    • TimelineOut：圖片相對於時間軸的出點。

    Timeline樣本

    全程疊加圖片

    全程疊加圖片指從標題到片尾疊加圖片，即視頻全程疊加圖片不需要指定TimelineIn和TimelineOut。圖片在輸出視頻中出現的位置由X和Y設定，在輸出視頻中的寬高由Width和Height設定。樣本如下：

    • 單視頻疊加

      {
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                  "MediaId": "222d9296e8864746a0b6f32dad6e****"
              }
          ]
      }
  ],
  "ImageTracks": [
      {
          "ImageTrackClips": [
              {
                  "ImageId": "001d9296e8864746a0b6f32dad6e****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.1234,
                  "Y": 0.1234
              },
              {
                  "ImageId": "002d9296e8864746a0b6f32dad6e****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.7234,
                  "Y": 0.7234
              }
          ]
      }
  ]
}

    • 多視頻疊加

      {
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                  "MediaId": "222d9296e8864746a0b6f32dad6e****"
              },
              {
                  "MediaId": "333d9296e8864746a0b6f32dad6e****"
              }
          ]
      }
  ],
  "ImageTracks": [
      {
          "ImageTrackClips": [
              {
                  "ImageId": "001d9296e8864746a0b6f32dad6e****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.1234,
                  "Y": 0.1234
              },
              {
                  "ImageId": "002d9296e8864746a0b6f32dad6e****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.7234,
                  "Y": 0.7234
              }
          ]
      }
  ]
}

    指定地區疊加圖片

    指定地區疊加圖片指圖片疊加在視頻的指定時間區間。圖片在輸出視頻中出現的位置由X和Y設定，在輸出視頻中的寬高由Width和Height設定。在一個視頻的第2秒~100秒疊加2張圖片，樣本如下：

    說明

    輸出視頻指最終合成的成片視頻。

    • 單視頻疊加

      • 當TimelineIn不設定時，預設從0開始。

      • 當TimelineOut不設定時，預設到視頻的尾部。

      • 當TimelineOut超過視頻尾部（對單視頻來說，即視頻時間長度）時，超過的時間區間自動被忽略，仍以視頻軌的尾部為準。

      {
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                  "MediaId": "222d9296e8864746a0b6f32dad6e****"
              }
          ]
      }
  ],
  "ImageTracks": [
      {
          "ImageTrackClips": [
              {
                  "ImageId": "001d9296e8864746a0b6f32dad6e****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.1234,
                  "Y": 0.1234,
                  "TimelineIn":2,
                  "TimelineOut":100
              },
              {
                  "ImageId": "002d9296e8864746a0b6f32dad6e****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.7234,
                  "Y": 0.7234,
                  "TimelineIn":2,
                  "TimelineOut":100
              }
          ]
      }
  ]
}

    • 多視頻疊加圖片

      • 當TimelineIn不設定時，預設從0開始。

      • 當TimelineOut不設定時，預設到視頻的尾部。

      • 當TimelineOut超過視頻尾部（對多個視頻來說，即視頻軌總體時間長度）時，超過的時間區間，視頻畫面為黑場。

      如果視頻軌有多個不同解析度的源視頻，那麼：

      • 輸出視頻的寬取多個源視頻寬的最大值。

      • 輸出視頻的高取多個源視頻高的最大值。

      • 畫面採用pad+scale的方式，先加黑邊保證實際畫面比例不變形，再等比例放大到輸出視頻的寬高。

      • 輸出視頻的時間長度為視頻軌的時間長度。

      {
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                  "MediaId": "222d9296e8864746a0b6f32dad6e****"
              },
              {
                  "MediaId": "333d9296e8864746a0b6f32dad6e****"
              }
          ]
      }
  ],
  "ImageTracks": [
      {
          "ImageTrackClips": [
              {
                  "ImageId": "001d9296e8864746a0b6f32dad6e****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.1234,
                  "Y": 0.1234,
                  "TimelineIn":2,
                  "TimelineOut":100
              },
              {
                  "ImageId": "002d9296e8864746a0b6f32dad6e****",
                  "Width": 0.1345,
                  "Height": 0.1678,
                  "X": 0.7234,
                  "Y": 0.7234,
                  "TimelineIn":2,
                  "TimelineOut":100
              }
          ]
      }
  ]
}