全部產品
Search
文件中心

Intelligent Media Services:SubmitTranscodeJob - 提交轉碼任務

更新時間:Apr 28, 2026

使用者可以調用SubmitTranscodeJob介面,指定需要轉碼的源檔案、輸出格式以及相關參數,並提交視頻或音頻檔案的轉碼任務到智能媒體服務。

介面說明

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:SubmitTranscodeJob

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

Name

string

任務名字。

job-name

InputGroup

array<object>

任務輸入組。單個輸入為轉碼任務。多個輸入為音視頻合流任務。

job-name

object

任務輸入。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議。

說明

URL 中的 OSS bucket 需要先添加到 IMS 儲存管理後再使用。

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

InputUrl

string

輸入資料流路徑:

  • 僅當 type 為 Media 是才生效,讓使用者可以選擇該媒資下的特定檔案作為輸入。

  • 系統會檢查該媒資下是否存在這個 inputUrl。

oss://bucket/path/to/video.mp4

OutputGroup

array<object>

任務輸出組。

user-data

array<object>

任務輸出。

Output

object

輸出媒體配置。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議。

說明

URL 中的 OSS bucket 需要先添加到 IMS 儲存管理後再使用。

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

OutputUrl

string

輸出資料流路徑:
僅當 Type 為 Media 時才生效,讓使用者可以選擇該媒資下特定檔案作為輸出。
支援的預留位置:

  • {MediaId}:媒資 ID。

  • {JobId}:轉碼子任務 ID。

  • {MediaBucket}:媒資 ID 所在的 Bucket。

  • {ExtName}:檔案尾碼,取轉碼模板的輸出格式。

  • {DestMd5}:轉碼輸出檔案的 MD5 值。

說明
  1. 該參數必須包含{MediaId} 和 {JobId} 兩個預留位置。

  2. 輸出的 Bucket 與 MediaId 所在 Bucket 相同。

oss://bucket/path/to/{MediaId}/{JobId}.mp4

ProcessConfig

object

任務處理配置。

Transcode

object

轉碼配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Video

object

video 設定。

Codec

string

編碼格式。

H.264

Profile

string

編碼層級。 支援 baseline、main、high。

  • baseline:針對行動裝置。

  • main:針對標準解析度裝置。

  • high:針對高解析度裝置。

預設值:high。

Main

Bitrate

string

視頻平均碼率,取值範圍:[10,50000],單位:Kbps。

3000

Crf

string

碼率-品質控制因子,取值範圍:[0,51]。預設值:編碼格式為 H264,預設值為 23;編碼格式為 H265,預設值為 26。

說明

如果設定了 Crf,則 Bitrate 的設定失效。

23

Width

string

寬,取值範圍:[128,4096],單位:px,預設值:視頻原始寬度。

1920

Height

string

高,取值範圍:[128,4096],單位:px,預設值:視頻原始高度。

1080

Fps

string

幀率,取值範圍:(0,60],預設值:取輸入檔案幀率。

說明

當輸入檔案幀率超過 60 時取 60。

25

Gop

string

主要畫面格間最大幀數,取值範圍:[1,1080000],預設值:250。

250

Preset

string

視頻演算法器預置。只有 H264 支援該參數。 支援 veryfast、fast、medium、slow、slower。 預設值:medium。

medium

ScanMode

string

掃描模式。 支援 interlaced、progressive。

progressive

PixFmt

string

視頻顏色格式。 範圍:yuv420p,yuvj420p 等標準顏色格式。

yuv420p

Remove

string

是否去掉視頻。

false

Crop

string

視頻畫面裁切支援 2 種方式。

  • 自動檢測黑邊並裁切,設定為“border”

  • 自訂裁切,參數格式:width:height:left:top,樣本:1280:800:0:140

1280:800:0:140

Pad

string

視頻貼黑邊參數,格式:width:height:left:top,樣本:1280:800:0:140

1280:800:0:140

LongShortMode

string

是否開啟橫豎屏自適應(即:長短邊模式)

false

Bufsize

string

緩衝區大小值,範圍:[1000,128000],預設值:6000,單位:Kb。

6000

Maxrate

string

視頻碼率峰值範圍[10,50000],單位 Kbps。

9000

AbrMax

string

abr 最大碼率(只有窄高 1 有效)值範圍[10,50000],單位 Kbps。

6000

Audio

object

audio 設定。

Codec

string

音頻編解碼格式,AAC、MP3、VORBIS、FLAC。 預設值:AAC。

AAC

Profile

string

音頻編碼預置。 當 Codec 為 AAC 時,範圍 aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

aac_low

Samplerate

string

採樣率,預設值:44100,支援 22050、32000、44100、48000、96000,單位:Hz。

44100

Bitrate

string

輸出檔案的音頻碼率,值範圍:[8,1000],單位:Kbps,預設值:128。

128

Channels

string

聲道數。 預設值:2

2

Remove

string

是否刪除音頻流。

false

Volume

object

音量控制。

Method

string

音量調整方式。

auto

IntegratedLoudnessTarget

string

目標音量。

-6

TruePeak

string

最大峰值。

-1

LoudnessRangeTarget

string

音量範圍。

8

Container

object

封裝格式設定。

Format

string

容器格式。

mp4

MuxConfig

object

封裝設定。

Segment

object

切片設定。

Duration

string

切片時間長度。

10

ForceSegTime

string

強制切片時間點。

2,3

TransConfig

object

條件轉碼參數。

TransMode

string

