全部產品
Search
文件中心

:TargetVideo

更新時間:Mar 24, 2026

名稱

類型

描述

樣本值

object

視頻處理參數配置。

DisableVideo

boolean

是否禁用視頻流產生,取值範圍如下:

  • true:禁用,輸出檔案中將不包含視頻流。

  • false(預設):不禁用。

false

Stream

array

需要處理的源檔案視頻流索引號列表。空值(預設)表示處理索引號最小的視頻流(第一路視頻流),索引號大於 100 表示處理所有視頻流。

  • 樣本:[0,1]處理索引號為 0 和 1 的視頻流;[1]處理索引號為 1 的視頻流;[101]處理所有視頻流。

說明

只處理索引號存在的視頻流,索引號對應的視頻流不存在時將忽略該索引號。

integer

需要處理的視頻流索引號。

0

TranscodeVideo

object

視頻轉碼參數,空值表示禁用視頻處理,輸出檔案中將不包含視頻流。

說明

不推薦通過將該參數設為空白值來禁用視頻處理。

Codec

string

視頻編碼格式。取值範圍如下:

  • API 為 CreateMediaConvert 時:copy(預設),h264,h265,vp9。
    警告 當該參數為 copy 時,表示將需要處理的視頻流直接拷貝到輸出檔案,此時 TranscodeVideo 下的其餘參數無效。copy 不可用於視頻拼接,通常應用於轉封裝情境。
  • API 為 GenerateVideoPlaylist 時:h264(預設),h265。

h264

PixelFormat

string

像素格式,預設與源視頻一致。取值範圍如下:

  • yuv420p

  • yuv422p

  • yuv444p

  • yuv420p10le

  • yuv422p10le

  • yuv444p10le

  • yuva420p

說明

yuva420p 僅在 API 為 CreateMediaConvert 時可用,且參數 Codec 必須為 vp9。

yuv420p

FrameRateOption

string

幀率選項。取值範圍如下:

  • fixed:始終使用設定的目標視訊框架率。

  • adaptive:源視訊框架率小於設定的目標視訊框架率時使用源視訊框架率。

  • fall:源視訊框架率小於設定的目標視訊框架率時返回失敗。

預設值:

  • 當 API 為 CreateMediaConvert 時,預設值為 fixed。

  • 當 API 為 GenerateVideoPlaylist 時,預設值為 adaptive。

說明

該參數需要與參數 FrameRate 一同設定。

fixed

FrameRate

number

視訊框架率,預設與源視頻一致。

25

ResolutionOption

string

解析度選項。取值範圍如下:

  • fixed:始終使用設定的目標視頻解析度。

  • adaptive:源視頻解析度面積小於設定的目標視頻解析度面積時使用源視頻解析度。

  • fall:源視頻解析度面積小於設定的目標視頻解析度面積時返回失敗。

預設值:

  • 當 API 為 CreateMediaConvert 時,預設值為 fixed。

  • 當 API 為 GenerateVideoPlaylist 時,預設值為 adaptive。

說明

該參數需要與參數 Resolution 一同設定。

fixed

Resolution

string

輸出視頻的解析度,格式為寬 x 高,預設與源視頻播放解析度一致。支援同時配置寬高或單獨配置寬或高,也可配合參數 AdaptiveResolutionDirection 同時配置長短邊或單獨配置長邊或短邊,單邊取值範圍為(0,4096]。

  • 樣本 1:若 AdaptiveResolutionDirection 為 false,1280x720表示設定寬為 1280,高為 720;1280x表示設定寬為 1280,高與源視頻一致;x720表示設定高為 720,寬與源視頻一致。

  • 樣本 2:若 AdaptiveResolutionDirection 為 true,1280x720表示設定長邊為 1280,短邊為 720;1280x表示設定長邊為 1280,短邊與源視頻一致;x720表示設定短邊為 720,長邊與源視頻一致。

說明

若源視頻存在旋轉資訊,寬高、長短邊的判斷以旋轉後的情況為準,即以播放解析度為準。

640x480

AdaptiveResolutionDirection

boolean

是否開啟長短邊自適應。取值範圍如下:

  • true(預設):是,此時參數 Resolution 的格式為長邊×短邊

  • false:否,此時參數 Resolution 的格式為寬×高

true

ScaleType

string

縮放模式。取值範圍如下:

  • stretch(預設):固定寬高或長短邊,強制縮放,展開以填滿空白部分。

  • crop:等比縮放,縮放為延伸出指定寬高或長短邊的矩形框外的最小解析度,然後將超出的部分進行置中裁剪。

  • fill:等比縮放,縮放為指定寬高或長短邊的矩形內的最大解析度,然後使用黑色置中填充空白部分。

  • fit:等比縮放,縮放為指定寬高或長短邊的矩形內的最大解析度。

說明

該參數需要與參數 Resolution 一同設定。

crop

Rotation

integer

視頻順時針旋轉的度數。取值範圍如下:

  • 0(預設)

  • 90

  • 180

  • 270

