調用SubmitJobs介面提交轉碼作業-ApsaraVideo for Media Processing-阿里雲

提交轉碼作業。當控制台建立的轉碼任務和工作流程均無法滿足您的使用情境時，可以按需調用SubmitJobs介面進行轉碼。根據您的商務邏輯配置所需的轉碼參數即可。

介面說明

轉碼作業為非同步執行，不保證時效性。在提交轉碼作業後，任務會添加到管道中排隊，被調度執行。所以在介面返回時，不保證轉碼已經完成。執行完成後需要調用查詢轉碼作業介面輪詢執行結果，或通過為管道綁定 MNS 訊息接收執行結果，詳細操作請參見接收訊息通知。
輸入單個檔案大小最大支援 100 GB，超過可能導致執行失敗。
使用預置智能模板對輸入檔案進行轉碼時，必須要先調用提交預置模板分析作業介面（ SubmitAnalysisJob ），分析作業成功完成後可以通過調用查詢範本分析作業介面（ QueryAnalysisJobList ）擷取該輸入檔案的可用預置模板列表。在提交轉碼作業時，將 TemplateId 參數設定為可用的預置模板 ID 即可。若提交的轉碼作業中指定的模板不在可用的預置模板列表中，會導致轉碼作業失敗。
使用預置靜態模板對輸入檔案進行轉碼時，不需要提交模板分析作業。
如需在 MPS 服務中使用多個帳號，可以為阿里雲帳號建立 RAM 使用者，詳細說明請參見建立 RAM 使用者並授權。如果提交轉碼作業和查詢轉碼作業使用的是不同的阿里雲帳號，則會導致查詢不到資料。
更多轉碼常見問題，請參見ApsaraVideo for Media Processing常見問題。

QPS 限制

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

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:SubmitJobs