視頻轉碼模式。取值如下:

  • onepass:一般用於 ABR。編碼速度較 twopass 更快。

  • twopass:一般用於 VBR。編碼速度較 onepass 更慢。

  • CBR:固定碼率模式。

預設值:onepass。

onepass

IsCheckReso

string

是否檢查視頻解析度。IsCheckReso 和 IsCheckResoFail 只支援二選一,IsCheckResoFail 優先順序更高。

  • true:檢查。當輸入視頻解析度(寬或高)小於輸出設定時,按輸入視頻解析度轉碼。

  • false:不檢查。

預設值:false。

true

IsCheckResoFail

string

是否檢查視頻解析度。IsCheckReso 和 IsCheckResoFail 只支援二選一,本參數優先順序更高。

  • true:檢查。當輸入視頻解析度(寬或高)小於輸出設定時,返迴轉碼失敗。

  • false:不檢查。

預設值:false。

true

IsCheckVideoBitrate

string

是否檢查視頻碼率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支援二選一,IsCheckVideoBitrateFail 優先順序更高。

  • true:檢查。當輸入視頻碼率小於輸出設定時,按輸入視頻碼率轉碼。

  • false:不檢查。

預設值:false。

true

IsCheckVideoBitrateFail

string

是否檢查視頻碼率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支援二選一,本參數優先順序更高。

  • true:檢查。當輸入視頻碼率小於輸出設定時,返迴轉碼失敗。

  • false:不檢查。

預設值:false。

true

IsCheckAudioBitrate

string

是否檢查音頻碼率。IsCheckAudioBitrate 和 IsCheckAudioBitrateFail 只支援二選一,IsCheckAudioBitrateFail 優先順序更高。

  • true:檢查。當輸入音頻碼率小於輸出設定時,按輸入音頻碼率轉碼。

  • false:不檢查。

預設值:

  • 參數為空白,並且 codec 和輸入源不一樣:false。

  • 參數為空白,並且 codec 和輸入源一樣:true。

true

IsCheckAudioBitrateFail

string

是否檢查音頻碼率。IsCheckAudioBitrate 和 IsCheckAudioBitrateFail 只支援二選一,本參數優先順序更高。

  • true:檢查。當輸入音頻碼率小於輸出設定時,返迴轉碼失敗。

  • false:不檢查。

預設值:false。

true

AdjDarMethod

string

解析度改寫方式。當 Width 或 Height 都填寫時才生效,可以和 LongShortMode 搭配使用。

可選值:rescale、crop、pad、none。

預設值:none。

none

ImageWatermarks

array<object>

圖片浮水印配置。

array<object>

圖片浮水印配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Width

string

輸出視頻上浮水印圖片寬。 值有兩種形式:

  • 整數型代浮水印圖片寬的像素值。
    • 範圍:[8,4096]

    • 單位:px

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

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄。

32

Height

string

輸出視頻上浮水印圖片高。 值有兩種形式:

  • 整數型代浮水印圖片高的像素值。
    • 範圍:[8,4096]

    • 單位:px

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

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄。

32

Dx

string

浮水印圖片相對輸出視頻的水平位移量。 預設值:0

值有兩種形式:

  • 整數型代表位移像素。
    • 範圍:[8,4096]

    • 單位:px

  • 小數型代表水平位移量與輸出解析度寬的比率。
    • 範圍:(0,1)

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄

10

Dy

string

浮水印圖片相對輸出視頻的垂直位移量。 預設值:0

值有兩種形式:

  • 整數型代表位移像素。
    • 範圍[8,4096]

    • 單位:px

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

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄

10

ReferPos

string

浮水印的位置。

  • 可取值:TopRight(右上)、TopLeft(左上)、BottomRight(右下)、BottomLeft(左下)

  • 預設值:TopRight

TopLeft

Timeline

object

動態浮水印,顯示時間設定。

Start

string

浮水印開始出現時間。

  • 單位:秒

  • 取值範圍:數字

  • 預設值:0

00:00:05

Duration

string

浮水印期間。

  • 取值範圍:[數字,ToEND]

  • 預設值:ToEND

ToEND

File

object

浮水印圖片檔案。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

TextWatermarks

array<object>

文字浮水印配置。

array<object>

文字浮水印配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Content

string

浮水印文本,不需要 base64 encode,字串需要 utf-8 編碼。

測試浮水印

FontName

string

字型。預設:SimSun。

SimSun

FontColor

string

顏色。

#006400

FontAlpha

string

字型透明度。

  • 範圍:(0, 1]

  • 預設:1.0

1.0

Top

string

文本上邊距。

  • 預設:0

  • 範圍:[0,4096]

10

Left

string

文本左邊距。

  • 預設:0

  • 範圍:[0,4096]

10

FontSize

integer

字型大小。

  • 預設值:16

  • 範圍:(4, 120)

16

BorderWidth

integer

描邊寬度。

  • 預設:0

  • 範圍:(0,4096]

0

BorderColor

string

描邊顏色。 預設:Black 更多取值請參見 BorderColor。

#006400

Adaptive

string

根據輸出視頻大小調整字型 size。 true / false, default: false

false

Subtitles

array<object>

字幕壓制配置。

array<object>

字幕壓制配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Format

string

字幕檔案格式。

vtt

CharEnc

string

檔案 encoding 格式。

UTF-8

File

object

字幕檔案。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

Encryption

object

加密配置。

EncryptType

string

加密類型。取值:

  • PrivateEncryption:阿里雲私人加密。

  • HLSEncryption:HLS 標準加密。

PrivateEncryption

CipherText

string

標準加密的密鑰密文。

MTYi00NDU0LTg5O****