90

BitrateOption

string

視頻碼率選項。取值範圍如下:

  • fixed:始終使用設定的目標視頻碼率。

  • adaptive:源視頻碼率小於設定的目標視頻碼率時使用源視頻碼率。

  • fall:源視頻碼率小於設定的目標視頻碼率時返回失敗。

預設值:

  • API 為 CreateMediaConvert 時,預設值為 fixed。

  • API 為 GenerateVideoPlaylist 時,預設值為 adaptive。

說明

該參數需要與參數 Bitrate 一同設定。

fixed

Bitrate

integer

視頻流碼率,單位為位元每秒(bit/s),

說明

該參數與 CRF 互斥,若該參數與參數 CRF 都為空白值則按照參數 CRF 為 23 進行編碼。

128000

GOPSize

integer

主要畫面格間隔幀數,預設值為 150。

說明

API 為 GenerateVideoPlaylist 時不支援該參數。

60

CRF

number

指定恒定品質模式。與參數 Bitrate 互斥,取值範圍為[0,51],數值越大畫質越差,建議取值範圍為[18,38]。

18

BufferSize

integer

動態碼率下解碼緩衝大小,單位為位元每秒(bps)。

說明

該參數需要與參數 CRF 一起使用才有效。

4000000

MaxBitrate

integer

動態碼率下限定最大碼率。使用該參數時,必須指定參數 BufferSize。

說明

該參數需要與參數 CRF 一起使用才有效。

128000

BFrames

integer

連續 B 幀的數量,預設值為 3。

3

Refs

integer

參考幀的數量,預設值為 2。

2

VideoSlim

integer

啟用輕碼高清模式,設定值如下:

0:預設值,表示關閉。

1:表示使用輕碼高清模式轉碼。

說明

為獲得最佳效果,輕碼高清推薦使用官方推薦 Bitrate 或 CRF 參數進行視頻轉碼編碼。

重要 輕碼高清僅支援 h.264/h.265 格式,僅支援 yuv420p,8bit 位深,不支援多路目標視頻轉碼輸出以及視頻拼接。詳情參考輕碼高清產品介紹:https://www.alibabacloud.com/help/zh/imm/user-guide/video-slim

0

FilterVideo

object

視頻處理參數,參數 TranscodeVideo 為空白時或TranscodeVideo.Codec為 copy 時,本參數無效。

說明

API 為 GenerateVideoPlaylist 時不支援設定此參數。

Watermarks

array

視頻浮水印列表。

object

視頻浮水印資訊。

Type

string

浮水印類型。取值範圍如下:

  • text(預設):文字浮水印。

  • file:圖片或動圖浮水印。

text

Dx

number

取值為整數或小數時不同含義如下:

  • 0(預設):位移像素和水平位移量與輸出解析度高的比率都為 0。

  • 整數:表示位移像素,單位為像素(px),取值範圍為[1,4096]。

  • 小數:表示水平位移量與輸出解析度高的比率,取值範圍為(0,1)。

0

Dy

number

取值為整數或小數時的不同含義如下:

  • 0(預設):表示位移像素和垂直位移量與輸出解析度高的比率都為 0。

  • 整數:表示位移像素,單位為像素(px),取值範圍為[1,4096]。

  • 小數:表示垂直位移量與輸出解析度高的比率,取值範圍為(0,1)。

0

StartTime

number

添加浮水印的開始時間,單位為秒(s),預設從視頻起始時間開始。

0

Duration

number

添加浮水印持續的時間,單位為秒(s),預設值持續到視頻結束。

0

ReferPos

string

添加浮水印的基準位置。取值範圍如下:

  • topleft(預設):左上方

  • topright:右上方

  • bottomright:右下角

  • bottomleft:左下角

topleft

Content

string

文字浮水印的內容,預設值為空白。

重要 當參數Type取值為text時此參數生效。

example

FontName

string

文字浮水印的字型名稱。取值範圍如下:

  • SourceHanSans-Regular(預設)

  • SourceHanSans-Bold

  • SourceHanSerif-Regular

  • SourceHanSerif-Bold

重要 當參數Type取值為text時此參數生效。

SourceHanSans-Bold

FontSize

integer

文字浮水印的字型大小,預設值為 16。取值為整數,取值範圍為(4,120)。

重要 當參數Type取值為text時此參數生效。

18

FontColor

string

浮水印文字的字型顏色。格式為#RRGGBB,預設值為#000000。也支援輸入“red”、"green"等值。

重要 當參數Type取值為text時此參數生效。

red

FontApha

number

文字浮水印的字型透明度。取值範圍為(0,1],預設值為 1,表示完全不透明。

重要 當參數Type取值為text時此參數生效。

0.8

BorderWidth

integer

文字浮水印的描邊寬度,單位為像素(px)。取值只能為整數,取值範圍為[0,4096],預設值為 0。

重要 當參數Type取值為text時此參數生效。

2

BorderColor

string

