GetTranscodeJob - 查詢轉碼任務 - Intelligent Media Services

查詢單個轉碼任務詳情。

介面說明

該介面功能即將下線，請調用GetMediaConvertJob - 查詢媒體轉碼任務。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:GetTranscodeJob

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
ParentJobId	string	是	任務 ID	ab4802364a2e49208c99efab82dfa8e8

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	9EDC30DC-0050-5459-B788-F761B2BE359B
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	媒資流地址，只有當對媒資流進行轉碼時填寫此參數。	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
Pad	string	視頻貼黑邊，參數格式：width:height:left:top。	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
Tags	object
	string
ImageWatermarks	array<object>	圖片浮水印配置。
	array<object>	圖片浮水印配置。
TemplateId	string	模板 ID。	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	覆蓋參數, 若填寫會覆蓋模板對應參數。
Width	string	寬。	32
Height	string	高。	32
Dx	string	浮水印位置，x。	10
Dy	string	浮水印位置，y。	10
ReferPos	string	參考位置：TopLeft, TopRight, BottomLeft, BottomRight 預設值：TopLeft。	TopLeft
Timeline	object	顯示時間設定。
Start	string	開始時間。	00:00:05
Duration	string	顯示時間長度，秒數或者 "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 編碼。	test watermark
FontName	string	字型。	SimSun
FontColor	string	顏色。	#006400
FontAlpha	string	透明度。	1.0
Top	string	浮水印位置，距離上邊距離。	10
Left	string	浮水印位置，距離左邊距離。	10
FontSize	integer	字型大小。	16
BorderWidth	integer	邊框寬度。	0
BorderColor	string	邊框顏色。	#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 or exclude
VideoIndex	string	視頻流 Index	0 or exclude
Start	number	輸入資料流的開始時間。預設為 0	0.0
Duration	number	輸入資料流的期間。預設為視頻時間長度。	20.0
IsInheritTags	boolean	是否繼承輸入資料流的 tag。當輸入不是媒資是該參數不生效。預設值：false	true
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	轉碼輸出資料流地址，僅當輸出到媒資流時需要填此參數	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。	486c2890096871edba6f81848c016303
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
OutputUrl	string	輸出資料流地址。	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	寬。	32
Height	string	高。	32
Dx	string	浮水印位置，x。	10
Dy	string	浮水印位置，y。	10
ReferPos	string	參考位置：TopLeft, TopRight, BottomLeft, BottomRight default: TopLeft。	TopLeft
Timeline	object	顯示時間設定。
Start	string	開始時間。	00:00:05
Duration	string	顯示時間長度，秒數或者 "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 編碼。	test watermark
FontName	string	字型。	SimSun
FontColor	string	顏色。	#006400
FontAlpha	string	透明度。	1.0
Top	string	浮水印位置，距離上邊距離。	10
Left	string	浮水印位置，距離左邊距離。	10
FontSize	integer	字型大小。	16
BorderWidth	integer	邊框寬度。	0
BorderColor	string	邊框顏色。	#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 or exclude
VideoIndex	string	視頻流 Index	0 or 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": "9EDC30DC-0050-5459-B788-F761B2BE359B",
  "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"
          }
        ],
        "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"
              },
              "Tags": {
                "key": ""
              }
            }
          },
          "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": "test watermark",
                "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 or exclude",
              "VideoIndex": "0 or exclude",
              "Start": 0,
              "Duration": 20
            }
          ],
          "IsInheritTags": true
        },
        "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": "486c2890096871edba6f81848c016303",
            "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",
          "OutputUrl": "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": "test watermark",
                "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 or exclude",
              "VideoIndex": "0 or exclude",
              "Start": 0,
              "Duration": 20
            }
          ]
        }
      }
    ],
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    }
  }
}

錯誤碼

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

變更歷史

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