DecryptKeyUri

string

標準加密的解密服務地址。

https://sample.com/path?CipherText=MTYi00NDU0LTg5O****

KeyServiceType

string

標準加密的密鑰服務類型。取值:

  • KMS

  • Base64

KMS

CombineConfigs

array<object>

多輸入合流配置

object

合流配置。

AudioIndex

string

音頻流 Index

0 或 exclude

VideoIndex

string

視頻流 Index

0 或 exclude

Start

number

輸入資料流的開始時間。 預設為 0

0.0

Duration

number

輸入資料流的期間。 預設為視頻時間長度。

20.0

UserData

string

自訂設定,JSON 格式,長度限制為 512 位元組,支援自訂回調地址配置

user-data

ScheduleConfig

object

任務調度資訊。

job-name

PipelineId

string

管道 ID。

e37ebee5d98b4781897f6086e89f9c56

Priority

integer

任務優先順序。數字越大優先順序越高,取值範圍:1~10

5

ClientToken

string

等冪性校正 Key。保證請求等冪性。

****12e8864746a0a398****

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID

31E30781-9495-5E2D-A84D-759B0A01E262

TranscodeParentJob

object

TranscodeParentJobWithSubJobDTO

TranscodeJobList

array<object>

子任務列表。

array<object>

子任務詳情。

CreateTime

string

任務建立時間。

2022-01-12T08:49:41Z

Name

string

任務名。

transcode-job

ParentJobId

string

主任務 ID

8b2198504dd340b7b3c9842a74fc9baa

JobId

string

子任務 ID

7d6a7e0d4db2457a8d45ff5d43e1bf0a

JobIndex

integer

子任務在整個任務中的索引號。

0

InputGroup

array<object>

任務輸入組。單個輸入為轉碼任務。多個輸入為音視頻合流任務。

object

作業輸入。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

InputUrl

string

輸入資料流路徑:

  • 僅當 type 為 Media 是才生效,讓使用者可以選擇該媒資下的特定檔案作為輸入。

  • 系統會檢查該媒資下是否存在這個 inputUrl。

oss://bucket/path/to/video.mp4

ProcessConfig

object

轉碼處理配置。

Transcode

object

轉碼配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Video

object

video 設定。

Codec

string

編碼格式。

H.264

Profile

string

編碼層級。 支援 baseline、main、high。

  • baseline:針對行動裝置。

  • main:針對標準解析度裝置。

  • high:針對高解析度裝置。

預設值:high。

Main

Bitrate

string

視頻平均碼率。

  • 取值範圍:[10,50000]。

  • 單位:Kbps。

3000

Crf

string

碼率-品質控制因子。

  • 取值範圍:[0,51]。

  • 預設值:編碼格式為 H264,預設值為 23。編碼格式為 H265,預設值為 26。

如果設定了 Crf,則 Bitrate 的設定失效。

23

Width

string

寬。

  • 取值範圍:[128,4096]。

  • 單位:px。

  • 預設值:視頻原始寬度。

1920

Height

string

高。

  • 取值範圍:[128,4096]。

  • 單位:px。

  • 預設值:視頻原始高度。

1080

Fps

string

幀率。

  • 取值範圍:(0,60]。

  • 當輸入檔案幀率超過 60 時取 60。

  • 預設值:取輸入檔案幀率。

25

Gop

string

主要畫面格間最大幀數。

  • 取值範圍:[1,1080000]。

  • 預設值:250。

250

Preset

string

視頻演算法器預置。只有 H264 支援該參數。 支援 veryfast、fast、medium、slow、slower。 預設值:medium。

medium

ScanMode

string

掃描模式。 支援 interlaced、progressive。

progressive

PixFmt

string

視頻顏色格式。 範圍:yuv420p,yuvj420p 等標準顏色格式。

yuv420p

Remove

string

是否去掉視頻。

false

Crop

string

視頻畫面裁切,支援 2 種方式。

  • 自動檢測黑邊並裁切,設定為“border”

  • 自訂裁切,參數格式:width:height:left:top。樣本:1280:800:0:140

1280:800:0:140

Pad

string

視頻貼黑邊

  • 參數格式:width:height:left:top。

  • 樣本:1280:800:0:140

1280:800:0:140

LongShortMode

string

是否開啟橫豎屏自適應(即:長短邊模式)

false

Bufsize

string

緩衝區大小

  • 值範圍:[1000,128000]

  • 預設值:6000

  • 單位:Kb

6000

Maxrate

string

視頻碼率峰值 值範圍[10,50000],單位 Kbps。

9000

AbrMax

string

abr 最大碼率(只有窄高 1 有效) 值範圍[10,50000],單位 Kbps。

6000

Audio

object

audio 設定。

Codec

string

音頻編解碼格式,AAC、MP3、VORBIS、FLAC。 預設值:AAC

AAC

Profile

string

音頻編碼預置。 當 Codec 為 AAC 時,範圍 aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

aac_low

Samplerate

string

採樣率。

  • 預設值:44100

  • 支援 22050、32000、44100、48000、96000,

  • 單位:Hz

44100

Bitrate

string

輸出檔案的音頻碼率。

  • 值範圍:[8,1000]

  • 單位:Kbps

  • 預設值:128

128

Channels

string

聲道數。 預設值:2

2

Remove

string

是否刪除音頻流。

false

Volume

object

音量控制。

Method

string

音量調整方式。

auto

IntegratedLoudnessTarget

string

目標音量。

-6

TruePeak

string

最大峰值。

-1

LoudnessRangeTarget