浮水印文字的描邊顏色。格式為#RRGGBB,預設值為#000000。也支援輸入“red”、"green"等值。

重要 當參數Type取值為text時此參數生效。

red

URI

string

浮水印檔案的 OSS 地址,支援的格式為 PNG 和 MOV。

OSS 地址規則為oss://<bucket>/<object>,其中<bucket>為和當前專案處於同一地區的 OSS Bucket 名稱,<object>為包含副檔名的檔案完整路徑。

重要 當參數Type取值為file時此參數生效。

oss://test-bucket/watermark.jpg

Width

number

浮水印圖片的寬度,預設值為原浮水印圖片的寬度。取值為整數或小數時的不同含義如下:

  • 整數:表示去除 Logo 寬度的像素值,單位為像素(px),取值範圍為[1,4096]。

  • 小數:表示相對輸出視頻解析度寬度的比率,取值範圍為(0,1)。

80

Height

number

浮水印圖片的高度,預設值為原浮水印圖片的高度。取值為整數或小數時的不同含義如下:

  • 整數:表示去除 Logo 高度的像素值,單位為像素(px),取值範圍為[1,4096]。

  • 小數:表示相對輸出視頻解析度高度的比率,取值範圍為(0,1)。

40

Delogos

array

對視頻上某矩形部分進行模糊處理,用於去除 Logo、台標等。

object

視頻模糊處理參數。

StartTime

number

添加馬賽克的開始時間,單位為秒(s)。預設為從視頻起始時間開始。

0

Duration

number

添加馬賽克的期間,單位為秒(s),預設值持續到視頻結束。

15

Dx

number

取值為整數或小數時的不同含義如下:

  • 0(預設):位移像素和水平位移量與輸出解析度高的比率都為 0。

  • 整數:表示位移像素,單位為像素(px),取值範圍為[1,4096]。

  • 小數:表示水平位移量與輸出解析度高的比率,取值範圍為(0,1)。

0

Dy

number

預設值為 0。取值為整數或小數時的不同含義如下:

  • 0(預設):位移像素和垂直位移量與輸出解析度高的比率都為 0。

  • 整數:表示位移像素,單位為像素(px),取值範圍為[1,4096]。

  • 小數:表示垂直位移量與輸出解析度高的比率,取值範圍為(0,1)。

0

Width

number

馬賽克的寬度,預設值為小數型的 1.0,即佔滿輸出視頻寬度,取值為整數或小數時的不同含義如下:

  • 整數:像素值,單位為像素(px),取值範圍為[1,4096]。

  • 小數:表示相對輸出視頻解析度寬度的比率,取值範圍為(0,1)。

100

Height

number

馬賽克的高度,預設值為小數型的 1.0,即佔滿輸出視頻高度,取值為整數或小數時的不同含義如下:

  • 整數:像素值,單位為像素(px),取值範圍為[1,4096]。

  • 小數:表示相對輸出視頻解析度高度的比率,取值範圍為(0,1)。

40

ReferPos

string

添加馬賽克的基準位置。取值範圍如下:

  • topleft(預設):左上方

  • topright:右上方

  • bottomright:右下角

  • bottomleft:左下角

topleft

Speed

number

視頻倍速播放設定,取值範圍為[0.5,1.0],預設值為 1.0。

說明
  • 轉碼後媒體檔案與源媒體檔案預設播放速度的比值,非倍速轉碼。

重要
  • 僅適用於 CreateMediaConvertTask API。

1.0

Desensitization

object

視頻脫敏配置。

重要
  • 僅適用於 CreateMediaConvertTask API。

Face

object

人臉脫敏配置。

說明

公測中,如有任何使用問題,請加入DingTalk群進行反饋,DingTalk群號請參見聯絡我們

Confidence

number

人臉置信閾值,用於設定Face Service的信賴度下限。若識別到的人臉置信值小於該閾值,則不會對人臉進行脫敏。

  • 取值範圍:0.0 ~ 1.0。

  • 預設值:0.0(表示不進行信賴度過濾)。

0.4

MinSize

integer

最小人臉尺寸閾值,用於設定需要脫敏人臉的最小尺寸。若識別到的人臉寬度或高度小於該閾值,則不會對人臉進行脫敏。 單位為像素,預設值為 0,表示不對人臉尺寸進行限制。

0.4

LicensePlate

object

車牌脫敏配置。

說明

公測中,如有任何使用問題,請加入DingTalk群進行反饋,DingTalk群號請參見聯絡我們

Confidence

number

車牌置信閾值,用於設定車牌識別的信賴度下限。若識別到的車牌置信值小於該閾值,則不會對車牌進行脫敏。

  • 取值範圍:0.0 ~ 1.0。

  • 預設值:0.0(表示不進行信賴度過濾)。

0.4

MinSize

integer

最小車牌尺寸閾值,用於設定需要脫敏車牌的最小尺寸。若識別到的車牌寬度或高度小於該閾值,則不會對車牌進行脫敏。 單位為像素,預設值為 0,表示不對車牌尺寸進行限制。

0.4