QueryJobList - 查詢轉碼作業 - ApsaraVideo Media Processing

通過轉碼作業ID，批量查詢轉碼作業。

介面說明

本介面一次最多查詢 10 個轉碼作業。
如果不傳入 JobIds，則會返回InvalidParameter（參數無效）錯誤碼。

QPS 限制

本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:QueryJobList

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
JobIds	string	否	轉碼作業 ID。一次最多查詢 10 個，使用半形逗號（,）分隔。可以通過 MPS 控制台 > 任務管理擷取，也可以從提交轉碼作業的返回參數中擷取。說明如果不傳入此參數，則會返回`InvalidParameter`（參數無效）錯誤碼。	bb558c1cc25b45309aab5be44d19**,d1ce4d3efcb549419193f50f1fcd**

返回參數

名稱	類型	描述	樣本值
	object	返回參數。
NonExistJobIds	object
String	array	不存在的作業 ID。
	string	不存在的轉碼作業 ID 列表，無資料時該結構不返回。	d1ce4d3efcb549419193f50f1fcd****
RequestId	string	請求 ID。	197ADF44-104C-514C-9F92-D8924CB34E2A
JobList	object
Job	array<object>	轉碼作業集合。
	array<object>	轉碼作業詳細資料。
CreationTime	string	作業添加時間。	2014-01-10T12:00:00Z
Percent	integer	轉碼進度。	100
FinishTime	string	作業完成時間。	2014-01-10T12:20:25Z
State	string	作業狀態。 Submitted：作業已提交。 Transcoding：轉碼中。 TranscodeSuccess：轉碼成功。 TranscodeFail：轉碼失敗。 TranscodeCancelled：轉碼取消。	TranscodeSuccess
JobId	string	任務 ID。	31fa3c9ca8134fb4b0b0f7878301****
Code	string	任務失敗時的錯誤碼。成功則不返回此參數。	InvalidParameter.NullValue
Message	string	任務失敗時的訊息。成功則不返回此參數。	The specified parameter "%s" cannot be null.
Output	object	作業輸出。
Video	object	視頻配置。
Bufsize	string	緩衝區大小。單位：Kb。預設值：6000。	6000
Degrain	string	獨立去噪演算法強度。	5
BitrateBnd	object	視頻平均碼率範圍。
Max	string	最大碼率。	1000
Min	string	最小碼率。	300
PixFmt	string	視頻顏色格式。範圍：yuv420p，yuvj420p 等標準顏色格式。	yuv420p
Pad	string	視頻貼黑邊。單位：px。參數格式：width:height:left:top。	1280:800:0:140
Codec	string	編解碼格式。支援 H.264、H.265。預設值：H.264。	H.264
Height	string	高。單位：px。預設值：視頻原始高度。	720
Qscale	string	視頻品質控制度。	15
Crop	string	視頻畫面裁剪，支援 2 種方式：自動檢測黑邊並裁切，設定為 border。自訂裁切，參數格式為 width:height:left:top。	1280:800:0:140
Bitrate	string	視頻平均碼率。單位：Kbps。	500
Maxrate	string	視頻碼率峰值。單位：Kbps。	3000
MaxFps	string	最大幀率。	60
Profile	string	編碼層級。支援 baseline、main、high。說明如果您有多個清晰度，建議最低清晰度配置成 baseline，以保證最低端裝置可播放。其他清晰度配置為 main 或 high。 baseline：針對行動裝置。 main：針對標準解析度裝置。 high：針對高解析度裝置。預設值：high。	high
Crf	string	碼率-品質控制因子。預設值：編碼格式為 H264，預設值為 23。編碼格式為 H265，預設值為 26。如果設定了 Crf，則 Bitrate 的設定失效。	26
Gop	string	主要畫面格間最大時間間隔或最大幀數。單位：秒。預設值：250。最大幀數時無單位。	250
Width	string	寬。單位：px。預設值：視頻原始寬度。	1280
Fps	string	幀率。單位：fps。當輸入檔案幀率超過 60 時取 60。預設值：取輸入檔案幀率。	25
Preset	string	視頻演算法器預置。預設值：medium。可取值： veryfast：超快。 fast：快。 medium：中等。 slow：慢。 slower：超慢。	medium
ScanMode	string	掃描模式。取值如下：不設定：按輸入檔案的原始模式。 auto：自動去隔行。 progressive：順序掃描（漸進式掃描）。 interlaced：交叉掃描（隔行掃描）。預設值：空，即不設定。最佳實務：交叉掃描雖然比順序掃描更節省資料量，但畫質不佳，所以現在主流視頻製作都採用順序掃描。如果您設定了順序掃描或交叉掃描，但與原視頻模式不符，會導致轉碼失敗。建議您設定原視頻模式或自動去隔行，以提高相容性。	interlaced
ResoPriority	string	資源優先順序。	1
TransConfig	object	轉碼通用配置。說明如果請求參數中設定了該值，則覆蓋指定轉碼模板中的對應參數。
IsCheckAudioBitrate	string	是否檢查音頻碼率。當輸出音頻碼率大於媒體源音頻碼率時，則視為輸出音頻碼率等於媒體源音頻碼率，即設定的音頻碼率參數不會生效。此值優先順序小於 IsCheckAudioBitrateFail。 true 表示檢查。 false 表示不檢查。預設值：參數為空白，並且 codec 和輸入源不一樣：false。參數為空白，並且 codec 和輸入源一樣：true。	false
TransMode	string	轉碼模式。可選範圍：onepass、twopass、CBR。預設值：onepass。	onepass
IsCheckReso	string	是否檢查解析度。如果輸出解析度大於輸入解析度（判斷條件是寬或高），則視為輸出解析度等於輸入解析度。 true 表示檢查。 false 表示不檢查。預設值：false。	false
IsCheckVideoBitrateFail	string	是否檢查碼率。當輸出視頻碼率大於媒體源視頻碼率時，則不進行轉碼，直接返迴轉碼失敗。此值優先順序大於 IsCheckVideoBitrate。 true 表示檢查。 false 表示不檢查。預設值：false。	false
AdjDarMethod	string	解析度改寫方式。預設值：none。可取值：rescale、crop、pad、none。	none
IsCheckVideoBitrate	string	是否檢查視頻碼率。如果視頻輸出碼率大於視頻輸入碼率，則視為視頻輸出碼率等於視頻輸入碼率。 true 表示檢查。 false 表示不檢查。預設值：false。	false
IsCheckResoFail	string	是否檢查解析度。如果輸出解析度大於輸入解析度（判斷條件是寬或高），則返迴轉碼失敗。 true 表示檢查。 false 表示不檢查。預設值：false。	false
IsCheckAudioBitrateFail	string	是否檢查音頻碼率。當輸出音頻碼率大於媒體源音頻碼率時，則不進行轉碼，直接返迴轉碼失敗，此值優先順序大於 IsCheckAudioBitrate。 true 表示檢查。 false 表示不檢查。預設值：false。	false
Encryption	object	資料加密，只支援 m3u8 格式的輸出。
Type	string	加密類型。取值：hls-aes-128。	hls-aes-128
Key	string	加密視頻的密鑰。	encryptionkey128
KeyType	string	祕密金鑰加密方式，可取值：Base64、KMS。說明例如密鑰為`"encryptionkey128"`，則`Base64("encryptionkey128")`，或`KMS(Base64("encryptionkey128")`。	Base64
Id	string	加密 ID。	31fa3c9ca8134f9cec2b4b0b0f78****
KeyUri	string	密鑰的存取 URL，使用 BASE64 進行編碼。	https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/
SkipCnt	string	前面不加密的片數（視頻能快速播放起來）。	3
WaterMarkList	object
WaterMark	array<object>	浮水印列表。
	array<object>	浮水印詳細資料。