string

音量範圍。

8

Container

object

封裝格式設定。

Format

string

容器格式。

mp4

MuxConfig

object

封裝設定。

Segment

object

切片設定。

Duration

string

切片時間長度。

10

ForceSegTime

string

強制切片時間點。

2,3

TransConfig

object

條件轉碼參數。

TransMode

string

視頻轉碼模式。取值:

  • onepass(預設值):一般用於 ABR。編碼速度較 twopass 更快。

  • twopass:一般用於 VBR。編碼速度較 onepass 更慢。

  • CBR:固定碼率模式。

onepass

IsCheckReso

string

是否檢查視頻解析度。IsCheckReso 和 IsCheckResoFail 只支援二選一,IsCheckResoFail 優先順序更高。

  • true:檢查。當輸入視頻解析度(寬或高)小於輸出設定時,按輸入視頻解析度轉碼。

  • false(預設值):不檢查。

true

IsCheckResoFail

string

是否檢查視頻解析度。IsCheckReso 和 IsCheckResoFail 只支援二選一,本參數優先順序更高。

  • true:檢查。當輸入視頻解析度(寬或高)小於輸出設定時,返迴轉碼失敗。

  • false(預設值):不檢查。

true

IsCheckVideoBitrate

string

是否檢查視頻碼率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支援二選一,IsCheckVideoBitrateFail 優先順序更高。

  • true:檢查。當輸入視頻碼率小於輸出設定時,按輸入視頻碼率轉碼。

  • false(預設值):不檢查。

true

IsCheckVideoBitrateFail

string

是否檢查視頻碼率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支援二選一,本參數優先順序更高。

  • true:檢查。當輸入視頻碼率小於輸出設定時,返迴轉碼失敗。

  • false(預設值):不檢查。

true

IsCheckAudioBitrate

string

是否檢查音頻碼率。IsCheckAudioBitrate 和 IsCheckAudioBitrateFail 只支援二選一,IsCheckAudioBitrateFail 優先順序更高。

  • true:檢查。當輸入音頻碼率小於輸出設定時,按輸入音頻碼率轉碼。

  • false:不檢查。

預設值規則:

  • 參數為空白,並且 codec 和輸入源不一樣:false。

  • 參數為空白,並且 codec 和輸入源一樣:true。

true

IsCheckAudioBitrateFail

string

是否檢查音頻碼率。IsCheckAudioBitrate 和 IsCheckAudioBitrateFail 只支援二選一,本參數優先順序更高。

  • true:檢查。當輸入音頻碼率小於輸出設定時,返迴轉碼失敗。

  • false(預設值):不檢查。

true

AdjDarMethod

string

解析度改寫方式。當 Width 或 Height 都填寫時才生效,可以和 LongShortMode 搭配使用。

可選值:rescale、crop、pad、none。

預設值:none。

none

ImageWatermarks

array<object>

圖片浮水印配置。

array<object>

圖片浮水印配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Width

string

輸出視頻上浮水印圖片寬。 值有兩種形式:

  • 整數型代浮水印圖片寬的像素值。
    • 範圍:[8,4096]

    • 單位:px

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

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄。

32

Height

string

輸出視頻上浮水印圖片高。 值有兩種形式:

  • 整數型代浮水印圖片高的像素值。
    • 範圍:[8,4096]

    • 單位:px

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

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄。

32

Dx

string

浮水印圖片相對輸出視頻的水平位移量。 預設值:0

值有兩種形式:

  • 整數型代表位移像素。
    • 範圍:[8,4096]

    • 單位:px

  • 小數型代表水平位移量與輸出解析度寬的比率。
    • 範圍:(0,1)

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄

10

Dy

string

浮水印圖片相對輸出視頻的垂直位移量。 預設值:0

值有兩種形式:

  • 整數型代表位移像素。
    • 範圍[8,4096]

    • 單位:px

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

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄

10

ReferPos

string

浮水印的位置。

  • 可取值:TopRight(右上)、TopLeft(左上)、BottomRight(右下)、BottomLeft(左下)

  • 預設值:TopRight

TopLeft

Timeline

object

動態浮水印,顯示時間設定。

Start

string

浮水印開始出現時間。

  • 單位:秒

  • 取值範圍:數字

  • 預設值:0

00:00:05

Duration

string

浮水印期間。

  • 取值範圍:[數字,ToEND]

  • 預設值:ToEND

ToEND

File

object

浮水印圖片檔案。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

TextWatermarks

array<object>

文字浮水印配置。

array<object>

文字浮水印配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數

Content

string

浮水印文本,不需要 base64 encode,字串需要 utf-8 編碼。

測試浮水印

FontName

string

字型。預設:SimSun。

SimSun

FontColor

string

顏色。

#006400

FontAlpha

string

字型透明度。

  • 範圍:(0, 1]

  • 預設:1.0

1.0

Top

string

文本上邊距。

  • 預設:0

  • 範圍:[0,4096]

10

Left

string

文本左邊距。

  • 預設:0

  • 範圍:[0,4096]

10

FontSize

integer

字型大小。

  • 預設值:16

  • 範圍:(4, 120)

16

BorderWidth

integer

描邊寬度。

  • 預設:0

  • 範圍:(0,4096]

0

BorderColor

string

描邊顏色。 預設:Black 更多取值請參見 BorderColor。

#006400

Adaptive

string

根據輸出視頻大小調整字型 size。 true / false, default: false

false

Subtitles

array<object>

字幕壓制配置。

array<object>

字幕壓制配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Format

string

字幕檔案格式。

vtt

