全部產品
Search
文件中心

Intelligent Media Services:SubmitTranscodeJob

更新時間:Oct 12, 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

任務建立時間。時間格式為 ISO 8601,使用 UTC 時間(以 Z 結尾)。

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

編碼層級。

Main

Bitrate

string

影片平均位元率。

3000

Crf

string

位元率-品質控制因子。

23

Width

string

寬度。

1920

Height

string

高度。

1080

Fps

string

影格率。

25

Gop

string

關鍵影格間最大影格數。

250

Preset

string

影片演算法器預置。只有 H264 支援此參數。

medium

ScanMode

string

掃描模式。

progressive

PixFmt

string

影片顏色格式。

yuv420p

Remove

string

是否移除影片。

false

Crop

string

影片畫面裁切,支援 2 種方式。

1280:800:0:140

Pad

string

影片貼黑邊。

1280:800:0:140

LongShortMode

string

是否開啟橫豎螢幕自動調整(即:長短邊模式)。

false

Bufsize

string

緩衝區大小。

6000

Maxrate

string

影片位元率峰值。

9000

AbrMax

string

ABR 最大位元率(僅窄高 1 有效)。

6000

Audio

object

audio 設定。

Codec

string

音訊編解碼格式,AAC、MP3、VORBIS、FLAC。

AAC

Profile

string

音訊編碼預置。

aac_low

Samplerate

string

取樣率。

44100

Bitrate

string

輸出檔案的音訊位元率。

128

Channels

string

聲道數。

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

IsCheckReso

string

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

true

IsCheckResoFail

string

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

true

IsCheckVideoBitrate

string

是否檢查影片位元率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支援二選一,IsCheckVideoBitrateFail 優先順序更高。

true

IsCheckVideoBitrateFail

string

是否檢查影片位元率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支援二選一,本參數優先順序更高。

true

IsCheckAudioBitrate

string

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

true

IsCheckAudioBitrateFail

string

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

true

AdjDarMethod

string

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

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

任務提交時間。時間格式為 ISO 8601,使用 UTC 時間(以 Z 結尾)。

2022-01-12T08:49:41Z

FinishTime

string

任務結束時間。時間格式為 ISO 8601,使用 UTC 時間(以 Z 結尾)。

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
    }
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情。