create

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
Input	string	是	作業輸入。詳細說明，請參見 Input 詳情。說明在ApsaraVideo for Media Processing API 中，Object 必須經過 URL Encoding（基於 UTF-8 編碼）後使用。 OSS 的地區需要與當前 MPS 所在地區保持一致。	{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "使用者自行在OSS控制台設定的OSS防盜鏈參數"}
Outputs	string	是	作業輸出配置。詳細說明，請參見 Output 詳情。 Outputs 由 Output 列表構成，JSON 數組，大小上限為 30。	[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff**","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47**"}],"UserData":"testid-001"}]
OutputBucket	string	是	輸出檔案所在的 OSS Bucket。遵守 OSS Bucket 定義，更多資訊請參見基本概念。	exampleBucket
OutputLocation	string	否	輸出檔案所在的 OSS Bucket 的地區（OSS Region）。 OSS Bucket 必須與ApsaraVideo for Media Processing服務在同一個地區。遵守 OSS Bucket 定義，更多資訊請參見基本概念。	oss-cn-hangzhou
PipelineId	string	是	管道 ID。更多資訊，請參見基本概念。可以通過 MPS 控制台 > 全域設定 > 管道及回調查詢。如果需要非同步通知，請為管道綁定 MNS 訊息。詳細操作，請參見接收訊息通知。	dd3dae411e704030b921e52698e5****

返回參數

名稱	類型	描述	樣本值
	object	返回參數。
JobResultList	object
JobResult	array<object>	提交轉碼作業結果清單。
	array<object>	返回參數。
Code	string	建立作業失敗時錯誤碼。建立成功時此參數不返回。	InvalidParameter.NullValue
Job	object	作業詳細資料。如果提交失敗則不會產生作業 ID。
Code	string	轉碼失敗時的錯誤碼。轉碼成功時不返回。	InternalError
CreationTime	string	作業添加時間。	2014-01-10T12:00:00Z
FinishTime	string	作業完成時間。	2014-01-10T12:20:00Z
Input	object	作業輸入。
Bucket	string	作業輸入的 OSS Bucket。	example-bucket-****
Location	string	作業輸入的 OSS Location。	oss-cn-hangzhou
Object	string	作業輸入的 OSS Object。	example.flv
JobId	string	任務 ID。	31fa3c9ca8134f9cec2b4b0b0f78****
MNSMessageResult	object	MNS 通知使用者作業完成的訊息結果。
ErrorCode	string	失敗時錯誤碼。成功時此參數不返回。	InvalidParameter.ResourceNotFound
ErrorMessage	string	失敗時錯誤資訊。成功時此參數不返回。	The resource operated "%s" cannot be found.
MessageId	string	失敗時錯誤資訊 ID。成功時此參數不返回。	123
Message	string	轉碼失敗時的訊息。轉碼成功時不返回。	The operation has failed due to some unknown error, exception or failure.
Output	object	作業輸出。
AmixList	object
Amix	array<object>	混音列表。
	object	返回參數。
AmixURL	string	需要被混音的背景音軌媒體。可取值：OSS 地址或字串`"input"`。 input 情境：同一視頻兩路音軌合并。	https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3
Duration	string	持續時間長度。數字或時間格式。	20
Map	string	在 AmixURL 中選取目標音軌，取值為：0:a:{audio_index}, 如 0:a:0。	0:a:0
MixDurMode	string	媒體時間長度取值。可取值：first、long。 first：輸出媒體的時間長度以輸入媒體的時間長度為準。 long：輸出媒體的時間長度以兩個媒體中時間長度最長的為準。預設值：long。	long
Start	string	起始時間。數字或時間格式例如："1:25:36.240"， "32000.23"。	0
Audio	object	音頻配置。說明如果請求參數中指定了音頻配置則覆蓋指定轉碼模板中的對應參數。
Bitrate	string	輸出檔案的音頻碼率。單位：Kbps。預設值：128。	128
Channels	string	聲道數。當 Codec 設定為 mp3 時，聲道數只支援 1、2。當 Codec 設定為 aac 時，聲道數只支援 1、2、4、5、6、8。預設值：2。	6
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
Qscale	string	音頻品質控制度。	15
Samplerate	string	採樣率。支援 22050、32000、44100、48000、96000。單位：Hz。預設值：44100。說明若視頻容器格式為 flv，音頻編解碼格式選擇為 mp3 時，採樣率不支援 32000、48000、96000；音頻編解碼格式為 mp3 時，採樣率不支援 96000。	32000
Volume	object	音量控置。
Level	string	音量調整幅度單位：db。預設：-20db。	-20
Method	string	音量調整方式。可取值： auto：自動調整。 dynamic：動態調整。 linear：線性調整。	auto
AudioStreamMap	string	音頻流序號。格式：格式：0:a:{序號}，樣本：0:a:0。序號的含義是音頻流列表的下標，序號從 0 開始。若未設定，選擇預設的音頻流。	0:a:0
Clip	object	剪輯片段。
TimeSpan	object	剪輯時間段。
Duration	string	延續時間。格式：`hh:mm:ss[.SSS]`或`sssss[.SSS]`。取值範圍：`[00:00:00.000,23:59:59.999]`或`[0.000，86399.999]`。	01:00:59.999
Seek	string	開始時間。格式：`hh:mm:ss[.SSS]`或`sssss[.SSS]`。取值範圍：`[00:00:00.000,23:59:59.999]`或`[0.000，86399.999]`。	01:59:59.999
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。	flv
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}]}
DigiWaterMark	object	數字浮水印。
Alpha	string	文字或圖片的透明度。取值範圍：(0,1]。預設值：1.0。	1.0
InputFile	object	輸入檔案。
Bucket	string	輸入檔案的 OSS Bucket。	example-bucket-****
Location	string	輸入檔案的 OSS Location。	oss-cn-hangzhou
Object	string	輸入檔案的 OSS Object。	example-intput.flv
Type	string	浮水印類型。如果設定過浮水印類型，則此值覆蓋浮水印模板對應參數。可取值： Image：預設值，圖片浮水印。 Text：文字浮水印。	Image
Encryption	object	資料加密，只支援 m3u8 格式的輸出。
Id	string	加密 ID。	31fa3c9ca8134f9cec2b4b0b0f78****
Key	string	加密視頻的密鑰。	encryptionkey128
KeyType	string	密鑰 Key 不能明文傳輸給 MPS，需要加密，方式為 Base64 或 KMS。如密鑰為"encryptionkey128”, 則 Base64(“encryptionkey128”)，或 KMS(Base64(“encryptionkey128”)。	Base64
KeyUri	string	密鑰的存取 URL，使用 BASE64 進行編碼。	https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/
SkipCnt	string	前面不加密的片數（視頻能快速播放起來）。	3
Type	string	加密類型。取值：hls-aes-128。	hls-aes-128
M3U8NonStandardSupport	object	M3U8 非標準支援，JSON 對象。更多資訊請參見參數詳情中的M3U8 非標準參數支援詳情。
TS	object	JSON 對象，TS 檔案相關非標準支援。更多資訊請參見參數詳情中的TS 參數支援詳情。
Md5Support	boolean	是否支援在 M3U8 檔案中輸出 TS 的 md5 值。可取值： true：支援。 false：不支援。	true
SizeSupport	boolean	是否支援在 M3U8 檔案中輸出 TS 檔案的大小。可取值： true：支援。 false：不支援。	true
MergeConfigUrl	string	MergeList 與 MergeConfigUrl 兩個參數只支援二選一。 MergeConfigUrl 指定的設定檔允許 50 個拼接片段上限。 MergeConfigUrl 是拼接設定檔 URL 地址。只支援存放在 OSS 上的設定檔，且需要保證有授權給 MPS 可存取權限，檔案內部內容參見拼接參數詳情。 mergeConfigfile 檔案內部內容樣本：`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}` 。	`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}
MergeList	object
Merge	array<object>	視頻拼接配置。
	object	視頻拼接配置詳細資料。
Duration	string	期間。格式：`hh:mm:ss[.SSS]`或者`sssss[.SSS]`。樣本：01:59:59.999 或者 32000.23。	00000.20
MergeURL	string	拼接片段地址。樣本：`http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/example-object-**.flv` Object 需要經過 URLEncode，採用 UTF-8 編碼。	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/example-object-**.flv
RoleArn	string	代理授權使用的角色資訊。	acs:ram:::role/
Start	string	起始時間點。格式：`hh:mm:ss[.SSS]`或者`sssss[.SSS]`。樣本：01:59:59.999 或者 32000.23。	00000.50
MuxConfig	object	轉碼封包配置。如果請求參數中設定了此參數，則覆蓋指定轉碼模板中的對應參數。
Gif	object	Gif 對應的封包配置。
DitherMode	string	調色盤顏色抖動方式。可取值：sierra、bayer。	bayer
FinalDelay	string	終幀暫停時間，單位：厘秒。	0
IsCustomPalette	string	自訂調色盤功能。可取值： true：自訂 false：非自訂。	false
Loop	string	迴圈次數。	0
Segment	object	切片配置，JSON 對象。
Duration	string	分區時間長度。整數，單位：秒。可取值範圍：[1,10]。預設值：10 秒。	20
Webp	object	Webp 對應的封包配置。
Loop	string	迴圈次數。	0
OpeningList	object
Opening	array<object>	開板列表，JSON 對象。
	object	返回參數。
Height	string	高。可取值：0~4096、-1、full。預設值：-1。 -1代表片源的值， full 表示填滿畫面。	1080
Start	string	相對正片視頻的開始時間。從 0 開始延遲多長時間後，顯示開板視頻。單位：秒。預設值：0。	1
Width	string	寬。可取值：0~4096、-1、full。預設值：-1。 -1代表片源的值。 full 表示填滿畫面。	1920
openUrl	string	開板視頻的 OSS URL 地址。	http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
OutSubtitleList	object
OutSubtitle	array<object>	輸出字幕列表。
	array<object>	輸出字幕詳情。
Map	string	視頻軌。格式：`0:{流}:{流序號}` ，即`0:v:{video_index}`。流取值為 v: video 音頻流，序號的含義是音頻流列表的下標，序號從 0 開始。	0:v:0
Message	string	建立作業失敗時錯誤訊息。建立成功時此參數不返回。	The specified parameter “%s” cannot be null.
OutSubtitleFile	object	輸出檔案詳細資料。
Bucket	string	輸入檔案的 OSS Bucket。	example-bucket-****
Location	string	輸出檔案的 OSS Location。	oss-cn-hangzhou
Object	string	輸出檔案的 OSS Object。	example-output.flv
RoleArn	string	代理授權使用的角色資訊。	acs:ram:::role/
Success	boolean	是否成功。可取值： true：成功。 false：失敗。	true
OutputFile	object	輸出檔案。
Bucket	string	輸入檔案的 OSS Bucket。	example-bucket-****
Location	string	輸出檔案的 OSS Location。	oss-cn-hangzhou
Object	string	輸出檔案的 OSS Object。	example-output.flv
RoleArn	string	代理授權使用的角色資訊。	acs:ram:::role/
Priority	string	任務在其對應管道內的優先順序。最高優先順序：10。預設值：6。	5
Properties	object	媒體屬性。
Bitrate	string	碼率。	1000
Duration	string	時間長度。	55
FileFormat	string	檔案格式。	QuickTime / MOV
FileSize	string	檔案大小。	3509895
Format	object	格式資訊。
Bitrate	string	總碼率。	1000
Duration	string	總時間長度。	55
FormatLongName	string	容器、封裝格式長述名。	QuickTime / MOV
FormatName	string	容器、封裝格式簡述名。可取值：mov、mp4、m4a、3gp、3g2、mj2。	mov
NumPrograms	string	節目流總數。	0
NumStreams	string	媒體流總數。	2
Size	string	檔案大小。	3509895
StartTime	string	起始時間。	0.000000
Fps	string	幀率，數字。	25
Height	string	視頻長。	720
Streams	object	流資訊。
AudioStreamList	object
AudioStream	array<object>	音頻流列表。
	object	音頻流詳細資料。
Bitrate	string	碼率。	128.806
ChannelLayout	string	聲道輸出樣式。	stereo
Channels	string	聲道數。	2
CodecLongName	string	編碼格式長述名。	AAC (Advanced Audio Coding)
CodecName	string	編碼格式簡述名。	aac
CodecTag	string	編碼格式標記。	0x6134706d
CodecTagString	string	編碼格式標記文本。	mp4a
CodecTimeBase	string	編碼時基。	1/44100
Duration	string	時間長度。	17.159546
Index	string	音頻流序號。標識音頻流在整個媒體流中的位置。	1
Lang	string	語言。更多資訊，請參見 FFmeg 語言定義、ISO-639。	eng
NumFrames	string	總幀數。	25
SampleFmt	string	採樣格式。	fltp
Samplerate	string	採樣率。	44100
StartTime	string	起始時間。	0.000000
Timebase	string	時基。	1/44100
SubtitleStreamList	object
SubtitleStream	array<object>	字幕流列表。
	object	字幕流詳細資料。
Index	string	字幕流序號，標識字幕流在整個媒體流中的位置。	1
Lang	string	語言。更多資訊，請參見 FFmeg 語言定義、ISO-639。	eng
VideoStreamList	object
VideoStream	array<object>	視頻流列表。
	array<object>	視頻流詳細資料。
AvgFPS	string	平均幀率。	23.976025
Bitrate	string	碼率。	1496.46
CodecLongName	string	編碼格式長述名。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
CodecName	string	編碼格式簡述名。	h264
CodecTag	string	編碼格式標記。	0x31637661
CodecTagString	string	編碼格式標記文本。	avc1
CodecTimeBase	string	編碼時基。	1001/48000
Dar	string	編碼顯示解析度比。	16:9
Duration	string	時間長度。	17.225542
Fps	string	幀率。	23.976025
HasBFrames	string	是否有 B 幀。	2
Height	string	視頻解析度長。	720
Index	string	視頻流序號，標識視頻流在整個媒體流中的位置。	0
Lang	string	語言。更多資訊，請參見 FFmeg 語言定義、ISO-639。	eng
Level	string	編碼等級。	51
NetworkCost	object	網路頻寬消耗。
AvgBitrate	string	平均碼率。	100
CostBandwidth	string	最大消耗頻寬。	10
PreloadTime	string	預先載入時間。	8
NumFrames	string	總幀數。	25
PixFmt	string	像素格式。	yuv420p
Profile	string	編碼預置。	high
Sar	string	編碼訊號解析度比。	1:1
StartTime	string	起始時間。	0.000000
Timebase	string	時基。	1/24000
Width	string	視頻解析度寬，數字。	1280
Width	string	視頻寬。	1280
Rotate	string	視頻順時針旋轉角度。	180
SubtitleConfig	object	字幕配置資訊。
ExtSubtitleList	object
ExtSubtitle	array<object>	外部字幕列表，JSON 數組，最多 4 個。
	array<object>	外部字幕詳細資料。
CharEnc	string	外部字幕字元編碼。範圍：UTF-8、GBK、BIG5、auto。預設：auto。說明外部字幕字元編碼設定為 auto 時，存在誤檢情況，建議您指定具體的字元編碼。	UTF-8
FontName	string	外掛字幕轉換成硬字幕對應的字型名稱。預設值：SimSun。更多字型資訊請參見字型列表。	"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"
Input	object	JSON 對象，外部輸入字幕檔案。目前支援 srt、ass 格式。
Bucket	string	輸入檔案所在的 OSS Bucket。	example-bucket-****
Location	string	輸入檔案所在的 OSS Location。	oss-cn-hangzhou
Object	string	輸入檔案的 OSS Object。	example-output.flv
SubtitleList	object
Subtitle	array<object>	字幕列表。
	object	返回參數。
Map	string	音軌。格式：`0:{流}:{流序號}` ，即`0:a:{audio_index}`。流取值為 a: audio 音頻流，序號的含義是音頻流列表的下標，序號從 0 開始。	0:a:0
SuperReso	object	解析度隨源。
IsHalfSample	string	是否擷取採樣率相關參數。可取值： true：是。 false：否。	true
TailSlateList	object
TailSlate	array<object>	尾板列表，JSON 對象。
	object	返回參數。
BgColor	string	如果尾板視頻的寬、高小於正片時，設定空白處填充的背景色。預設為 White，更多取值請參見 bgcolor 。	White
BlendDuration	string	正片視頻和尾板視訊轉換的時間長度。過渡的效果是淡入淡出：正片顯示最後一幀，同時播放尾板視頻，正片最後一幀逐步變暗，尾板視頻逐步變亮。單位秒，預設 0。	2
Height	string	高。可取值：0~4096、-1、full。 -1代表片源的值，full 表示填滿畫面。預設為-1。	1080
IsMergeAudio	boolean	是否要拼接尾板視頻的音頻內容。可取值： true：拼接。 false：不拼接。	false
Start	string	開始時間。	1
TailUrl	string	尾板視頻的 OSS URL 地址。	http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
Width	string	寬。可取值：0~4096、-1、full。 -1代表片源的值，full 表示填滿畫面。預設為-1。	1920
TemplateId	string	轉碼模板 ID。	S00000000-000010
TransConfig	object	轉碼通用配置。說明如果請求參數中設定了該值，則覆蓋指定轉碼模板中的對應參數。
AdjDarMethod	string	解析度改寫方式。預設值：none。可取值： rescale：重新做 scale。 crop：裁剪。 pad：填充。 none：不改寫。	crop
IsCheckAudioBitrate	string	是否檢查音頻碼率。當輸出音頻碼率大於媒體源音頻碼率時，則視為輸出音頻碼率等於媒體源音頻碼率，即設定的音頻碼率參數不會生效。此值優先順序小於 IsCheckAudioBitrateFail。 true 表示檢查。 false 表示不檢查。預設值：參數為空白，並且 codec 和輸入源不一樣：false。參數為空白，並且 codec 和輸入源一樣：true。	false
IsCheckAudioBitrateFail	string	是否檢查音頻碼率。此值優先順序大於 IsCheckAudioBitrate。當輸出音頻碼率大於媒體源音頻碼率時，不進行轉碼，直接返迴轉碼失敗。 false：檢查。 true：不檢查。	true
IsCheckReso	string	是否檢查解析度。如果輸出解析度大於輸入解析度（判斷條件是寬或高），則視為輸出解析度等於輸入解析度。 true 表示檢查。 false 表示不檢查。預設值：false。	false
IsCheckResoFail	string	是否檢查解析度。此值優先順序大於 IsCheckReso。如果輸出解析度大於輸入解析度（判斷條件是寬或高），不進行轉碼，直接返迴轉碼失敗。 true：檢查。 false：不檢查。預設值：false。	false
IsCheckVideoBitrate	string	是否檢查視頻碼率。如果視頻輸出碼率大於視頻輸入碼率，則視為視頻輸出碼率等於視頻輸入碼率。 true 表示檢查。 false 表示不檢查。預設值：false。	false
IsCheckVideoBitrateFail	string	是否檢查碼率。當輸出視頻碼率大於媒體源視頻碼率時，則不進行轉碼，直接返迴轉碼失敗。此值優先順序大於 IsCheckVideoBitrate。 true 表示檢查。 false 表示不檢查。預設值：false。	true
TransMode	string	轉碼模式。可取值： onepass：基於 One-Pass 演算法，準確性較好。 twopass：基於 Two-Pass 演算法，準確性較差。 CBR：Constant bit rate，固定碼率。	onepass
UserData	string	使用者自訂資料。	example data
Video	object	視頻配置。說明指定則替換 TemplateId 所指定模板的 AliyunVideoCodec 設定。
Bitrate	string	視頻輸出檔案的碼率。單位：Kbps。	10
BitrateBnd	object	視頻平均碼率範圍。
Max	string	總碼率上限。單位：Kbps。	20
Min	string	總碼率下限。單位：Kbps。	10
Bufsize	string	緩衝區大小。單位：Kb。預設值：6000。	1000
Codec	string	編解碼格式。支援H.264、H.265、GIF、WEBP。預設值：H.264。	H.264
Crf	string	碼率-品質控制因子。如果設定了 Crf，則 Bitrate 的設定失效。預設值：編碼格式為 H264，預設值為 23。編碼格式為 H265，預設值為 26。	22
Crop	string	視頻畫面裁切。支援 2 種方式：自動檢測黑邊並裁切：設定為 border。自訂裁切：參數格式為 width:height:left:top。	1280:800:0:140
Degrain	string	獨立去噪演算法強度。	5
Fps	string	幀率。單位：fps。可取值範圍：0~60，當輸入檔案幀率超過 60 時取 60。預設值：取輸入檔案幀率。	60
Gop	string	主要畫面格間最大時間間隔或最大幀數。單位：秒（s）。預設值：10s。最大幀數時無單位。	1
Height	string	高。單位：px。預設值：視頻原始高度。	1280
MaxFps	string	最大幀率。	15
Maxrate	string	視頻碼率峰值。單位：Kbps。	10
Pad	string	視頻貼黑邊。參數格式：width:height:left:top。單位：px。	1280:800:0:140
PixFmt	string	視頻顏色格式。預設值：yuv420p 或原始顏色格式。可取值：yuv420p，yuvj420p 等標準顏色格式。說明非標準顏色格式（比如：yuvj420p(pc, bt470bg/bt470bg/smpte170m）需要配置相容，否則會導致轉碼失敗。	yuvj420p
Preset	string	視頻演算法器預置。預設值：medium。可取值： veryfast：超快。 fast：快。 medium：中等。 slow：慢。 slower：超慢。	veryfast
Profile	string	編碼層級，目前僅 H264 支援此參數。預設值：high，可取值：說明如果您有多個清晰度，建議最低清晰度配置成 baseline，以保證最低端裝置可播放。其他清晰度配置為 main 或 high。 baseline：針對行動裝置。 main：針對標準解析度裝置。 high：針對高解析度裝置。	baseline
Qscale	string	視頻品質控制值。	15
ResoPriority	string	資源優先順序。	1
ScanMode	string	掃描模式。取值如下：不設定：按輸入檔案的原始模式。 auto：自動去隔行。 progressive：順序掃描（漸進式掃描）。 interlaced：交叉掃描（隔行掃描）。預設值：空，即不設定。最佳實務：交叉掃描雖然比順序掃描更節省資料量，但畫質不佳，所以現在主流視頻製作都採用順序掃描。如果您設定了順序掃描或交叉掃描，但與原視頻模式不符，會導致轉碼失敗。建議您設定原視頻模式或自動去隔行，以提高相容性。	interlaced
Width	string	寬。單位：px。預設值：視頻原始寬度。	1080
VideoStreamMap	string	視頻流序號。格式：格式：0:a:{序號}，樣本：0:a:0。序號的含義是音頻流列表的下標，序號從 0 開始。若未設定，選擇預設的視頻流。	0:a:0
WaterMarkConfigUrl	string	浮水印設定檔 URL。	http://example.com/configure
WaterMarkList	object
WaterMark	array<object>	浮水印列表。說明如果浮水印輸出截斷或失敗，請先檢查您添加的文本浮水印中是否包含特殊字元，如有，則需要對特殊字元進行轉義後再傳入，或提交工單聯絡阿里雲客服進行相容處理。
	array<object>	浮水印詳細資料。
Dx	string	浮水印圖片相對輸出視頻的水平位移量。如果請求參數中設定了此值，則覆蓋浮水印模板對應參數。預設值為 0。值有兩種形式：整數型：代表位移像素值。範圍：[8,4096]。單位：px。小數型：代表水平位移量與輸出解析度寬的比率。範圍：（0,1)。支援四位小數，例如：0.9999，超出部分系統自動丟棄。	1
Dy	string	浮水印圖片相對輸出視頻的垂直位移量。如果在請求參數中設定了此值，則覆蓋浮水印模板對應浮水印圖片相對輸出視頻的垂直位移量。值有兩種形式：整數型：代表浮水印圖片相對輸出視頻的垂直位移量像素。範圍：[8，4096]。單位：px。小數型：代表浮水印圖片相對輸出視頻的垂直位移量比率。範圍：(0,1)。支援 4 位小數，例如：0.9999，超出部分系統自動丟棄。	1
Height	string	浮水印圖片高。如果在請求參數中設定了此值，則覆蓋浮水印模板對應浮水印圖片高。值有兩種形式：整數型：代表浮水印圖片高的像素值。範圍：[8，4096]。單位：px。小數型：代表相對輸出視頻解析度高的比率。範圍：(0,1)。支援 4 位小數，例如：0.9999，超出部分系統自動丟棄。	1280
InputFile	object	浮水印輸入檔案。目前支援 png 圖片、mov 檔案作為輸入檔案。
Bucket	string	輸入檔案的 OSS Bucket。	example-bucket
Location	string	輸入檔案的 OSS Location。	oss-cn-hangzhou
Object	string	輸入檔案的 OSS Object。	example-logo-****.png
ReferPos	string	浮水印的位置。如果請求參數中設定了此值，則覆蓋浮水印模板對應參數。可取值： TopRight：右上。 TopLeft：左上。 BottomRight：右下。 BottomLeft：左下。	TopRight
Type	string	浮水印類型。如果請求參數中設定了此參數，則此值覆蓋浮水印模板對應參數。更多資訊，請參見參數詳情。可取值： Image：圖片浮水印。 Text：文字浮水印。	Image
WaterMarkTemplateId	string	浮水印模板 ID。	88c6ca184c0e47098a5b665e2a12****
Width	string	浮水印圖片寬。如果在請求參數中設定了此值，則覆蓋浮水印模板對應浮水印圖片寬。值有兩種形式：整數型：代表浮水印圖片寬的像素值。範圍：[8，4096]。單位：px。小數型：代表相對輸出視頻解析度寬的比率。範圍：(0,1)。支援 4 位小數，例如：0.9999，超出部分系統自動丟棄。	1080
Percent	integer	轉碼進度。	100
PipelineId	string	管道 ID。	88c6ca184c0e47098a5b665e2a126797
State	string	作業狀態。 Submitted：作業已提交。 TranscodeFail：轉碼失敗。	Submitted
Message	string	建立作業失敗時錯誤訊息。建立成功時此參數不返回。	The specified parameter "%s" cannot be null.
Success	boolean	是否成功。可取值： true：成功。 false：失敗。	true
RequestId	string	請求 ID。	25818875-5F78-4A45S71F6-D73936451234

樣本

正常返回樣本

JSON格式

{
  "JobResultList": {
    "JobResult": [
      {
        "Code": "InvalidParameter.NullValue",
        "Job": {
          "Code": "InternalError",
          "CreationTime": "2014-01-10T12:00:00Z",
          "FinishTime": "2014-01-10T12:20:00Z",
          "Input": {
            "Bucket": "example-bucket-****",
            "Location": "oss-cn-hangzhou",
            "Object": "example.flv"
          },
          "JobId": "31fa3c9ca8134f9cec2b4b0b0f78****",
          "MNSMessageResult": {
            "ErrorCode": "InvalidParameter.ResourceNotFound",
            "ErrorMessage": "The resource operated \"%s\" cannot be found.",
            "MessageId": "123"
          },
          "Message": "The operation has failed due to some unknown error, exception or failure.",
          "Output": {
            "AmixList": {
              "Amix": [
                {
                  "AmixURL": "https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3",
                  "Duration": "20",
                  "Map": "0:a:0",
                  "MixDurMode": "long",
                  "Start": "0"
                }
              ]
            },
            "Audio": {
              "Bitrate": "128",
              "Channels": "6",
              "Codec": "aac",
              "Profile": "aac_low",
              "Qscale": "15",
              "Samplerate": "32000",
              "Volume": {
                "Level": "-20",
                "Method": "auto"
              }
            },
            "AudioStreamMap": "0:a:0",
            "Clip": {
              "TimeSpan": {
                "Duration": "01:00:59.999",
                "Seek": "01:59:59.999"
              }
            },
            "Container": {
              "Format": "flv"
            },
            "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}]}",
            "DigiWaterMark": {
              "Alpha": "1.0",
              "InputFile": {
                "Bucket": "example-bucket-****",
                "Location": "oss-cn-hangzhou",
                "Object": "example-intput.flv"
              },
              "Type": "Image"
            },
            "Encryption": {
              "Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
              "Key": "encryptionkey128",
              "KeyType": "Base64",
              "KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
              "SkipCnt": "3",
              "Type": "hls-aes-128"
            },
            "M3U8NonStandardSupport": {
              "TS": {
                "Md5Support": true,
                "SizeSupport": true
              }
            },
            "MergeConfigUrl": "`{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}",
            "MergeList": {
              "Merge": [
                {
                  "Duration": "00000.20",
                  "MergeURL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv",
                  "RoleArn": "acs:ram:::role/",
                  "Start": "00000.50"
                }
              ]
            },
            "MuxConfig": {
              "Gif": {
                "DitherMode": "bayer",
                "FinalDelay": "0",
                "IsCustomPalette": "false",
                "Loop": "0"
              },
              "Segment": {
                "Duration": "20"
              },
              "Webp": {
                "Loop": "0"
              }
            },
            "OpeningList": {
              "Opening": [
                {
                  "Height": "1080",
                  "Start": "1",
                  "Width": "1920",
                  "openUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
                }
              ]
            },
            "OutSubtitleList": {
              "OutSubtitle": [
                {
                  "Map": "0:v:0",
                  "Message": "The specified parameter “%s” cannot be null.",
                  "OutSubtitleFile": {
                    "Bucket": "example-bucket-****",
                    "Location": "oss-cn-hangzhou",
                    "Object": "example-output.flv",
                    "RoleArn": "acs:ram:::role/"
                  },
                  "Success": true
                }
              ]
            },
            "OutputFile": {
              "Bucket": "example-bucket-****",
              "Location": "oss-cn-hangzhou",
              "Object": "example-output.flv",
              "RoleArn": "acs:ram:::role/"
            },
            "Priority": "5",
            "Properties": {
              "Bitrate": "1000",
              "Duration": "55",
              "FileFormat": "QuickTime / MOV",
              "FileSize": "3509895",
              "Format": {
                "Bitrate": "1000",
                "Duration": "55",
                "FormatLongName": "QuickTime / MOV",
                "FormatName": "mov",
                "NumPrograms": "0",
                "NumStreams": "2",
                "Size": "3509895",
                "StartTime": "0.000000"
              },
              "Fps": "25",
              "Height": "720",
              "Streams": {
                "AudioStreamList": {
                  "AudioStream": [
                    {
                      "Bitrate": "128.806",
                      "ChannelLayout": "stereo",
                      "Channels": "2",
                      "CodecLongName": "AAC (Advanced Audio Coding)",
                      "CodecName": "aac",
                      "CodecTag": "0x6134706d",
                      "CodecTagString": "mp4a",
                      "CodecTimeBase": "1/44100",
                      "Duration": "17.159546",
                      "Index": "1",
                      "Lang": "eng",
                      "NumFrames": "25",
                      "SampleFmt": "fltp",
                      "Samplerate": "44100",
                      "StartTime": "0.000000",
                      "Timebase": "1/44100"
                    }
                  ]
                },
                "SubtitleStreamList": {
                  "SubtitleStream": [
                    {
                      "Index": "1",
                      "Lang": "eng"
                    }
                  ]
                },
                "VideoStreamList": {
                  "VideoStream": [
                    {
                      "AvgFPS": "23.976025",
                      "Bitrate": "1496.46",
                      "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                      "CodecName": "h264",
                      "CodecTag": "0x31637661",
                      "CodecTagString": "avc1",
                      "CodecTimeBase": "1001/48000",
                      "Dar": "16:9",
                      "Duration": "17.225542",
                      "Fps": "23.976025",
                      "HasBFrames": "2",
                      "Height": "720",
                      "Index": "0",
                      "Lang": "eng",
                      "Level": "51",
                      "NetworkCost": {
                        "AvgBitrate": "100",
                        "CostBandwidth": "10",
                        "PreloadTime": "8"
                      },
                      "NumFrames": "25",
                      "PixFmt": "yuv420p",
                      "Profile": "high",
                      "Sar": "1:1",
                      "StartTime": "0.000000",
                      "Timebase": "1/24000",
                      "Width": "1280"
                    }
                  ]
                }
              },
              "Width": "1280"
            },
            "Rotate": "180",
            "SubtitleConfig": {
              "ExtSubtitleList": {
                "ExtSubtitle": [
                  {
                    "CharEnc": "UTF-8",
                    "FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
                    "Input": {
                      "Bucket": "example-bucket-****",
                      "Location": "oss-cn-hangzhou",
                      "Object": "example-output.flv"
                    }
                  }
                ]
              },
              "SubtitleList": {
                "Subtitle": [
                  {
                    "Map": "0:a:0"
                  }
                ]
              }
            },
            "SuperReso": {
              "IsHalfSample": "true"
            },
            "TailSlateList": {
              "TailSlate": [
                {
                  "BgColor": "White",
                  "BlendDuration": "2",
                  "Height": "1080",
                  "IsMergeAudio": false,
                  "Start": "1",
                  "TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
                  "Width": "1920"
                }
              ]
            },
            "TemplateId": "S00000000-000010",
            "TransConfig": {
              "AdjDarMethod": "crop",
              "IsCheckAudioBitrate": "false",
              "IsCheckAudioBitrateFail": "true",
              "IsCheckReso": "false",
              "IsCheckResoFail": "false",
              "IsCheckVideoBitrate": "false",
              "IsCheckVideoBitrateFail": "true",
              "TransMode": "onepass"
            },
            "UserData": "example data",
            "Video": {
              "Bitrate": "10",
              "BitrateBnd": {
                "Max": "20",
                "Min": "10"
              },
              "Bufsize": "1000",
              "Codec": "H.264",
              "Crf": "22",
              "Crop": "1280:800:0:140",
              "Degrain": "5",
              "Fps": "60",
              "Gop": "1",
              "Height": "1280",
              "MaxFps": "15",
              "Maxrate": "10",
              "Pad": "1280:800:0:140",
              "PixFmt": "yuvj420p",
              "Preset": "veryfast",
              "Profile": "baseline",
              "Qscale": "15",
              "ResoPriority": "1",
              "ScanMode": "interlaced",
              "Width": "1080"
            },
            "VideoStreamMap": "0:a:0",
            "WaterMarkConfigUrl": "http://example.com/configure",
            "WaterMarkList": {
              "WaterMark": [
                {
                  "Dx": "1",
                  "Dy": "1",
                  "Height": "1280",
                  "InputFile": {
                    "Bucket": "example-bucket",
                    "Location": "oss-cn-hangzhou",
                    "Object": "example-logo-****.png"
                  },
                  "ReferPos": "TopRight",
                  "Type": "Image",
                  "WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
                  "Width": "1080"
                }
              ]
            }
          },
          "Percent": 100,
          "PipelineId": "88c6ca184c0e47098a5b665e2a126797",
          "State": "Submitted"
        },
        "Message": "The specified parameter \"%s\" cannot be null.",
        "Success": true
      }
    ]
  },
  "RequestId": "25818875-5F78-4A45S71F6-D73936451234"
}

錯誤碼

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

變更歷史

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