Type	string	浮水印類型。如果請求參數中設定了此參數，則此值覆蓋浮水印模板對應參數。更多資訊，請參見參數詳情。可取值： Image：圖片浮水印。 Text：文字浮水印。	Image
ReferPos	string	浮水印的位置。如果請求參數中設定了此值，測覆蓋浮水印模板對應參數。可取值： TopRight：右上。 TopLeft：左上。 BottomRight：右下。 BottomLeft：左下。	TopRight
Dx	string	浮水印圖片相對輸出視頻的水平位移量。如果請求參數中設定了此值，則覆蓋浮水印模板對應參數。預設值為 0。值有兩種形式：整數型：代表位移像素值。範圍：[8,4096]。單位：px。小數型：代表水平位移量與輸出解析度寬的比率。範圍：（0,1)。支援四位小數，例如：0.9999，超出部分系統自動丟棄。	100
Width	string	浮水印圖片寬。如果在請求參數中設定了此值，則覆蓋浮水印模板對應浮水印圖片寬。值有兩種形式：整數型：代表浮水印圖片寬的像素值。範圍：[8，4096]。單位：px。小數型：代表相對輸出視頻解析度寬的比率。範圍：(0,1)。支援 4 位小數，例如：0.9999，超出部分系統自動丟棄。	50
Height	string	浮水印圖片搞高。如果在請求參數中設定了此值，則覆蓋浮水印模板對應浮水印圖片高。值有兩種形式：整數型：代表浮水印圖片高的像素值。範圍：[8，4096]。單位：px。小數型：代表相對輸出視頻解析度高的比率。範圍：(0,1)。支援 4 位小數，例如：0.9999，超出部分系統自動丟棄。	50
InputFile	object	浮水印輸入檔案。目前支援 png 圖片、mov 檔案作為輸入檔案。
Object	string	輸入檔案的 OSS Object。	example-logo-****.png
Location	string	輸入檔案的 OSS Location。	oss-cn-hangzhou
Bucket	string	輸入檔案的 OSS Bucket。	example-bucket
WaterMarkTemplateId	string	浮水印模板 ID。	88c6ca184c0e47098a5b665e2a12****
Dy	string	浮水印圖片相對輸出視頻的垂直位移量。如果在請求參數中設定了此值，則覆蓋浮水印模板對應浮水印圖片相對輸出視頻的垂直位移量。值有兩種形式：整數型：代表浮水印圖片相對輸出視頻的垂直位移量像素。範圍：[8，4096]。單位：px。小數型：代表浮水印圖片相對輸出視頻的垂直位移量比率。範圍：(0,1)。支援 4 位小數，例如：0.9999，超出部分系統自動丟棄。	100
WaterMarkConfigUrl	string	浮水印設定檔 URL。	http://example.com/configure
DeWatermark	string	模糊處理，JSON 對象。更多資訊請參見參數詳情中的模糊處理詳情。	{"0":[{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000":[],"250000":[{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]}
M3U8NonStandardSupport	object	m3u8 非標準支援，JSON 對象。更多資訊請參見參數詳情中的 m3u8 非標準參數支援詳情。
TS	object	JSON 對象，TS 檔案相關非標準支援。更多資訊請參見參數詳情中的 TS 參數支援詳情。
SizeSupport	boolean	是否支援在 m3u8 檔案中輸出 TS 檔案的大小。可取值： true：支援。 false：不支援。	true
Md5Support	boolean	是否支援在 m3u8 檔案中輸出 TS 的 md5 值。可取值： true：支援。 false：不支援。	true
Priority	string	任務在其對應管道內的優先順序。最高優先順序：10。預設值：6。	6
Audio	object	音頻配置。說明如果請求參數中指定了音頻配置則覆蓋指定轉碼模板中的對應參數。
Profile	string	音頻編碼預置。當 Codec 為 aac 時可取值：aaclow、aache、aachev2、aacld、aaceld。	aaclow
Codec	string	音頻編解碼格式。支援 aac、mp3、vorbis、flac。預設值：aac。	aac
Samplerate	string	採樣率。支援 22050、32000、44100、48000、96000。單位：Hz。預設值：44100。說明若視頻容器格式為 flv，音頻編解碼格式選擇為 mp3 時，採樣率不支援 32000、48000、96000；音頻編解碼格式為 mp3 時，採樣率不支援 96000。	44100
Qscale	string	音頻品質控制度。	15
Channels	string	聲道數。支援 1、2、3、4、5、6、7、8。預設值：2。	2
Volume	object	音量配置。
Method	string	音量調整方式。可取值： auto：自動調整。 dynamic：動態調整。 linear：線性調整。	auto
Level	string	音量調整幅度，預設為-20db。	-20
Bitrate	string	輸出檔案的音頻碼率。單位：Kbps。預設值：128。	128
AudioStreamMap	string	音頻流序號。格式：格式：0:a:{序號}，樣本：0:a:0。序號的含義是音頻流列表的下標，序號從 0 開始。若未設定，選擇預設的音頻流。	0:a:0
MergeList	object
Merge	array<object>	拼接設定。最多支援 4 個 MergeURL。
	object	拼接詳細資料。
Start	string	起始時間點。格式：`hh:mm:ss[.SSS]`或者`sssss[.SSS]`。樣本：01:59:59.999 或者 32000.23。	01:59:59.999
RoleArn	string	代理授權使用的角色資訊。	acs:ram:::role/
MergeURL	string	拼接片段地址。樣本：`http://example-bucket-.oss-cn-hangzhou.aliyuncs.com/example-object.flv`。 Object 需要經過 URL Encode，採用 UTF-8 編碼。更多資訊，請參見 URL 編碼說明。	http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv
Duration	string	期間。格式：`hh:mm:ss[.SSS]`或者`sssss[.SSS]`。樣本：01:59:59.999 或者 32000.23。	01:59:59.999
SuperReso	object	解析度隨源。
IsHalfSample	string	是否擷取採樣率相關參數。可取值： true：是。 false：否。	true
UserData	string	使用者自訂資料。	testid-001
ExtendData	string	使用者自訂擴充欄位。	testid-002
OutSubtitleList	object
OutSubtitle	array<object>	輸出字幕列表。
	array<object>	輸出字幕詳情。
Map	string	視頻軌。格式：`0:{流}:{流序號}` ，即`0:v:{video_index}`。流取值為 v: video 音頻流，序號的含義是音頻流列表的下標，序號從 0 開始。	0:v:0
OutSubtitleFile	object	輸出檔案詳細資料。
RoleArn	string	代理授權使用的角色資訊。	acs:ram:::role/
Object	string	輸出檔案的 OSS Object。	example.flv
Location	string	輸出檔案的 OSS Location。	oss-cn-hangzhou
Bucket	string	輸出檔案的 OSS Bucket。	exampleBucket
Success	boolean	是否成功。可取值： true：成功。 false：失敗。	true
Message	string	建立作業失敗時錯誤訊息。建立成功時此參數不返回。	The specified parameter “%s” cannot be null.
VideoStreamMap	string	視頻流序號。序號從 0 開始，序號的含義是視頻流列表的下標，若不設定，選擇預設的視頻流。	0
OutputFile	object	輸出檔案。
RoleArn	string	代理授權使用的角色資訊。	acs:ram:::role/
Object	string	輸出檔案的 OSS Object。	example-output.flv
Location	string	輸出檔案的 OSS Location。	oss-cn-hangzhou
Bucket	string	輸出檔案的 OSS Bucket。	example-bucket
Rotate	string	視頻旋轉角度。	90
Container	object	容器。
Format	string	容器格式。預設值：mp4。視頻轉碼可取值 flv、mp4、HLS（m3u8+ts）、MPEG-DASH（MPD+fMP4）。音頻轉碼可取值 mp3、mp4、ogg、flac、m4a。圖片可取值 gif、WEBP。容器格式為 gif 時，VideoCodec 設定只能設定為 GIF。容器格式為 webp 時，VideoCodec 設定只能設定為 WEBP。容器格式為 flv 時，VideoCodec 不能設定為 H265。	mp4
Clip	object	剪輯片段。
TimeSpan	object	剪輯時間段。
Seek	string	開始時間點。格式：`hh:mm:ss[.SSS]`。樣本：01:59:59.999。或者格式：`sssss[.SSS]`。樣本：32000.23。	01:59:59.999
Duration	string	持續時間長度。格式：`hh:mm:ss[.SSS]`。樣本：01:00:59.999。或者格式：`sssss[.SSS]`。樣本：32000.23。	01:00:59.999
MergeConfigUrl	string	拼接設定檔 URL 地址。MergeList 與 MergeConfigUrl 兩個參數只支援二選一。 MergeConfigUrl 指定的設定檔允許 50 個拼接片段上限。 MergeConfigUrl 是拼接設定檔 URL 地址。只支援存放在 OSS 上的設定檔，且需要保證有授權給 MPS 可存取權限，檔案內部內容參見拼接參數詳情。 mergeConfigfile 檔案內部內容樣本：`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}`。	https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8
OpeningList	object
Opening	array<object>	開板列表，JSON 對象。
	object	開板詳細資料。
openUrl	string	開板視頻的 OSS URL 地址。	http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4
Start	string	相對正片視頻的開始時間。從 0 開始延遲多長時間後，顯示開板視頻。單位：秒。預設值：0。	0
Width	string	寬。範圍：(0,4096)、1、full。 -1 代表片源的值。 full 表示填滿畫面。預設值：-1。	-1
Height	string	高。範圍：(0,4096)、-1、full。 -1 代表片源的值。 full 表示填滿畫面。預設為：-1。	-1
MuxConfig	object	轉碼封包配置。轉碼封包配置。如果請求參數中設定了此參數，則覆蓋指定轉碼模板中的對應參數。
Webp	object	Webp 對應的封包配置。
Loop	string	迴圈次數。	0
Gif	object	Gif 對應的封包配置。
FinalDelay	string	終幀暫停時間。單位：厘秒。	0
DitherMode	string	調色盤顏色抖動方式。可取值：sierra、bayer。	bayer
Loop	string	迴圈次數。	0
IsCustomPalette	string	自訂調色盤功能。可取值： true：自訂。 false：非自訂。	false
Segment	object	切片配置，JSON 對象。
Duration	string	分區時間長度。單位：秒。	20
TailSlateList	object
TailSlate	array<object>	尾板列表。
	object	尾板詳細資料。
Start	string	尾板視頻開始時間。	00000.00
BgColor	string	如果尾板視頻的寬、高小於正片時，設定空白處填充的背景色。預設為 White，取值請參見 bgcolor 。	White
IsMergeAudio	boolean	是否要拼接尾板視頻的音頻內容。可取值： true：拼接。 false：不拼接。	true
Width	string	寬，範圍：（0，4096）、-1、full。 -1 代表片源的值。 full 表示填滿畫面。預設為-1。	-1
Height	string	高。範圍：(0,4096)、-1、full。 -1 代表片源的值。 full 表示填滿畫面。預設為-1。	-1
BlendDuration	string	正片視頻和尾板視訊轉換的時間長度。過渡的效果是淡入淡出：正片顯示最後一幀，同時播放尾板視頻，正片最後一幀逐步變暗，尾板視頻逐步變亮。單位秒，預設 0。	0
TailUrl	string	尾板視頻的 OSS URL 地址。	http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
TemplateId	string	模板 ID。	S00000001-200010
SubtitleConfig	object	字幕配置。
ExtSubtitleList	object
ExtSubtitle	array<object>	外部字幕列表。
	array<object>	字幕詳細資料。
CharEnc	string	外部字幕字元編碼。範圍：UTF-8、GBK、BIG5、auto。預設：auto。說明外部字幕字元編碼設定為 auto 時，存在誤檢情況，建議您指定具體的字元編碼。	auto
FontName	string	外掛字幕轉換成硬字幕對應的字型名稱。預設值：SimSum。更多資訊，請參見字型列表。	"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"
Input	object	外部輸入字幕檔案。目前支援 srt、ass 格式。更多資訊請參見參數詳情中的 Input 參數。樣本：`{“Bucket”:”example-bucket”,“Location”:”oss-cn-hangzhou”,“Object”:”example.srt”}`。
Object	string	輸入檔案的 OSS Object。	example-output.flv
Location	string	輸入檔案所在的 OSS Location。	oss-cn-hangzhou
Bucket	string	輸入檔案所在的 OSS Bucket。	example-bucket-****
SubtitleList	object
Subtitle	array<object>	字幕列表。
	object	字幕詳細資料。
Map	string	音軌。格式：`0:{流}:{流序號}` ，即`0:a:{audio_index}`。流取值為 a: audio 音頻流，序號的含義是音頻流列表的下標，序號從 0 開始。	0:a:0
Properties	object	媒體屬性。
Width	string	視頻寬。	720
Height	string	視頻長。	1280
SourceLogos	object
SourceLogo	array<object>	非引擎層的關鍵字。
	object	關鍵字詳細資料。
Source	string	關鍵字。	example
Duration	string	時間長度。	17
Fps	string	幀率。	30
Bitrate	string	碼率。	490
FileFormat	string	檔案格式。	mp4
Streams	object	流資訊。
VideoStreamList	object
VideoStream	array<object>	視頻流列表。
	array<object>	視頻流詳細資料。
Index	string	視頻流序號，標識視頻流在整個媒體流中的位置。	0
Timebase	string	時基。	1/15360
AvgFPS	string	平均幀率。	30.0
PixFmt	string	像素格式。	yuv420p
Sar	string	編碼訊號解析度比。	1:1
Lang	string	語言。更多資訊，請參見 FFmeg 語言定義、ISO-639。	eng
CodecLongName	string	編碼格式長述名。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Height	string	視頻解析度長。	1280
NumFrames	string	總幀數。	30
Bitrate	string	碼率。	421.117
CodecTagString	string	編碼格式標記文本。	avc1
HasBFrames	string	是否有 B 幀。	2
Profile	string	編碼預置。	high
StartTime	string	開始時間。	0.000000
NetworkCost	object	網路頻寬消耗。
PreloadTime	string	預先載入時間。	8
AvgBitrate	string	平均碼率。	300
CostBandwidth	string	最大消耗頻寬。	10
Dar	string	編碼顯示解析度比。	9:16
CodecName	string	編碼格式簡述名。	h264
Width	string	視頻解析度寬，數字。	720
Duration	string	時間長度。	17.233333
Fps	string	幀率。	30.0
CodecTag	string	編碼格式標記。	0x31637661
CodecTimeBase	string	編碼時基。	1/60
Level	string	編碼等級。	31
colorTransfer	string	色彩轉換。	bt709
colorPrimaries	string	基色、原色。	bt709
bitsPerRawSample	string	每個樣本或像素使用的二進位位元。	8
AudioStreamList	object
AudioStream	array<object>	音頻流列表。
	object	音頻流詳細資料。
Timebase	string	時基。	1/32000
Index	string	音頻流序號，標識音頻流在整個媒體流中的位置。	1
SampleFmt	string	採樣格式。	fltp
ChannelLayout	string	聲道輸出樣式。	mono
Lang	string	語言。更多資訊，請參見 FFmeg 語言定義、ISO-639。	und
Samplerate	string	採樣率。	32000
CodecLongName	string	編碼格式長述名。	AAC (Advanced Audio Coding)
Channels	string	聲道數。	1
NumFrames	string	總幀數。	50
Bitrate	string	碼率。	64.136
CodecTagString	string	編碼格式標記文本。	mp4
StartTime	string	開始時間。	0.064000
CodecName	string	編碼格式簡述名。	aac
Duration	string	時間長度。	17.223562
CodecTag	string	編碼格式標記。	0x6134706d
CodecTimeBase	string	編碼時基。	1/32000
SubtitleStreamList	object
SubtitleStream	array<object>	字幕流列表。
	object	字幕流詳細資料。
Index	string	字幕流序號。標識字幕流在整個媒體流中的位置。	1
Lang	string	語言。更多資訊，請參見 FFmeg 語言定義、ISO-639。	eng
Format	object	格式資訊。
StartTime	string	起始時間。	-0.064000
NumPrograms	string	節目流總數。	0
Size	string	檔案大小。	1057273
NumStreams	string	媒體流總數。	2
FormatLongName	string	容器、封裝格式長述名。	QuickTime / MOV
Duration	string	總時間長度。	17.234000
Bitrate	string	總碼率。	490.784
FormatName	string	容器、封裝格式簡述名。可取值：mov、mp4、m4a、3gp、3g2、mj2。	mov
FileSize	string	檔案大小。	1057273
MultiSpeedInfo	object	倍速作業資訊。使用倍速管道提交的任務才有（老版倍速無該資訊）。
Enable	string	是否開啟倍速開關。	true
Code	string	錯誤碼（未實際啟用倍速時的說明）。	Boost.NotNeedSpeed
Message	string	錯誤資訊（未實際啟用倍速時的說明）。	success
SettingSpeed	integer	設定速率。	30
DowngradePolicy	string	不支援倍速時的降級策略。	NormalSpeed
RealSpeed	number	實際倍速值。	6.576886940181647
Duration	number	輸出視頻時間長度。	21.0
TimeCost	number	任務耗時。	3.193
PipelineId	string	管道 ID。	88c6ca184c0e47b665e2a1267971****
Input	object	作業輸入。
Object	string	輸入檔案的 OSS Object。	video_01.mp4
Location	string	輸入檔案的 OSS Location。	oss-cn-shanghai
Bucket	string	輸入檔案的 OSS Bucket。	exampleBucket
MNSMessageResult	object	MNS 通知使用者作業完成的訊息結果。
MessageId	string	成功時訊息 ID。	123
ErrorMessage	string	失敗時錯誤資訊。執行成功則不返回此參數。	The resource operated “%s” cannot be found.
ErrorCode	string	失敗時錯誤碼。執行成功則不返回此參數。	InvalidParameter.ResourceNotFound
SubmitTime	string	任務出隊提交執行的時間。	2021-03-04T06:44:43Z

回調訊息格式定義

當轉碼任務執行狀態改變時，mps 會發送訊息到使用者指定的 queue 中（如何指定回調 queue 詳見 mps 的更新管道介面）。訊息體是一個 JSON 字串，包含欄位如下：

{
  "Type": "Transcode",
  "State": "Success",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "UserData": "{\"key\":\"value\"}",
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642****"
}

名稱	類型	描述
Type	String	固定字串“Transcode”，表示轉碼任務。
JobId	String	任務唯一 ID。
State	String	任務目前狀態，與 QueryJobList 中的 State 一致。
UserData	String	使用者在 SubmitJobs 中傳入的 UserData。

樣本

正常返回樣本

JSON格式

{
  "NonExistJobIds": {
    "String": [
      "d1ce4d3efcb549419193f50f1fcd****"
    ]
  },
  "RequestId": "197ADF44-104C-514C-9F92-D8924CB34E2A",
  "JobList": {
    "Job": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 100,
        "FinishTime": "2014-01-10T12:20:25Z",
        "State": "TranscodeSuccess",
        "JobId": "31fa3c9ca8134fb4b0b0f7878301****",
        "Code": "InvalidParameter.NullValue",
        "Message": "The specified parameter \"%s\" cannot be null.",
        "Output": {
          "Video": {
            "Bufsize": "6000",
            "Degrain": "5",
            "BitrateBnd": {
              "Max": "1000",
              "Min": "300"
            },
            "PixFmt": "yuv420p",
            "Pad": "1280:800:0:140",
            "Codec": "H.264",
            "Height": "720",
            "Qscale": "15",
            "Crop": "1280:800:0:140",
            "Bitrate": "500",
            "Maxrate": "3000",
            "MaxFps": "60",
            "Profile": "high",
            "Crf": "26",
            "Gop": "250",
            "Width": "1280",
            "Fps": "25",
            "Preset": "medium",
            "ScanMode": "interlaced",
            "ResoPriority": "1"
          },
          "TransConfig": {
            "IsCheckAudioBitrate": "false",
            "TransMode": "onepass",
            "IsCheckReso": "false",
            "IsCheckVideoBitrateFail": "false",
            "AdjDarMethod": "none",
            "IsCheckVideoBitrate": "false",
            "IsCheckResoFail": "false",
            "IsCheckAudioBitrateFail": "false"
          },
          "Encryption": {
            "Type": "hls-aes-128",
            "Key": "encryptionkey128",
            "KeyType": "Base64",
            "Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
            "KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
            "SkipCnt": "3"
          },
          "WaterMarkList": {
            "WaterMark": [
              {
                "Type": "Image",
                "ReferPos": "TopRight",
                "Dx": "100",
                "Width": "50",
                "Height": "50",
                "InputFile": {
                  "Object": "example-logo-****.png",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "example-bucket"
                },
                "WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
                "Dy": "100"
              }
            ]
          },
          "WaterMarkConfigUrl": "http://example.com/configure",
          "DeWatermark": "{\"0\":[{\"l\":10,\"t\":10,\"w\":10,\"h\":10},{\"l\":100,\"t\":0.1,\"w\":10,\"h\":10}],\"128000\":[],\"250000\":[{\"l\":0.2,\"t\":0.1,\"w\":0.01,\"h\":0.05}]}",
          "M3U8NonStandardSupport": {
            "TS": {
              "SizeSupport": true,
              "Md5Support": true
            }
          },
          "Priority": "6",
          "Audio": {
            "Profile": "aaclow",
            "Codec": "aac",
            "Samplerate": "44100",
            "Qscale": "15",
            "Channels": "2",
            "Volume": {
              "Method": "auto",
              "Level": "-20"
            },
            "Bitrate": "128"
          },
          "AudioStreamMap": "0:a:0",
          "MergeList": {
            "Merge": [
              {
                "Start": "01:59:59.999",
                "RoleArn": "acs:ram:::role/",
                "MergeURL": "http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv",
                "Duration": "01:59:59.999"
              }
            ]
          },
          "SuperReso": {
            "IsHalfSample": "true"
          },
          "UserData": "testid-001",
          "ExtendData": "testid-002",
          "OutSubtitleList": {
            "OutSubtitle": [
              {
                "Map": "0:v:0",
                "OutSubtitleFile": {
                  "RoleArn": "acs:ram:::role/",
                  "Object": "example.flv",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "exampleBucket"
                },
                "Success": true,
                "Message": "The specified parameter “%s” cannot be null."
              }
            ]
          },
          "VideoStreamMap": "0",
          "OutputFile": {
            "RoleArn": "acs:ram:::role/",
            "Object": "example-output.flv",
            "Location": "oss-cn-hangzhou",
            "Bucket": "example-bucket"
          },
          "Rotate": "90",
          "Container": {
            "Format": "mp4"
          },
          "Clip": {
            "TimeSpan": {
              "Seek": "01:59:59.999",
              "Duration": "01:00:59.999"
            }
          },
          "MergeConfigUrl": "https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8",
          "OpeningList": {
            "Opening": [
              {
                "openUrl": "http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4",
                "Start": "0",
                "Width": "-1",
                "Height": "-1"
              }
            ]
          },
          "MuxConfig": {
            "Webp": {
              "Loop": "0"
            },
            "Gif": {
              "FinalDelay": "0",
              "DitherMode": "bayer",
              "Loop": "0",
              "IsCustomPalette": "false"
            },
            "Segment": {
              "Duration": "20"
            }
          },
          "TailSlateList": {
            "TailSlate": [
              {
                "Start": "00000.00",
                "BgColor": "White",
                "IsMergeAudio": true,
                "Width": "-1",
                "Height": "-1",
                "BlendDuration": "0",
                "TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
              }
            ]
          },
          "TemplateId": "S00000001-200010",
          "SubtitleConfig": {
            "ExtSubtitleList": {
              "ExtSubtitle": [
                {
                  "CharEnc": "auto",
                  "FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
                  "Input": {
                    "Object": "example-output.flv",
                    "Location": "oss-cn-hangzhou",
                    "Bucket": "example-bucket-****"
                  }
                }
              ]
            },
            "SubtitleList": {
              "Subtitle": [
                {
                  "Map": "0:a:0"
                }
              ]
            }
          },
          "Properties": {
            "Width": "720",
            "Height": "1280",
            "SourceLogos": {
              "SourceLogo": [
                {
                  "Source": "example"
                }
              ]
            },
            "Duration": "17",
            "Fps": "30",
            "Bitrate": "490",
            "FileFormat": "mp4",
            "Streams": {
              "VideoStreamList": {
                "VideoStream": [
                  {
                    "Index": "0",
                    "Timebase": "1/15360",
                    "AvgFPS": "30.0",
                    "PixFmt": "yuv420p",
                    "Sar": "1:1",
                    "Lang": "eng",
                    "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                    "Height": "1280",
                    "NumFrames": "30",
                    "Bitrate": "421.117",
                    "CodecTagString": "avc1",
                    "HasBFrames": "2",
                    "Profile": "high",
                    "StartTime": "0.000000",
                    "NetworkCost": {
                      "PreloadTime": "8",
                      "AvgBitrate": "300",
                      "CostBandwidth": "10"
                    },
                    "Dar": "9:16",
                    "CodecName": "h264",
                    "Width": "720",
                    "Duration": "17.233333",
                    "Fps": "30.0",
                    "CodecTag": "0x31637661",
                    "CodecTimeBase": "1/60",
                    "Level": "31",
                    "colorTransfer": "bt709",
                    "colorPrimaries": "bt709",
                    "bitsPerRawSample": "8"
                  }
                ]
              },
              "AudioStreamList": {
                "AudioStream": [
                  {
                    "Timebase": "1/32000",
                    "Index": "1",
                    "SampleFmt": "fltp",
                    "ChannelLayout": "mono",
                    "Lang": "und",
                    "Samplerate": "32000",
                    "CodecLongName": "AAC (Advanced Audio Coding)",
                    "Channels": "1",
                    "NumFrames": "50",
                    "Bitrate": "64.136",
                    "CodecTagString": "mp4",
                    "StartTime": "0.064000",
                    "CodecName": "aac",
                    "Duration": "17.223562",
                    "CodecTag": "0x6134706d",
                    "CodecTimeBase": "1/32000"
                  }
                ]
              },
              "SubtitleStreamList": {
                "SubtitleStream": [
                  {
                    "Index": "1",
                    "Lang": "eng"
                  }
                ]
              }
            },
            "Format": {
              "StartTime": "-0.064000",
              "NumPrograms": "0",
              "Size": "1057273",
              "NumStreams": "2",
              "FormatLongName": "QuickTime / MOV",
              "Duration": "17.234000",
              "Bitrate": "490.784",
              "FormatName": "mov"
            },
            "FileSize": "1057273"
          },
          "MultiSpeedInfo": {
            "Enable": "true",
            "Code": "Boost.NotNeedSpeed",
            "Message": "success",
            "SettingSpeed": 30,
            "DowngradePolicy": "NormalSpeed",
            "RealSpeed": 6.576886940181647,
            "Duration": 21,
            "TimeCost": 3.193
          }
        },
        "PipelineId": "88c6ca184c0e47b665e2a1267971****",
        "Input": {
          "Object": "video_01.mp4",
          "Location": "oss-cn-shanghai",
          "Bucket": "exampleBucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "The resource operated “%s” cannot be found.",
          "ErrorCode": "InvalidParameter.ResourceNotFound"
        },
        "SubmitTime": "2021-03-04T06:44:43Z"
      }
    ]
  }
}

錯誤碼

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

變更歷史

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