CharEnc

string

檔案 encoding 格式。

UTF-8

File

object

字幕檔案。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

Encryption

object

加密配置。

EncryptType

string

加密類型。

PrivateEncryption

CipherText

string

標準加密的密鑰密文。

MTYi00NDU0LTg5O****

DecryptKeyUri

string

標準加密的解密服務地址。

https://sample.com/path?CipherText=MTYi00NDU0LTg5O****

KeyServiceType

string

密鑰服務類型。目前僅支援 KMS 和 Base64

KMS

CombineConfigs

array<object>

多輸入合流配置

object

合流配置。

AudioIndex

string

音頻流 Index

0 或 exclude

VideoIndex

string

視頻流 Index

0 或 exclude

Start

number

輸入資料流的開始時間。 預設為 0

0.0

Duration

number

輸入資料流的期間。 預設為視頻時間長度。

20.0

Output

object

輸出媒體配置。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

OutputUrl

string

輸出資料流路徑:
僅當 Type 為 Media 時才生效,讓使用者可以選擇該媒資下特定檔案作為輸出。
支援的預留位置:

  • {MediaId}:媒資 ID。

  • {JobId}:轉碼子任務 ID。

  • {MediaBucket}:媒資 ID 所在的 Bucket。

  • {ExtName}:檔案尾碼,取轉碼模板的輸出格式。

  • {DestMd5}:轉碼輸出檔案的 MD5 值。
    說明:

  1. 該參數必須包含{MediaId} 和 {JobId} 兩個預留位置。

  2. 輸出的 Bucket 與 MediaId 所在 Bucket 相同。

oss://bucket/path/to/{MediaId}/{JobId}.mp4

UserData

string

使用者資料。

user-data

ScheduleConfig

object

任務調度資訊。

PipelineId

string

管道 ID。

e37ebee5d98b4781897f6086e89f9c56

Priority

integer

任務優先順序。數字越大優先順序越高,取值範圍:1~10

5

Status

string

轉碼任務狀態

  • Init:已提交

  • Processing:轉碼中

  • Success:轉碼成功

  • Fail:轉碼失敗

  • Deleted:已刪除

Init

OutFileMeta

object

任務產生視頻 Media 資訊。

FileBasicInfo

object

基礎檔案資訊。

MediaId

string

媒資 ID。

73e07de0f77171eca3fc7035d0b26402

FileName

string

檔案名稱。

file.m3u8

FileStatus

string

檔案狀態。

Normal

FileType

string

檔案類型。取值:source_file, transcode_file

source_file

FileSize

string

檔案大小。單位:Byte。

31737

FileUrl

string

檔案 URL。

http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8

Region

string

檔案所在地區。

cn-shanghai

FormatName

string

視頻格式名稱。

hls,applehttp

Duration

string

視頻時間長度(單位:秒)。

403.039999

Bitrate

string

視頻碼率。

888.563

Width

string

寬。

848

Height

string

高。

478

AudioStreamInfoList

array<object>

音頻流資訊。

object

音頻流資訊。

Index

string

流序號。

1

CodecName

string

編碼格式。

aac

CodecLongName

string

編碼格式名。

AAC (Advanced Audio Coding)

CodecTimeBase

string

編碼器時間基。

1/44100

CodecTagString

string

編碼器標籤名。

[15][0][0][0]

CodecTag

string

編碼器標籤。

0x000f

SampleFmt

string

採樣格式。

fltp

SampleRate

string

採樣率(單位:Hz)。

44100

Channels

string

聲道數。

2

ChannelLayout

string

聲道布局。

stereo

Timebase

string

時間基。

1/90000

StartTime

string

開始時間。

1.473556

Duration

string

時間長度(單位:秒)。

403.039989

Bitrate

string

碼率。

0.f

Lang

string

語言。

cn

VideoStreamInfoList

array<object>

視頻流資訊。

object

視頻流資訊。

Index

string

流序號。

0

Codec_name

string

編碼格式。

h264

Codec_long_name

string

編碼格式名。

H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10

Profile

string

編碼器預設。

High

Codec_time_base

string

編碼時基。

1/50

Codec_tag_string

string

編碼格式標記文本。

[27][0][0][0]

Codec_tag

string

編碼格式標記。

0x001b

Width

string

寬。

848

Height

string

高。

478

Has_b_frames

string

是否有 B 幀。 取值:

  • 0: 沒有 B 幀,

  • 1: 有一個 B 幀,

  • 2: 有多個連續 B 幀。

2

Sar

string

採集點數寬高比。

478:477

Dar

string

映像顯示寬高比。

16:9

PixFmt

string

顏色儲存格式。

yuv420p

Level

string

編碼等級。

31

Fps

string

幀率。

25.0

Avg_fps

string

平均幀率。

25.0

Time_base

string

時基。

1/90000

Start_time

string

起始時間。

1.473556

Duration

string

時間長度(單位:秒)。

403.039989

Bit_rate

string

碼率。

888.563

NumFrames

string

總幀數。

10040

Lang

string

語言。

cn

Rotate

string

視頻畫面旋轉角度。 取值 0, 90, 180, 270。 預設值 0

0

SubmitResultJson

object

任務提交結果。

{}

SubmitTime

string

任務提交時間。

2022-01-12T08:49:41Z

FinishTime

string

任務結束時間。

2022-01-12T08:49:41Z

RequestId

string

提交任務時請求 ID。

31E30781-9495-5E2D-A84D-759B0A01E262

CreateTime

string

任務建立時間。格式為:yyyy-MM-ddTHH:mm:ssZ 。

