本文介紹參數詳情。

Input詳情

參數 類型 是否必選 描述
Bucket String 是 輸入檔案所在OSS Bucket。

需在控制台中資源控制頻道裡的Bucket授權頁面授予此Bucket讀許可權給ApsaraVideo for Media Processing服務，遵守OSS Bucket定義，見術語表Bucket。
Location String 是 輸入OSS Bucket所在資料中心（OSS Location）。

遵守OSS Location定義，見術語表Location。
Object String 是 輸入檔案 （OSS Object）。

須進行UrlEncode，使用UTF-8編碼，遵守OSS Object定義，見術語表Object。

Output詳情

參數 類型 是否必選 描述
OutputObject String 是 輸出的檔案名稱（OSS Object）。
  • 須進行Url Encode，使用UTF-8編碼。
  • 預留位置替換樣本：轉碼輸入檔案若為a/b/c.flv，若OutputObject設定為%7BObjectPrefix%7D%7BFileName%7Dtest.mp4，那麼轉碼輸出檔案名：a/b/ctest.mp4
  • 輸出檔案名支援預留位置替換規則。
    • 工作流程支援的預留位置：代表輸入檔案首碼的{ObjectPrefix}、代表輸入檔案名稱的{FileName}、代表輸入副檔名的{ExtName}、代錶轉碼輸出檔案Md5值 的{DestMd5}、代錶轉碼輸出檔案平均碼率的{DestAvgBitrate}，以及代表媒體工作流程執行執行個體ID的{RunId},代表工作流程所處理媒體ID的{MediaId}的動態替換。
    • 非工作流程支援的預留位置：{ObjectPrefix}、{FileName}、{ExtName}、{DestMd5}、{DestAvgBitrate}。
  • 關於副檔名規則：
    • 工作流程：根據轉碼模板容器格式自動在OutputObject後邊添加副檔名。
    • 非工作流程：不會自動添加副檔名，但如果容器類型為m3u8，則ApsaraVideo for Media Processing服務會給Playlist自動添加副檔名 .m3u8 ，分區檔案名稱會在Playlist後自動加一個從00001開始的5位
  • 序號為尾碼並以 - 號相連，副檔名為 .ts。
  • 例如：Playlist檔案名稱為filename.m3u8，則輸出第一個ts分區檔案為filename-00001.ts。
TemplateId String 是 轉碼模板ID。

