使用SubmitJobs接口提交转码作业-媒体处理-阿里云-媒体处理(MPS)-阿里云帮助中心

提交转码作业。当控制台创建的转码任务和工作流均无法满足您的使用场景时，可以按需调用SubmitJobs接口进行转码。根据您的业务逻辑配置所需的转码参数即可。

接口说明

转码作业为异步执行作业，不保证时效性。在提交转码作业后，任务会添加到管道中排队，被调度执行。所以在接口返回时，不保证转码已经完成。执行完成后需要调用查询转码作业接口轮询执行结果，或通过为管道绑定 MNS 消息接收执行结果，详细操作请参见接收消息通知。
输入单个文件大小最大支持 100 GB，超过可能导致执行失败。
使用预置智能模板对输入文件进行转码时，必须要先调用提交预置模板分析作业接口（ SubmitAnalysisJob ），分析作业成功完成后可以通过调用查询模板分析作业接口（ QueryAnalysisJobList ）获取该输入文件的可用预置模板列表。在提交转码作业时，将 TemplateId 参数设置为可用的预置模板 ID 即可。若提交的转码作业中指定的模板不在可用的预置模板列表中，会导致转码作业失败。
使用预置静态模板对输入文件进行转码时，不需要提交模板分析作业。
如需在 MPS 服务中使用多个账号，可以为阿里云账号创建 RAM 用户，详细说明请参见创建 RAM 用户并授权。如果提交转码作业和查询转码作业使用的是不同的阿里云账号，则会导致查询不到数据。
如果您的账户已经欠费，欠费后 24 小时内会暂停服务。更多信息请参见欠费说明。
更多转码常见问题，请参见媒体处理常见问题。

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 详情。说明在媒体处理 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 必须与媒体处理服务在同一个地域。遵守 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"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。