2022-01-12T08:49:41Z

Name

string

任務名。

transcode-job

RequestId

string

提交任務時請求 ID。

31E30781-9495-5E2D-A84D-759B0A01E262

ParentJobId

string

主任務 ID。

8b2198504dd340b7b3c9842a74fc9baa

JobCount

integer

子任務數量。

1

Status

string

任務狀態。 Success: 所有子任務完成後,有一個子任務則為成功, Fail: 所有子任務失敗。

Success

TriggerSource

string

任務來源。 API: API, WorkFlow: 工作流程, Console: 控制台

API

Percent

integer

任務完成百分比。

0

SubmitTime

string

任務提交時間。格式為:yyyy-MM-ddTHH:mm:ssZ 。

2022-01-12T08:49:41Z

FinishTime

string

任務結束時間。格式為:yyyy-MM-ddTHH:mm:ssZ 。

2022-01-12T08:49:41Z

InputGroup

array<object>

任務輸入組。單個輸入為轉碼任務。多個輸入為音視頻合流任務。

object

作業輸入。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

OutputGroup

array<object>

任務輸出組。

array<object>

作業輸出。

Output

object

輸出媒體配置。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

ProcessConfig

object

任務處理配置。

Transcode

object

轉碼配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Video

object

video 設定

Codec

string

編碼格式。

H.264

Profile

string

編碼層級。 支援 baseline、main、high。

  • baseline:針對行動裝置。

  • main:針對標準解析度裝置。

  • high:針對高解析度裝置。

預設值:high。

Main

Bitrate

string

視頻平均碼率。

  • 取值範圍:[10,50000]。

  • 單位:Kbps。

3000

Crf

string

碼率-品質控制因子。

  • 取值範圍:[0,51]。

  • 預設值:編碼格式為 H264,預設值為 23。編碼格式為 H265,預設值為 26。

如果設定了 Crf,則 Bitrate 的設定失效。

23

Width

string

寬。

  • 取值範圍:[128,4096]。

  • 單位:px。

  • 預設值:視頻原始寬度。

1920

Height

string

高。

  • 取值範圍:[128,4096]。

  • 單位:px。

  • 預設值:視頻原始高度。

1080

Fps

string

幀率。

  • 取值範圍:(0,60]。

  • 當輸入檔案幀率超過 60 時取 60。

  • 預設值:取輸入檔案幀率。

25

Gop

string

主要畫面格間最大幀數。

  • 取值範圍:[1,1080000]。

  • 預設值:250。

250

Preset

string

視頻演算法器預置。只有 H264 支援該參數。 支援 veryfast、fast、medium、slow、slower。 預設值:medium。

medium

ScanMode

string

掃描模式。 支援 interlaced、progressive。

progressive

PixFmt

string

視頻顏色格式。 範圍:yuv420p,yuvj420p 等標準顏色格式。

yuv420p

Remove

string

是否去掉視頻。

false

Crop

string

視頻畫面裁切。 支援 2 種方式。

  • 自動檢測黑邊並裁切,設定為“border”

  • 自訂裁切,參數格式:width:height:left:top。 樣本:1280:800:0:140

1280:800:0:140

Pad

string

視頻貼黑邊。

  • 參數格式:width:height:left:top。

  • 樣本:1280:800:0:140

1280:800:0:140

LongShortMode

string

是否開啟橫豎屏自適應(即:長短邊模式)

false

Bufsize

string

緩衝區大小。

  • 值範圍:[1000,128000]

  • 預設值:6000

  • 單位:Kb

6000

Maxrate

string

視頻碼率峰值。

  • 值範圍:[10,50000]

  • 單位:Kbps

9000

AbrMax

string

abr 最大碼率(只有窄高 1 有效)

  • 值範圍:[10,50000]

  • 單位:Kbps

6000

Audio

object

audio 設定。

Codec

string

音頻編解碼格式,AAC、MP3、VORBIS、FLAC。 預設值:AAC

AAC

Profile

string

音頻編碼預置。 當 Codec 為 AAC 時,範圍 aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

aac_low

Samplerate

string

採樣率。

  • 預設值:44100 支援 22050、32000、44100、48000、96000,

  • 單位:Hz

44100

Bitrate

string

輸出檔案的音頻碼率。

  • 值範圍:[8,1000]

  • 單位:Kbps

  • 預設值:128

128

Channels

string

聲道數。 預設值:2

2

Remove

string

是否刪除音頻流。

false

Volume

object

音量控制。

Method

string

音量調整方式。

auto

IntegratedLoudnessTarget

string

目標音量。

-6

TruePeak

string

最大峰值。

-1

LoudnessRangeTarget

string

音量範圍。

8

Container

object

封裝格式設定。

Format

string

容器格式。

mp4

MuxConfig

object

封裝設定。

Segment

object

切片設定。

Duration

string

切片時間長度。

10

ForceSegTime

string

強制切片時間點。

2,3

TransConfig

object

條件轉碼參數。

TransMode

string

視頻轉碼模式。取值如下:

  • onepass:一般用於 ABR。編碼速度較 twopass 更快。

  • twopass:一般用於 VBR。編碼速度較 onepass 更慢。

  • CBR:固定碼率模式。

預設值:onepass。

onepass

IsCheckReso

string

是否檢查視頻解析度。IsCheckReso 和 IsCheckResoFail 只支援二選一,IsCheckResoFail 優先順序更高。

  • true:檢查。當輸入視頻解析度(寬或高)小於輸出設定時,按輸入視頻解析度轉碼。

  • false:不檢查。