支援自訂轉碼模板與系統預置模板。
WaterMarks WaterMark[] 否 JSON數組，浮水印列表，參見 轉碼浮水印參數詳情。
  • 浮水印數組大小上限為20，既同一路輸出最多支援20個浮水印。
  • 樣本：[{"InputFile":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"},"WaterMarkTemplateId":"88c6ca184c0e47098a5b665e2a126797"}]
Clip String 否 JSON對象，剪輯片段，參見 Clip詳情。

樣本：{"TimeSpan":{"Seek":"123.45","Duration":"3.45"}}
Rotate String 否 視頻旋轉角度。

範圍：[0，360)，順時針。
Container String 否 如設定則覆蓋指定轉碼模版中的對應參數，參見 Container詳情。
Video String 否 如設定則覆蓋指定轉碼模版中的對應參數，參見 Video詳情。
Audio String 否 如設定則覆蓋指定轉碼模版中的對應參數，參見Audio詳情。
AudioStreamMap String 否 音頻流序號。
  • 格式：0:a:{序號}，
  • 序號從0開始，
  • 序號的含義是音頻流列表的下標，
  • 樣本：0:a:0，
  • 若不設定，選擇預設的音頻流。
TransConfig String 否 轉碼流程配置。如設定則覆蓋指定轉碼模版中的對應參數，參見TransConfig詳情。
MergeList String 否 拼接設定。最多支援4個MergeURL，參見拼接參數詳情。
  • 單個拼接片段樣本：[{"MergeURL":"http://jvm.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4"}]
  • 2個拼接片段樣本：[{"MergeURL":"http://jvm.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://jvm.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}]
MergeConfigUrl String 否 MergeList與MergeConfigUrl兩個參數只支援二選一。
  • MergeConfigUrl指定的設定檔允許20個拼接片段上限，
  • MergeConfigUrl是拼接設定檔URL地址。
  • 樣本：http://jvm.oss-cn-hangzhou.aliyuncs.com/mergeConfigfile
  • 只支援存放在OSS上的設定檔，且需要保證有授權給MPS可存取權限，檔案內部內容參見拼接參數詳情。
  • mergeConfigfile檔案內部內容樣本：{"MergeList":[{"MergeURL":"http://jvm.oss-cn-hangzhou.aliyuncs.com/tail_comm.mp4"}]}
MuxConfig String 否 如設定則覆蓋指定轉碼模版中的對應參數，參見MuxConfig詳情。
Priority String 否 任務在其對應管道內的轉碼優先順序。
  • 範圍：[1-10]，
  • 最高優先順序：10
  • 預設值：6
UserData String 否 使用者自訂資料，最大長度1024個位元組。
M3U8NonStandardSupport String 否 M3u8非標準支援，JSON對象，參見 M3u8非標參數詳情。樣本:{"TS":{"Md5Support":true,"SizeSupport":true}}
Encryption String 否 資料加密，只支援m3u8格式的輸出
  • 樣本：{"Type":"hls-aes-128","Key":"ZW5jcnlwdGlvbmtleTEyMw","KeyType":"Base64","KeyUri":"aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ=="}
  • 參見Encryption參數詳情
SubtitleConfig String 否 JSON對象，字幕配置。
  • 參見SubtitleConfig詳情。
  • 樣本：{“ExtSubtitleList”:[{“Input”:{“Bucket”:”example-bucket”,“Location”:”oss-cn-hangzhou”,“Object”:”example.srt”},“CharEnc”:”UTF-8”}]}
OpeningList String 否 開板列表。JSON列表。。
  • 參見開板詳情。
  • 樣本：[{"OpenUrl":"http://test-bucket.oss-cn-hangzhou.aliyuncs.com/opening.flv","Start":"1","Width":"1920","Height":"1080"}]
TailSlateList String 否 尾板列表，JSON列表
  • 參見尾板詳情。
  • 樣本:[{"TailUrl":"http://test-bucket.oss-cn-hangzhou.aliyuncs.com/tail.flv","Start":"1","BlendDuration":"2","Width":"1920","Height":"1080","IsMergeAudio":false,"BgColor":"White"}]
DeWatermark String 否 模糊處理，JSON對象。參見模糊處理詳情。

Clip詳情

參數 類型 是否必選 描述
TimeSpan String 否 剪輯時間區間。

參見TimeSpan詳情。
ConfigToClipFirstPart Boolean 否 是否剪輯第一片，
  • false：拼接完後剪輯，預設
  • true：先剪輯第一片後拼接

TimeSpan詳情

參數 類型 是否必選 描述
Seek String 否 開始時間點。
  • 格式：hh:mm:ss[.SSS]，
  • 取值範圍 ：[00:00:00.000,23:59:59.999]

或者，

  • 格式：sssss[.SSS]，
  • 取值範圍［0.000，86399.999］

樣本：01:59:59.999或者32000.23
Duration String 否 持續時間長度。
  • 格式：hh:mm:ss[.SSS]，
  • 取值範圍 ：[00:00:00.000,23:59:59.999] ，

或者

  • 格式：sssss[.SSS]，
  • 取值範圍［0.000，86399.999］；

樣本：01:00:59.999或者32000.23
End String 否 截尾時間長度，表示切掉尾部的若干時間長度。

設定此值時，參數Duration失效。

  • 格式：hh:mm:ss[.SSS]
  • 取值範圍：[00:00:00.000，23:59:59.999]

或者

  • 格式：sssss[.SSS]，
  • 取值範圍［0.000，86399.999］；

樣本：01:00:59.999或者32000.23

轉碼浮水印參數詳情

參數 類型 是否必選 描述
WaterMarkTemplateId String 否 浮水印模板ID。
若不設定，則使用浮水印模板的預設配置：
  • 浮水印位置TopRight，
  • 位移量Dx、Dy取0，
  • 浮水印寬為輸出解析度寬的0.12倍，
  • 浮水印高為相對浮水印寬的等比縮放。
InputFile String 是 浮水印輸入檔案。
  • 參見InputFile詳情，
  • 目前支援png圖片、mov檔案作為輸入。
Width String 否 若設定，則此值覆蓋浮水印模板對應浮水印圖片寬，值有兩種形式：
  • 整數型代浮水印圖片寬的像素值，
    • 範圍：[8，4096]
    • 單位：px
  • 小數型代表相對輸出視頻解析度寬的比率，
    • 範圍：(0,1)，
    • 支援4位小數，如0.9999，超出部分系統自動丟棄。
Height String 否 若設定，則此值覆蓋浮水印模板對應浮水印圖片高，值有兩種形式：
  • 整數型代表浮水印圖片高的像素值，
    • 範圍：[8，4096]，
    • 單位：px；
  • 小數型代表相對輸出視頻解析度高的比率，
    • 範圍：(0，1)，
    • 支援4位小數，如0.9999，超出部分系統自動丟棄。
Dx String 否 若設定，則此值覆蓋浮水印模板對應參數，浮水印圖片相對輸出視頻的水平位移量。

預設值：0

值有兩種形式：
  • 整數型代表位移像素，
    • 範圍：[8，4096]，
    • 單位：px，
  • 小數型代表水平位移量與輸出解析度寬的比率，
    • 範圍：(0，1)，
    • 支援4位小數，如0.9999，超出部分系統自動丟棄。
Dy String 否 若設定，則此值覆蓋浮水印模板對應參數，浮水印圖片相對輸出視頻的垂直位移量。

預設值：0

值有兩種形式：
  • 整數型代表位移像素，
    • 範圍：[8，4096]，
    • 單位：px，
  • 小數型代表垂直位移量與輸出解析度高的比率，
    • 範圍：(0，1)，
    • 支援4位小數，如0.9999，超出部分系統自動丟棄。
ReferPos String 否 若設定，則此值覆蓋浮水印模板對應參數，浮水印的位置。

值範圍：TopRight、TopLeft、BottomRight、BottomLeft。
Type String 否 若設定，則此值覆蓋浮水印模板對應參數。浮水印類型，Image、Text。
  • Image：圖片浮水印，
  • Text：文字浮水印，
  • 預設值：Image
说明 若填寫Text，則必須填寫TextWaterMark欄位。
Timeline String 否 若設定，則此值覆蓋浮水印模板對應參數，動態浮水印。

參見Timeline詳情。
TextWaterMark String 否 JSON對象，文字浮水印配置，若類型為文字浮水印，則此配置項不可為空。
  • 參見文字浮水印參數詳情。
  • 樣本：{“Content”:”5rWL6K+V5paH5a2X5rC05Y2w”,”Top”:2,”Left”:10}

浮水印模板配置詳情

參數 類型 是否必選 描述
Width String 否 輸出視頻上浮水印圖片寬。

值有兩種形式：

  • 整數型代浮水印圖片寬的像素值，
    • 範圍：[8,4096]，
    • 單位：px；
  • 小數型代表相對輸出視頻解析度寬的比率，
    • 範圍：(0，1)，
    • 支援4位小數，如0.9999，超出部分系統自動丟棄。
Height String 否 輸出視頻上浮水印圖片高，值有兩種形式：
  • 整數型代浮水印圖片高的像素值，
    • 範圍：[8,4096]，單位：px；
  • 小數型代表相對輸出視頻解析度高的比率，
    • 範圍：(0，1)，
    • 支援4位小數，如0.9999，超出部分系統自動丟棄。
Dx String 否 浮水印圖片相對輸出視頻的水平位移量。

預設值：0

值有兩種形式：
  • 整數型代表位移像素，
    • 範圍：[8，4096]，
    • 單位：px；
  • 小數型代表水平位移量與輸出解析度寬的比率，
    • 範圍：(0，1)，
    • 支援4位小數，如0.9999，超出部分系統自動丟棄。
Dy String 否 浮水印圖片相對輸出視頻的垂直位移量。

預設值：0

值有兩種形式：
  • 整數型代表位移像素，
    • 範圍[8，4096]，
    • 單位：px；
  • 小數型代表垂直位移量與輸出解析度高的比率，
    • 範圍：(0，1)，
    • 支援4位小數，如0.9999，超出部分系統自動丟棄。
ReferPos String 否 浮水印的位置。
  • TopRight、TopLeft、BottomRight、BottomLeft
  • 預設值：TopRight
Type String 否 浮水印類型，Image、Text。
  • 預設值：Image
  • 模板暫只支援Image類型。
Timeline String 否 動態浮水印。

參見Timeline詳情。

浮水印寬、高參數設定說明：

  • 寬、高都不設定時，浮水印寬取輸出視頻解析度寬的0.12倍，浮水印高按浮水印原圖寬高比例等比縮放；
  • 寬或高設定一邊，另一邊不設定時，則另一邊按浮水印原圖寬高比等比縮放；
  • 寬、高兩邊都設時，按實際設定值設定浮水印圖片。
浮水印位置座標說明：

Container詳情

參數 類型 是否必選 描述
Format String 否 容器格式。
  • 預設值：mp4
  • 視頻轉碼支援flv、mp4、HLS（m3u8+ts）、MPEG-DASH（MPD+fMP4）
  • 音頻轉碼支援mp3、mp4、ogg、flac、m4a
  • 圖片支援gif、WEBP
  • 容器格式為gif時，Video Codec設定只能設定為GIF，
  • 容器格式為webp時，Video Codec設定只能設定為WEBP，
  • 容器格式為flv時，Video Codec不能設定為H.265。

Video詳情

參數 類型 是否必選 含義 描述
Codec String 否 編解碼格式 支援H.264、H.265、GIF、WEBP。

預設值：H.264
Profile String 否 編碼層級 支援baseline、main、high

預設值：high

  • baseline：適合行動裝置，
  • main：適合標準解析度裝置，
  • high：適合高解析度裝置。

最佳實務：如果您有多個清晰度，建議最低清晰度配成baseline，以保證最低端裝置可播放。其他清晰度配置為main或high。

说明 目前僅H.264支援此參數。
Bitrate String 否 視頻輸出檔案的碼率
  • 值範圍：[10，50000]
  • 單位：Kbps
Crf String 否 碼率-品質控制因子
  • 值範圍：[0，51]
  • 預設值：26
说明 如果設定了Crf，則Bitrate的設定失效。
Width String 否 寬
  • 預設值：視頻原始寬度
  • 值範圍：[128，4096]
  • 單位：px
Height String 否 高
  • 預設值：視頻原始高度
  • 值範圍：[128，4096]
  • 單位：px
Fps String 否 幀率
  • 預設值：取輸入檔案幀率。
  • 當輸入檔案幀率超過60時取60,。
  • 值範圍：(0,60]
  • 單位：fps
Gop String 否 主要畫面格間最大時間間隔或者最大幀數 最大時間間隔時，必傳單位s。
  • 預設值：10s
  • 最大幀數時，無單位，
  • 值範圍：[1,100000]
Preset String 否 視頻演算法器預置 支援veryfast、fast、medium、slow、slower。

預設值：medium

说明 目前僅H.264支援此參數。
ScanMode String 否 掃描模式 支援interlaced、progressive。
Bufsize String 否 緩衝區大小
  • 值範圍：[1000，128000]
  • 預設值：6000
  • 單位：Kb
Maxrate String 否 視頻碼率峰值 值範圍[10，50000]，單位Kbps。
PixFmt String 否 視頻顏色格式 範圍yuv420p，yuvj420p等標準顏色格式。

預設值：yuv420p或原始顏色格式。
Remove String 否 是否刪除視頻流
  • true表示刪除，
  • false表示保留，
  • 預設值：false
Crop String 否 視頻畫面裁切 支援2種方式。
  • 自動檢測黑邊並裁切，設定為“border”
  • 自訂裁切，參數格式：width:height:left:top。

    樣本：1280:800:0:140
Pad String 否 視頻貼黑邊 參數格式：width:height:left:top。

樣本：1280:800:0:140
LongShortMode String 否 是否開啟橫豎屏自適應（即：長短邊模式）
  • 轉碼輸出的寬對應輸入片源的長邊（豎屏為片源的高），
  • 高對應輸入視頻的短邊（豎屏為片源的寬），
  • true表示開啟，
  • false表示關閉，

預設值：false
以下表格顯示視頻轉碼編解碼格式與容器格式的組合支援情況：
Container Audio Codecs Video Codecs
flv AAC、MP3 H.264
mp4 AAC、MP3 H.264、H.265
ts AAC、MP3 H.264、H.265
m3u8 AAC、MP3 H.264、H.265
gif 不支援 GIF
以下表格顯示視頻編解碼格式與視頻流配置參數的組合支援情況：
Video/Codec H.264 H.265 GIF
Profile Y N N
Bitrate Y Y N
Crf Y Y N
Width Y Y Y
Height Y Y Y
Fps Y Y Y
Gop Y Y N
Preset Y N N
ScanMode Y Y Y
Bufsize Y Y N
Maxrate Y Y N
PixFmt Y Y bgr8

Audio詳情

參數 類型 是否必選 描述
Codec String 否 音頻編解碼格式，AAC、MP3、VORBIS、FLAC。

預設值：AAC

Profile String 否 音頻編碼預置。

當Codec為 AAC時，範圍aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。
Samplerate String 否 採樣率。
  • 預設值：44100
  • 支援22050、32000、44100、48000、96000，
  • 單位：Hz
说明
  • 若視頻容器格式為flv，音頻編解碼格式選擇為mp3時，採樣率不支援32000、48000、96000；
  • 音頻編解碼格式為mp3時，採樣率不支援96000。
Bitrate String 否 輸出檔案的音頻碼率。
  • 值範圍：[8，1000]，
  • 單位：Kbps
  • 預設值：128
Channels String 否 聲道數。

預設值：2

说明
  • 當Codec設定為 mp3 時，聲道數只支援1、2；
當Codec設定為 aac 時，聲道數只支援1、2、4、5、6、8。
Remove String 否 是否刪除音頻流。
  • true表示刪除，
  • false表示保留，
  • 預設值：false
以下表格顯示音頻轉碼編解碼格式與容器格式的組合支援情況：
Container Audio Codecs
mp3 MP3
mp4 AAC
ogg VORBIS、FLAC
flac FLAC

SnapshotConfig參數詳情

參數 類型 是否必選 描述
Format String 否 截圖資料類型。
  • 預設值：空
  • 可指定vtt表示輸出webvtt。
OutputFile String 是 輸出檔案定義，JSON對象。

參見截圖OutputFile詳情。
TileOutputFile String 否 輸出檔案定義，JSON對象，結構同OutputFile。
  • 截圖輸出檔案格式為jpg，若使用非同步模式序列拼圖且Num不等於1，則TileOutputFile的Object必須包含{TileCount}，用於區分序列截圖多張輸出圖片的輸出地址，如序列截圖輸出3張圖片，TileOutputFile的Object為{TileCount}.jpg，則輸出圖片Object依次為00001.jpg，00002.jpg，00003.jpg。
  • 此參數在拼圖配置必填，TileOutputFile代表最終拼成的大圖地址。
Time String 是 截圖時間。

單位：毫秒
Interval String 否 截圖間隔時間。
  • 若指定則表示非同步模式序列截圖，Interval必須大於等於0。
  • 預設值：10
  • 單位：秒
  • 其中Interval=0表示根據視頻時間長度平均截圖。
Num String 否 截圖數量。

若指定則表示非同步模式序列截圖，且必須大於0。

  • 當Time＋Interval＊Num的截取點超過視頻時間長度時，後續截圖自動失效，截圖完成時返回實際截取的個數，
  • 當Num=1，忽略Interval參數，表示非同步單張截圖。
Width String 否 截圖輸出圖片寬度。
  • 單位：px
  • 範圍：[8，4096]
Height String 否 截圖輸出圖片高度。
  • 單位：px
  • 範圍：[8，4096]
FrameType String 否 截圖類型。
  • 普通幀：normal
  • I幀：intra
預設值：intra
TileOut String 否 拼圖配置。JSON對象。

參見TileOut拼圖配置詳情。
SubOut String 否 Webvtt拼圖配置，JSON對象。

參見SubOut拼圖配置。

Segment詳情

參數 類型 是否必選 描述
Duration String 否 分區時間長度。
  • 整數值
  • 單位：秒
  • 範圍：[1，60]
ForceSegTime String 否 指定分區時間列表，逗號分隔，最多可指定10個分區時間點。
  • 整數值
  • 單位：秒
  • 樣本：23、55、60 代表在23，55，60秒處分區

TransConfig詳情

參數 類型 是否必選 描述
TransMode String 否 轉碼模式。
  • 預設值：onepass
  • 可選範圍onepass、twopass、CBR。
AdjDarMethod String 否 解析度改寫方式。
  • 預設值：none
  • 可選範圍rescale、crop、pad、none。
IsCheckReso String 否 是否檢查解析度。
  • 如果輸出解析度大於輸入解析度（判斷條件是寬或高），則輸出解析度等於輸入解析度。true表示檢查，
  • false表示不檢查，
  • 預設值：false
IsCheckResoFail String 否 是否檢查解析度。
  • 如果輸出解析度大於輸入解析度（判斷條件是寬或高），則返迴轉碼失敗。
  • true表示檢查，
  • false表示不檢查，
  • 預設值：false
IsCheckVideoBitrate String 否 是否檢查視頻碼率。
  • 如果視頻輸出碼率大於視頻輸入碼率，則視頻輸出碼率等於視頻輸入碼率。
  • true表示檢查，
  • false表示不檢查，
  • 預設值：false
IsCheckAudioBitrate String 否 是否檢查音頻碼率。
  • 如果音訊輸出碼率大於音頻輸入碼率，則音訊輸出碼率等於音頻輸入碼率。
  • true表示檢查，
  • false表示不檢查，
  • 預設值：false
isCheckAudioBitrateFail String 否 當輸出音頻碼率大於媒體源音頻碼率時，
  • true表示不進行轉碼，
  • false表示不檢查，
  • 預設值：false，
  • 此值優先順序大於IsCheckAudioBitrate。
isCheckVideoBitrateFail String 否 當輸出視頻碼率大於媒體源視頻碼率時，
  • true表示不進行轉碼，
  • false表示不檢查，
  • 預設值：false，
  • 此值優先順序大於IsCheckVideoBitrate。
AdjDarMethod參數位置說明：

MuxConfig詳情

參數 類型 是否必選 描述
Segment String 否 JSON對象，切片配置欄位。
  • 參見Segment詳情。
  • 樣本：{"Duration":"34"}

NotifyConfig詳情

參數 類型 是否必選 描述
QueueName String 否 阿里雲Message Service中建立的隊列。
  • ApsaraVideo for Media Processing服務支援在管道上綁定隊列，則該管道上的作業執行結束時會將執行結果發送到該隊列；
  • 擷取隊列中的訊息參見 隊列訊息作業；
  • 管道上設定隊列時，請您在 Message Service 中預先建立隊列。
Topic String 否 阿里雲Message Service中建立的主題。
  • ApsaraVideo for Media Processing服務支援在管道上綁定主題，則該管道上的作業執行結束時會將執行結果發送到該主題；
  • 主題會將執行結果以訊息形式推送到訂閱的地址上；
  • 訊息管道上設定主題時，請預先在 Message Service 中預先建立主題。
说明 該功能目前公測中。

轉碼作業輸入詳情

參數 類型 是否必選 描述
Bucket String 是 輸入檔案所在OSS Bucket。
  • 需在控制台中資源控制頻道裡的Bucket授權頁面授予此Bucket讀許可權給ApsaraVideo for Media Processing服務。
  • 遵守OSS Bucket定義，見術語表Bucket。
Location String 是 輸入OSS Bucket所在資料中心（OSS Location）。

遵守OSS Location定義，見術語表Location。
Object String 是 輸入檔案 （OSS Object）。
  • 須進行UrlEncode，使用UTF-8編碼，
  • 遵守OSS Object定義，見術語表Object。
Audio String 否 源媒體檔案的音頻配置，JSON對象。
说明 當輸入檔案為ADPCM、PCM格式時此參數為必填項。
  • 參見InputAudio詳情，
  • 樣本：{"Channels":"2","Samplerate":"44100"}
Container String 否 源媒體檔案容器配置，JSON對象。
说明 當輸入檔案為ADPCM、PCM格式時此參數為必填項。
  • 參見InputContainer詳情。
  • 樣本：{"Format":"u8"}

InputContainer詳情

參數 類型 是否必選 描述
Format String 是 源媒體音頻格式。

取值：alaw、f32be、f32le、f64be、f64le、mulaw、 s16be, s16le, s24be、s24le、s32be、s32le、s8、u16be、u16le、 u24be、u24le、u32be、u32le、u8

InputAudio詳情

參數 類型 是否必選 描述
Channels String 是 源媒體音頻聲道數。

範圍：[1，8]
Samplerate String 是 源媒體音頻採樣率。
  • 範圍：(0，320000]，
  • 單位：Hz

AnalysisConfig詳情

參數 類型 是否必選 描述
QualityControl String 否 輸出品質控制，JSON對象。

參見 QualityControl詳情
PropertiesControl String 否 屬性控制，JSON對象。

參見PropertiesControl詳情

QualityControl詳情

參數 類型 是否必選 描述
RateQuality String 否 輸出品質等級。
  • 值範圍：(0，51]，
  • 值為整數，
  • 預設值：25
MethodStreaming String 否 播放方式，network或local。

預設值：network

PropertiesControl詳情

參數 類型 是否必選 描述
Deinterlace String 否 強制掃描模式判定。
  • Auto：自動，
  • Force：強製做deinterlace，
  • None：強制不做。
Crop String 否 視頻裁切配置。
  • 預設：自動
  • 如此值不是空JOSN{}，則它的屬性Mode必填。
  • 參見Crop詳情。

Crop詳情

參數 類型 是否必選 描述
Mode String 否 取值：
  • Auto：自動，
  • Force：強制，
  • None：強制不做，

如Crop不是空JOSN{}，則此值必填。
Width Integer 否 裁切後寬。
  • 範圍：[8，4096]
  • 如MODE為Auto、None，此值失效。
Height Integer 否 裁切後高。
  • 範圍：[8，4096]
  • 如MODE為Auto、None，此值失效。
Top Integer 否 裁切上邊距。
  • 範圍：[8，4096]
  • 如MODE為Auto、None，此值失效。
Left Integer 否 裁切左邊距。
  • 範圍：[8，4096]
  • 如MODE為Auto、None，此值失效。

TransFeatures詳情

參數 類型 是否必選 描述
MergeList String 否 視頻拼接配置欄位。
  • JSON數組，最多支援4個MergeURL。
  • 參見拼接參數詳情。
  • 樣本：[{“MergeURL”:”http://example-bucket.oss-cn-hangzhou.aliyuncs.com/k/mp4.mp4"},{"MergeURL":"http://example-bucket.oss-cn-hangzhou.aliyuncs.com/c/ts.ts","Start":"1:14","Duration":"29"}]

拼接參數詳情

參數 類型 是否必選 描述
MergeURL String 是 拼接片段地址。
Start String 否 起始時間點。
  • 格式：hh:mm:ss[.SSS]或者sssss[.SSS]，
  • 樣本：01:59:59.999或者32000.23
Duration String 否 期間。
  • 格式：hh:mm:ss[.SSS]或者sssss[.SSS]，
  • 樣本：01:59:59.999或者32000.23

作業輸出檔案詳情

參數 類型 是否必選 描述
URL String 否 輸入檔案的OSS URL。
  • 如http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example.flv
  • 若不指定URL，則Bucket、Location、Object必填。
Bucket String 否
  • 若不制定URL，則此值必填；
  • 否則，此值失效，輸出檔案所在OSS Bucket，需在控制台中資源控制頻道裡的Bucket授權頁面授予此Bucket寫入權限給ApsaraVideo for Media Processing服務。
  • 遵守OSS Bucket定義，見術語表Bucket。
Location String 否
  • 若不制定URL，則此值必填；
  • 否則，此值失效，輸出OSS Bucket所在資料中心（OSS Location）。
  • 遵守OSS Location定義，見術語表Location
Object String 否
  • 若不制定URL，則此值必填；
  • 否則，此值失效，輸出檔案 （OSS Object）須進行UrlEncode，使用UTF-8編碼。
  • 遵守OSS Object定義，見術語表Object。

M3u8非標準參數支援詳情

參數 類型 是否必選 描述
TS String 否 JSON對象，TS檔案相關非標準支援。

參見TS參數支援詳情。

TS參數支援詳情

參數 類型 是否必選 描述
Md5Support Boolean 否 是否支援在m3u8檔案中輸出ts的md5值。
SizeSupport Boolean 否 是否支援在m3u8檔案中輸出ts檔案的大小。

Timeline參數詳情

參數 類型 是否必選 描述
Start String 否 浮水印開始出現時間。
  • 單位：秒，
  • 取值範圍：數字，
  • 預設值：0
Duration String 否 浮水印期間。
  • 取值範圍：[數字，ToEND]
  • 預設值：ToEND

Encryption參數詳情

參數 類型 是否必選 描述
Type String 是 取值：hls-aes-128
Key String 是 加密視頻的密鑰。
  • 需加密，方式見KeyType。
  • 如密鑰為”encryptionkey128”, 則Base64(“encryptionkey128”)， 或 KMS(Base64(“encryptionkey128”)
KeyUri String 是 密鑰的訪問url，使用BASE64進行編碼。
KeyType String 是 密鑰Key不能明文傳輸給MPS，需要加密，方式為 Base64 或 KMS 如使用KMS。
说明 請您聯絡我們，我們提供主要金鑰，Base64為基礎加密方式，KMS方式是在基礎方式上，又使用KMS進行加密。

SubtitleConfig詳情

參數 類型 是否必選 描述
ExtSubtitleList ExtSubtitle[] 否 JSON數組，最多4個，外部字幕列表。
  • 參見ExtSubtitle。
  • 樣本：[{“Input”:{“Bucket”:”example-bucket”,“Location”:”oss-cn-hangzhou”,“Object”:”example.srt”},“CharEnc”:”UTF-8”}]

ExtSubtitle詳情

參數 類型 是否必選 描述
Input String 是 JSON對象，外部輸入字幕檔案。
  • 目前支援srt、ass格式，
  • 參見 Input詳情，
  • 樣本：{“Bucket”:”example-bucket”,“Location”:”oss-cn-hangzhou”,“Object”:”example.srt”}
说明
  • 目前支援{ObjectPrefix}、{FileName}、{ExtName}動態替換。
  • 樣本：轉碼輸入檔案Object：a/b/c/test.flv，
  • 字幕檔案用動態規則可表示為：{ObjectPrefix}{FileName}-cn.srt，需經URLEncode，Object設定為：%7bObjectPrefix%7d%7bFileName%7d-cn.srt。那麼MPS會認為外掛字幕檔案地址為：a/b/c/test-cn.srt
CharEnc String 否 外部字幕字元編碼。
  • 範圍：UTF-8、GBK、BIG5、auto，
  • 預設：auto，
说明 外部字幕字元編碼設定為auto時，存在誤檢情況，建議您指定具體的字元編碼。

Opening詳情

參數 類型 是否必選 描述
OpenUrl String 是 開板視頻的OSS URL地址。
Start String 否 相對正片視頻的開始時間。
  • 從0開始延遲多長時間後，顯示開板視頻。
  • 單位：秒，
  • 預設值：0
Width String 否 寬。
  • 範圍：（0，4096）
  • -1、full
    • -1代表片源的值，
    • full表示填滿畫面。
  • 預設為：-1
Height String 否 高。
  • 範圍：（0，4096）
  • -1、full,
    • -1代表片源的值，
    • full表示填滿畫面。
  • 預設為：-1

TailSlate詳情

參數 類型 是否必選 描述
TailUrl String 是 尾板視頻的OSS URL地址
BlendDuration String 否 正片視頻和尾板視訊轉換的時間長度。過渡的效果是淡入淡出：正片顯示最後一幀，同時播放尾板視頻，正片最後一幀逐步變暗，尾板視頻逐步變亮。單位秒，預設0。
Width String 否 寬，範圍（0，4096）、-1、full,-1代表片源的值，full表示填滿畫面。預設為-1
Height String 否 高，範圍（0，4096）、-1、full,-1代表片源的值，full表示填滿畫面。預設為-1
IsMergeAudio Boolean 否 是否要拼接尾板視頻的音頻內容，預設為true
BgColor String 否 如果尾板視頻的寬、高小於正片時，設定空白處填充的背景色。預設為White，取值見bgcolor

文字浮水印參數詳情

參數 類型 是否必選 描述
Content String 是 文字浮水印內容，內容需做Base64編碼。

樣本：若想添加文字浮水印“測試文字浮水印”，那麼Content的值為：5rWL6K+V5paH5a2X5rC05Y2w
FontName String 否 預設：“SimSun”。

參見 支援的字型
FontSize Int 否 字型大小。
  • 預設值：16
  • 範圍：(4, 120)
FontColor String 否 字型顏色。

取值參見FontColor
FontAlpha Int 否 字型透明度。
  • 範圍：(0, 1]，
  • 預設：1.0
Top Int 否 文本上邊距。
  • 預設：0
  • 範圍：[0,4096]
Left Int 否 文本左邊距。
  • 預設：0
  • 範圍：[0,4096]
BorderWidth Int 否 描邊寬度。
  • 預設：0
  • 範圍：[0,4096]
BorderColor String 否 描邊顏色。

截圖OutputFile詳情

參數 類型 是否必選 描述
Bucket String 是 截圖輸出檔案所在OSS Bucket。

遵守OSS Bucket定義，見術語表Bucket。
Location String 是 截圖輸出OSS Bucket所在資料中心（OSS Location）。

遵守OSS Location定義，見術語表Location。
Object String 是 截圖輸出檔案 （OSS Object）。
  • 截圖輸出檔案格式為jpg，輸出檔案名須進行UrlEncode，使用UTF-8編碼。
預留位置替換樣本：截圖輸入檔案若為a/b/c.flv，若Object設定為%7BObjectPrefix%7D%7BFileName%7D%7BCount%7D.jpg，那麼批量截圖輸出檔案名：a/b/c00001.jpg，a/b/c00002.jpg…
截圖輸出檔案名支援預留位置替換
  • 工作流程支援的預留位置：代表輸入檔案首碼的{ObjectPrefix}、代表輸入檔案名稱的{FileName}、代表輸入副檔名的{ExtName}、代表截圖時間點的{SnapshotTime}、代表批量截圖第幾張的{Count}、以及代表媒體工作流程執行執行個體ID的{RunId}、代表工作流程所處理媒體ID的{MediaId}的動態替換。
  • 非工作流程支援的預留位置：代表輸入檔案首碼的{ObjectPrefix}、代表輸入檔案名稱的{FileName}、代表輸入副檔名的{ExtName}、代表截圖時間點的{SnapshotTime}、代表批量截圖第幾張的{Count}

批量截圖說明：若使用非同步模式序列截圖且Num不等於1，則OutputFile的Object必須包含%7BCount%7D，用於區分序列截圖多張輸出圖片的輸出地址，如序列截圖輸出3張圖片，OutputFile的Object為%7BCount%7D.jpg，則輸出圖片Object依次為00001.jpg，00002.jpg，00003.jpg。

TileOut拼圖配置詳情

參數 類型 是否必選 描述
Lines String 否 圖片拼合行數。
  • 整型，
  • 取值範圍：(0，10000]，
  • 預設：10
Columns String 否 圖片拼合列數。
  • 整型，
  • 取值範圍：(0，10000]，
  • 預設：10
CellWidth String 否 單圖片寬度。

預設截圖輸出解析度寬度。
CellHeight String 否 單圖片高度。

預設截圖輸出解析度高度。
Margin String 否 外框寬度。
  • 預設：0
  • 單位：px
Padding String 否 圖片間距，預設0，單位px
Color String 否 背景顏色。
  • 取值範圍：顏色關鍵字，random，
  • 預設：black，
  • 其中顏色關鍵字支援三種格式，比如黑色，支援Black，black，#000000
IsKeepCellPic String 否 是否保留單圖片。
  • 取值範圍：true、false，
  • 預設：true

MultiBitrateVideoStream詳情

參數 類型 是否必選 描述
URI String 否 視頻流輸出名稱，必須以.m3u8結尾，樣本：a/b/test.m3u8，格式：^[a-z]{1}[a-z0-9./-]+$

ExtXMedia詳情

參數 類型 是否必選 描述
Name String 是 必填項，描述，對應於HLS V5協議的NAME,最多64位元組，UTF-8。
Language String 否 可選項，語言類型，RFC5646，對應於HLS V5協議LANGUAGE。
URI String 是 必填，資源路徑。

樣本：a/b/c/d/audio-1.m3u8，格式：^[a-z]{1}[a-z0-9./-]+$

MasterPlayList詳情

參數 類型 是否必選 描述
MultiBitrateVideoStreams JsonArray 是 多碼流數組。
  • 參見MultiBitrateVideoStream詳情
樣本：[{“RefActivityName”: “video-1”,”ExtXStreamInfo”: {“BandWidth”: “111110”,”Audio”: “auds”,”Subtitles”: “subs” }}]

MultiBitrateVideoStream詳情

參數 類型 是否必選 描述
RefActivityName String 是 關聯的活動名稱
ExtXStreamInfo Json 是 碼流屬性。
  • 參見ExtXStreamInfo詳情。
  • 樣本：{“BandWidth”: “111110”,”Audio”: “auds”,”Subtitles”: “subs” }

ExtXStreamInfo詳情

參數 類型 是否必選 描述
BandWidth String 是 頻寬。

總碼率上限，必填項，對應於HLS V5協議的BANDWIDTH。
Audio String 否 音頻流分組ID。

可選，對應於HLS V5協議的AUDIO。
Subtitles String 否 字幕流分組ID。

可選，對應於HLS V5協議的SUBTITLES。

SubOut Webvtt拼圖配置詳情

參數 類型 是否必選 描述
IsSptFrag String 否 圖片是否拼合輸出。
  • true表示拼合輸出，
  • 預設：false

模糊處理詳情

JSON對象： 
"0": [
        {
            "L": 10,
            "T": 10,
            "W": 10,
            "H": 10
        },
        {
            "L": 100,
            "T": 0.1,
            "W": 10,
            "H": 10
        }
    ],
    "128000": [],
    "250000": [
        {
            "L": 0.2,
            "T": 0.1,
            "W": 0.01,
            "H": 0.05
        }
    ]
}
pts：字元，指對象幀的時間戳記。單位：毫秒（ms）。
  • L：數字，指模糊處理地區的左邊距。
  • T：數字，指模糊處理地區的上邊距。
  • W：數字，指模糊處理地區的寬度。
  • H：數字，指模糊處理地區的高度。

當T、L、W、H的值大於 1 時，表示絕對像素值。否則，表示相對片源解析度的比例值。無論是比例值還是絕對值，都會在最終處理時進行截整處理。

以上demo中，三個pts（0，128000，250000）對應的描述資訊為：
  • 0ms開始，對距離視頻畫面左上方10✖️10像素處，大小為10✖️10像素的Logo，以及距離左邊距100像素，上邊距0.1✖️(src_height)的位置10✖️10的Logo進行模糊處理。
  • 128000ms處，表示停止對Logo進行模糊處理，即，[0~128000]為對Logo進行模糊處理的時間段。
  • 250000ms開始，在左邊距0.2✖️(src_width)、上邊距0.1✖️(src_height)處，對大小為寬0.01✖️(src_width)，高0.05✖️(src_height)的Logo進行模糊處理。

AdaptationSet詳情

參數 類型 是否必選 描述
Group String 是 必填，組名，如dash檔案中的 
<AdaptationSet group="videostreams" mimeType="video/mp4" par="4096:1744"
              minBandwidth="258157" maxBandwidth="10285391" minWidth="426" maxWidth="4096"
              minHeight="180" maxHeight="1744" segmentAlignment="true"
              startWithSAP="1">
Lang String 否 語言。

音頻和字幕活動時，可填。

Representation詳情

參數 類型 是否必選 描述
Id String 是 必填，流ID，如dash檔案中的 
<Representation id="240p250kbps" frameRate="24" bandwidth="258157"
              codecs="avc1.4d400d" width="426" height="180">
URI String 是 必填，資源路徑。

樣本：a/b/c/d/video-1.mpd，格式：^[a-z]{1}[a-z0-9./-]+$

InputConfig詳情

參數 類型 是否必選 描述
Format String 是 必填，字幕檔案的輸入格式。

支援 stl、ttml、vtt
InputFile String 是 
{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"}
              或
              {"URL":"http://bucketname.oss-cn-hangzhou.aliyuncs.com/subtitle/test.chs.vtt"}