預設值:false。

true

IsCheckResoFail

string

是否檢查視頻解析度。IsCheckReso 和 IsCheckResoFail 只支援二選一,本參數優先順序更高。

  • true:檢查。當輸入視頻解析度(寬或高)小於輸出設定時,返迴轉碼失敗。

  • false:不檢查。

預設值:false。

true

IsCheckVideoBitrate

string

是否檢查視頻碼率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支援二選一,IsCheckVideoBitrateFail 優先順序更高。

  • true:檢查。當輸入視頻碼率小於輸出設定時,按輸入視頻碼率轉碼。

  • false:不檢查。

預設值:false。

true

IsCheckVideoBitrateFail

string

是否檢查視頻碼率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支援二選一,本參數優先順序更高。

  • true:檢查。當輸入視頻碼率小於輸出設定時,返迴轉碼失敗。

  • false:不檢查。

預設值:false。

true

IsCheckAudioBitrate

string

是否檢查音頻碼率。IsCheckAudioBitrate 和 IsCheckAudioBitrateFail 只支援二選一,IsCheckAudioBitrateFail 優先順序更高。

  • true:檢查。當輸入音頻碼率小於輸出設定時,按輸入音頻碼率轉碼。

  • false:不檢查。

預設值:

  • 參數為空白,並且 codec 和輸入源不一樣:false。

  • 參數為空白,並且 codec 和輸入源一樣:true。

true

IsCheckAudioBitrateFail

string

是否檢查音頻碼率。IsCheckAudioBitrate 和 IsCheckAudioBitrateFail 只支援二選一,本參數優先順序更高。

  • true:檢查。當輸入音頻碼率小於輸出設定時,返迴轉碼失敗。

  • false:不檢查。

預設值:false。

true

AdjDarMethod

string

解析度改寫方式。當 Width 或 Height 都填寫時才生效,可以和 LongShortMode 搭配使用。

可選值:rescale、crop、pad、none。

預設值:none。

none

ImageWatermarks

array<object>

圖片浮水印配置。

array<object>

圖片浮水印配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Width

string

輸出視頻上浮水印圖片寬。 值有兩種形式:

  • 整數型代浮水印圖片寬的像素值。
    • 範圍:[8,4096]

    • 單位:px

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

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄。

32

Height

string

輸出視頻上浮水印圖片高。 值有兩種形式:

  • 整數型代浮水印圖片高的像素值。
    • 範圍:[8,4096]

    • 單位:px

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

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄。

32

Dx

string

浮水印圖片相對輸出視頻的水平位移量。 預設值:0

值有兩種形式:

  • 整數型代表位移像素。
    • 範圍:[8,4096]

    • 單位:px

  • 小數型代表水平位移量與輸出解析度寬的比率。
    • 範圍:(0,1)

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄

10

Dy

string

浮水印圖片相對輸出視頻的垂直位移量。 預設值:0

值有兩種形式:

  • 整數型代表位移像素。
    • 範圍[8,4096]

    • 單位:px

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

    • 支援 4 位小數,如 0.9999,超出部分系統自動丟棄

10

ReferPos

string

浮水印的位置。

  • 可取值:TopRight(右上)、TopLeft(左上)、BottomRight(右下)、BottomLeft(左下)

  • 預設值:TopRight

TopLeft

Timeline

object

動態浮水印,顯示時間設定。

Start

string

浮水印開始出現時間。

  • 單位:秒

  • 取值範圍:數字

  • 預設值:0

00:00:05

Duration

string

浮水印期間。

  • 取值範圍:[數字,ToEND]

  • 預設值:ToEND

ToEND

File

object

浮水印圖片檔案。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

TextWatermarks

array<object>

文字浮水印配置。

array<object>

文字浮水印配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Content

string

浮水印文本,不需要 base64 encode,字串需要 utf-8 編碼。

測試浮水印

FontName

string

字型。預設:SimSun。

SimSun

FontColor

string

顏色。

#006400

FontAlpha

string

字型透明度。

  • 範圍:(0, 1]

  • 預設:1.0

1.0

Top

string

文本上邊距。

  • 預設:0

  • 範圍:[0,4096]

10

Left

string

文本左邊距。

  • 預設:0

  • 範圍:[0,4096]

10

FontSize

integer

字型大小。

  • 預設值:16

  • 範圍:(4, 120)

16

BorderWidth

integer

描邊寬度。

  • 預設:0

  • 範圍:(0,4096]

0

BorderColor

string

描邊顏色。 預設:Black 更多取值請參見 BorderColor。

#006400

Adaptive

string

根據輸出視頻大小調整字型 size。

  • true: false

  • default: false

false

Subtitles

array<object>

字幕壓制配置。

array<object>

字幕壓制配置。

TemplateId

string

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

覆蓋參數, 若填寫會覆蓋模板對應參數。

Format

string

字幕檔案格式。

vtt

CharEnc

string

檔案 encoding 格式。

UTF-8

File

object

字幕檔案。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值: type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議; type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

Encryption

object

加密配置。

EncryptType

string

加密類型。

PrivateEncryption

CipherText

string

標準加密的密鑰密文。

MTYi00NDU0LTg5O****

DecryptKeyUri

string

標準加密的解密服務地址。

https://sample.com/path?CipherText=MTYi00NDU0LTg5O****

KeyServiceType

string

密鑰服務類型。目前僅支援 KMS 和 Base64

KMS

CombineConfigs

array<object>

多輸入合流配置

object

多輸入合流配置

AudioIndex

string

音頻流 Index

0 或 exclude

VideoIndex

string

視頻流 Index

0 或 exclude

Start

number

輸入資料流的開始時間。 預設為 0

0.0

Duration

number

輸入資料流的期間。 預設為視頻時間長度。

20.0

UserData

string

使用者資料。

user-data

ScheduleConfig

object

任務調度配置。

PipelineId

string

管道 ID。

e37ebee5d98b4781897f6086e89f9c56

Priority

integer

任務優先順序。數字越大優先順序越高,取值範圍:1~10

5

樣本

正常返回樣本

JSON格式

{
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "TranscodeParentJob": {
    "TranscodeJobList": [
      {
        "CreateTime": "2022-01-12T08:49:41Z",
        "Name": "transcode-job",
        "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
        "JobId": "7d6a7e0d4db2457a8d45ff5d43e1bf0a",
        "JobIndex": 0,
        "InputGroup": [
          {
            "Type": "OSS",
            "Media": "oss://bucket/path/to/video.mp4",
            "InputUrl": "oss://bucket/path/to/video.mp4\n"
          }
        ],
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              },
              "TransConfig": {
                "TransMode": "onepass",
                "IsCheckReso": "true",
                "IsCheckResoFail": "true",
                "IsCheckVideoBitrate": "true",
                "IsCheckVideoBitrateFail": "true",
                "IsCheckAudioBitrate": "true",
                "IsCheckAudioBitrateFail": "true",
                "AdjDarMethod": "none"
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "測試浮水印",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "Encryption": {
            "EncryptType": "PrivateEncryption",
            "CipherText": "MTYi00NDU0LTg5O****",
            "DecryptKeyUri": "https://sample.com/path?CipherText=MTYi00NDU0LTg5O****",
            "KeyServiceType": "KMS"
          },
          "CombineConfigs": [
            {
              "AudioIndex": "0 或 exclude",
              "VideoIndex": "0 或 exclude",
              "Start": 0,
              "Duration": 20
            }
          ]
        },
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4",
          "OutputUrl": "oss://bucket/path/to/{MediaId}/{JobId}.mp4\n"
        },
        "UserData": "user-data",
        "ScheduleConfig": {
          "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
          "Priority": 5
        },
        "Status": "Init",
        "OutFileMeta": {
          "FileBasicInfo": {
            "MediaId": "73e07de0f77171eca3fc7035d0b26402",
            "FileName": "file.m3u8",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "31737",
            "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
            "Region": "cn-shanghai",
            "FormatName": "hls,applehttp",
            "Duration": "403.039999",
            "Bitrate": "888.563",
            "Width": "848",
            "Height": "478"
          },
          "AudioStreamInfoList": [
            {
              "Index": "1",
              "CodecName": "aac",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "CodecTimeBase": "1/44100",
              "CodecTagString": "[15][0][0][0]",
              "CodecTag": "0x000f",
              "SampleFmt": "fltp",
              "SampleRate": "44100",
              "Channels": "2",
              "ChannelLayout": "stereo",
              "Timebase": "1/90000",
              "StartTime": "1.473556",
              "Duration": "403.039989",
              "Bitrate": "0.f",
              "Lang": "cn"
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "0",
              "Codec_name": "h264",
              "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
              "Profile": "High",
              "Codec_time_base": "1/50",
              "Codec_tag_string": "[27][0][0][0]",
              "Codec_tag": "0x001b",
              "Width": "848",
              "Height": "478",
              "Has_b_frames": "2",
              "Sar": "478:477",
              "Dar": "16:9",
              "PixFmt": "yuv420p",
              "Level": "31",
              "Fps": "25.0",
              "Avg_fps": "25.0",
              "Time_base": "1/90000",
              "Start_time": "1.473556",
              "Duration": "403.039989",
              "Bit_rate": "888.563",
              "NumFrames": "10040",
              "Lang": "cn",
              "Rotate": "0"
            }
          ]
        },
        "SubmitResultJson": {},
        "SubmitTime": "2022-01-12T08:49:41Z",
        "FinishTime": "2022-01-12T08:49:41Z",
        "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262"
      }
    ],
    "CreateTime": "2022-01-12T08:49:41Z",
    "Name": "transcode-job",
    "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
    "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
    "JobCount": 1,
    "Status": "Success",
    "TriggerSource": "API",
    "Percent": 0,
    "SubmitTime": "2022-01-12T08:49:41Z",
    "FinishTime": "2022-01-12T08:49:41Z",
    "InputGroup": [
      {
        "Type": "OSS",
        "Media": "oss://bucket/path/to/video.mp4"
      }
    ],
    "OutputGroup": [
      {
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4"
        },
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              },
              "TransConfig": {
                "TransMode": "onepass",
                "IsCheckReso": "true",
                "IsCheckResoFail": "true",
                "IsCheckVideoBitrate": "true",
                "IsCheckVideoBitrateFail": "true",
                "IsCheckAudioBitrate": "true",
                "IsCheckAudioBitrateFail": "true",
                "AdjDarMethod": "none"
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "測試浮水印",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "Encryption": {
            "EncryptType": "PrivateEncryption",
            "CipherText": "MTYi00NDU0LTg5O****",
            "DecryptKeyUri": "https://sample.com/path?CipherText=MTYi00NDU0LTg5O****",
            "KeyServiceType": "KMS"
          },
          "CombineConfigs": [
            {
              "AudioIndex": "0 或 exclude",
              "VideoIndex": "0 或 exclude",
              "Start": 0,
              "Duration": 20
            }
          ]
        }
      }
    ],
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    }
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情