SubmitJobs - 提交转码作业 - 媒体处理

提交转码作业。

接口说明

当控制台创建的转码任务和工作流均无法满足您的使用场景时，可以按需调用SubmitJobs接口进行转码。根据您的业务逻辑配置所需的转码参数即可。
如需在MPS服务中使用多个账号，可以为阿里云账号创建RAM用户，并授予RAM用户AliyunMTSFullAccess权限。如果提交转码作业和查询转码作业使用的是不同的阿里云账号，则会导致查询不到数据。具体操作，请参见设置RAM用户和授权。
一个转码输出会生成一个转码作业，本接口返回参数中包含转码作业列表。
媒体处理中转码需要重新编码，不保证转码完成后码率与源文件一致，如果需要文件流码率不变，可以使用转封装。转封装模板详细信息，请参见预置模板详情。
作业会添加到管道中被调度执行，执行完成后需要调用查询转码作业接口轮询作业执行结果，也可使用异步通知机制。
说明异步通知：为管道设定消息通知属性，管道内转码作业异步接口的返回消息可通过消息通知服务主动推送到用户的消息接收服务。
使用预置智能模板对输入文件进行转码时，必须要先调用提交模板分析作业接口（SubmitAnalysisJob），分析作业成功完成后可以通过调用查询模板分析作业接口（ QueryAnalysisJobList）获取该输入文件的可用预置模板列表。
说明提交转码作业时，将TemplateId参数设置为可用的预置模板ID即可。若提交的转码作业中指定的模板不在可用的预置模板列表中，则转码作业会失败。
使用预置静态模板对输入文件进行转码时，不需要提交模板分析作业。
待转码文件单个文件大小最大支持100 GB，超过否则可能导致处理失败。
更多转码常见问题，请参见媒体处理常见问题。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Input	string	是	作业输入，JSON对象，其中，Referer为非必填参数，如需在单任务转码时设置referer，Input中的Referer必填。Input参数说明，请参见Input详情。说明目前支持`{ObjectPrefix}`、`{FileName}`、`{ExtName}`动态替换。示例：转码输入文件`Object：a/b/c/test.flv`，字幕文件用动态规则可表示为：`{ObjectPrefix}{FileName}-cn.srt`，需经URLEncode，Object设置为：`%7bObjectPrefix%7d%7bFileName%7d-cn.srt`。那么MPS会认为外挂字幕文件地址为：`a/b/c/test-cn.srt`。	{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "用户自行在OSS控制台设置的OSS防盗链参数"}
Outputs	string	是	作业输出。 Outputs由Output列表构成，JSON数组，大小上限为30。 Output的定义，请参见术语表。 Output的参数说明，请参见Output详情。说明如需使用提交转码作业接口进行图片拼接，请将待处理图片宽度和高度均设置为偶数，否则可能导致任务失败。	[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff**","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47**"}],"UserData":"testid-001"}]
OutputBucket	string	是	输出Bucket，可以通过MPS控制台 > 工作流管理 > 媒体Bucket获取。	exampleBucket
OutputLocation	string	否	输出Bucket所在地域。	oss-cn-hangzhou
PipelineId	string	是	管道ID。可以通过MPS控制台 > 全局设置 > 管道查询。管道的详细定义，请参见术语表。如果需要异步通知，须保证此管道绑定了可用的消息主题。具体绑定操作，请参见设置转码消息通知。	dd3dae411e704030b921e52698e5****

返回参数

名称	类型	描述	示例值
	object	返回参数。
JobResultList	array	提交转码作业结果列表。
	object	返回参数。
Job	object	作业详细信息。如果提交失败则不会生成作业ID。
CreationTime	string	作业添加时间。	2014-01-10T12:00:00Z
Percent	long	转码进度。	100
FinishTime	string	作业完成时间。	2014-01-10T12:20:00Z
State	string	作业状态。 Submitted：作业已提交。 TranscodeFail：转码失败。	Submitted
JobId	string	任务ID。	31fa3c9ca8134f9cec2b4b0b0f78****
Code	string	转码失败时的错误码。转码成功时不返回。	InternalError
Message	string	转码失败时的消息。转码成功时不返回。	The operation has failed due to some unknown error, exception or failure.
Output	object	作业输出。
Video	object	视频配置。说明指定则替换TemplateId所指定模板的AliyunVideoCodec设置。
Bufsize	string	缓冲区大小。单位：Kb。默认值：6000。	1000
Degrain	string	独立去噪算法强度。	5
BitrateBnd	object	视频平均码率范围。
Max	string	总码率上限。单位：Kbps。	20
Min	string	总码率下限。单位：Kbps。	10
PixFmt	string	视频颜色格式。默认值：yuv420p或原始颜色格式。可取值：yuv420p，yuvj420p等标准颜色格式。说明非标准颜色格式（比如：yuvj420p(pc, bt470bg/bt470bg/smpte170m）需要配置兼容，否则会导致转码失败。	yuvj420p
Pad	string	视频贴黑边。参数格式：width:height:left:top。单位：px。	1280:800:0:140
Codec	string	编解码格式。支持H.264、H.265、GIF、WEBP。默认值：H.264。	H.264
Height	string	高。单位：px。默认值：视频原始高度。	1280
Qscale	string	视频质量控制值。	15
Crop	string	视频画面裁切。支持2种方式：自动检测黑边并裁切：设置为border。自定义裁切：参数格式为width:height:left:top。	1280:800:0:140
Bitrate	string	视频输出文件的码率。单位：Kbps。	10
Maxrate	string	视频码率峰值。单位：Kbps。	10
MaxFps	string	最大帧率。	15
Profile	string	编码级别，目前仅H264支持此参数。默认值：high，可取值：说明如果您有多个清晰度，建议最低清晰度配置成baseline，以保证最低端设备可播放。其他清晰度配置为main或high。 baseline：针对移动设备。 main：针对标准分辨率设备。 high：针对高分辨率设备。	baseline
Crf	string	码率-质量控制因子。如果设置了Crf，则Bitrate的设置失效。默认值：编码格式为H264，默认值为23。编码格式为H265，默认值为26。	22
Gop	string	关键帧间最大时间间隔或最大帧数。单位：秒（s）。默认值：10s。最大帧数时无单位。	1
Width	string	宽。单位：px。默认值：视频原始宽度。	1080
Fps	string	帧率。单位：fps。可取值范围：0~60，当输入文件帧率超过60时取60。默认值：取输入文件帧率。	60
Preset	string	视频算法器预置。默认值：medium。可取值： veryfast：超快。 fast：快。 medium：中等。 slow：慢。 slower：超慢。	veryfast
ScanMode	string	扫描模式。可取值： interlaced：交叉扫描。 progressive：顺序扫描。 auto：根据视频源扫描。	interlaced
ResoPriority	string	资源优先级。	1
TransConfig	object	转码通用配置。说明如果请求参数中设置了该值，则覆盖指定转码模板中的对应参数。
IsCheckAudioBitrate	string	是否检查音频码率。当输出音频码率大于媒体源音频码率时，则视为输出音频码率等于媒体源音频码率，即设置的音频码率参数不会生效。此值优先级小于IsCheckAudioBitrateFail。 true表示检查。 false表示不检查。默认值：参数为空，并且codec和输入源不一样：false。参数为空，并且codec和输入源一样：true。	false
TransMode	string	转码模式。可取值： onepass：基于One-Pass算法，准确性较好。 twopass：基于Two-Pass算法，准确性较差。 CBR：Constant bit rate，固定码率。	onepass
IsCheckReso	string	是否检查分辨率。如果输出分辨率大于输入分辨率（判断条件是宽或高），则视为输出分辨率等于输入分辨率。 true表示检查。 false表示不检查。默认值：false。	false
IsCheckVideoBitrateFail	string	是否检查码率。当输出视频码率大于媒体源视频码率时，则不进行转码，直接返回转码失败。此值优先级大于IsCheckVideoBitrate。 true表示检查。 false表示不检查。默认值：false。	true
AdjDarMethod	string	分辨率改写方式。默认值：none。可取值： rescale：重新做scale。 crop：裁剪。 pad：填充。 none：不改写。	crop
IsCheckVideoBitrate	string	是否检查视频码率。如果视频输出码率大于视频输入码率，则视为视频输出码率等于视频输入码率。 true表示检查。 false表示不检查。默认值：false。	false
IsCheckResoFail	string	是否检查分辨率。此值优先级大于IsCheckReso。如果输出分辨率大于输入分辨率（判断条件是宽或高），不进行转码，直接返回转码失败。 true：检查。 false：不检查。默认值：false。	false
IsCheckAudioBitrateFail	string	是否检查音频码率。此值优先级大于IsCheckAudioBitrate。当输出音频码率大于媒体源音频码率时，不进行转码，直接返回转码失败。 false：检查。 true：不检查。	true
Encryption	object	数据加密，只支持m3u8格式的输出。
Type	string	加密类型。取值：hls-aes-128。	hls-aes-128
Key	string	加密视频的密钥。	encryptionkey128
KeyType	string	密钥Key不能明文传输给MPS，需要加密，方式为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	array	水印列表。说明如果水印输出截断或失败，请先检查您添加的文本水印中是否包含特殊字符，如有，则需要对特殊字符进行转义后再传入，或提交工单联系阿里云客服进行兼容处理。
	object	水印详细信息。
Type	string	水印类型。如果请求参数中设置了此参数，则此值覆盖水印模板对应参数。更多信息，请参见参数详情。可取值： Image：图片水印。 Text：文字水印。	Image
ReferPos	string	水印的位置。如果请求参数中设置了此值，则覆盖水印模板对应参数。可取值： TopRight：右上。 TopLeft：左上。 BottomRight：右下。 BottomLeft：左下。	TopRight
Dx	string	水印图片相对输出视频的水平偏移量。如果请求参数中设置了此值，则覆盖水印模板对应参数。默认值为0。值有两种形式：整数型：代表偏移像素值。范围：[8,4096]。单位：px。小数型：代表水平偏移量与输出分辨率宽的比率。范围：（0,1)。支持四位小数，例如：0.9999，超出部分系统自动丢弃。	1
Width	string	水印图片宽。如果在请求参数中设置了此值，则覆盖水印模板对应水印图片宽。值有两种形式：整数型：代表水印图片宽的像素值。范围：[8，4096]。单位：px。小数型：代表相对输出视频分辨率宽的比率。范围：(0,1)。支持4位小数，例如：0.9999，超出部分系统自动丢弃。	1080
Height	string	水印图片高。如果在请求参数中设置了此值，则覆盖水印模板对应水印图片高。值有两种形式：整数型：代表水印图片高的像素值。范围：[8，4096]。单位：px。小数型：代表相对输出视频分辨率高的比率。范围：(0,1)。支持4位小数，例如：0.9999，超出部分系统自动丢弃。	1280
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，超出部分系统自动丢弃。	1
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。	5
Audio	object	音频配置。说明如果请求参数中指定了音频配置则覆盖指定转码模板中的对应参数。
Profile	string	音频编码预置。说明当Codec为aac时可以取如下范围中的值：aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。	aac_low
Codec	string	音频编解码格式。支持aac、mp3、vorbis、flac。默认值：aac。	aac
Samplerate	string	采样率。支持22050、32000、44100、48000、96000。单位：Hz。默认值：44100。说明若视频容器格式为flv，音频编解码格式选择为mp3时，采样率不支持32000、48000、96000；音频编解码格式为mp3时，采样率不支持96000。	32000
Qscale	string	音频质量控制度。	15
Channels	string	声道数。当Codec设置为mp3时，声道数只支持1、2。当Codec设置为aac时，声道数只支持1、2、4、5、6、8。默认值：2。	6
Volume	object	音量控置。
Method	string	音量调整方式。可取值： auto：自动调整。 dynamic：动态调整。 linear：线性调整。	auto
Level	string	音量调整幅度单位：db。默认：-20db。	-20
Bitrate	string	输出文件的音频码率。单位：Kbps。默认值：128。	128
AudioStreamMap	string	音频流序号。格式：格式：0:a:{序号}，示例：0:a:0。序号的含义是音频流列表的下标，序号从0开始。若未设置，选择默认的音频流。	0:a:0
MergeList	array	视频拼接配置。
	object	视频拼接配置详细信息。
Start	string	起始时间点。格式：`hh:mm:ss[.SSS]`或者`sssss[.SSS]`。示例：01:59:59.999或者32000.23。	00000.50
RoleArn	string	代理授权使用的角色信息。	acs:ram::<your uid>:role/<your role name>
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
Duration	string	持续时间。格式：`hh:mm:ss[.SSS]`或者`sssss[.SSS]`。示例：01:59:59.999或者32000.23。	00000.20
SuperReso	object	分辨率随源。
IsHalfSample	string	是否获取采样率相关参数。可取值： true：是。 false：否。	true
UserData	string	用户自定义数据。	example data
OutSubtitleList	array	输出字幕列表。
	object	输出字幕详情。
Map	string	视频轨。格式：`0:{流}:{流序号}` ，即`0:v:{video_index}`。流取值为v: video音频流，序号的含义是音频流列表的下标，序号从0开始。	0:v:0
OutSubtitleFile	object	输出文件详细信息。
RoleArn	string	代理授权使用的角色信息。	acs:ram::<your uid>:role/<your role name>
Object	string	输出文件的OSS Object。	example-output.flv
Location	string	输出文件的OSS Location。	oss-cn-hangzhou
Bucket	string	输入文件的OSS Bucket。	example-bucket-****
Success	boolean	是否成功。可取值： true：成功。 false：失败。	true
Message	string	创建作业失败时错误消息。创建成功时此参数不返回。	The specified parameter “%s” cannot be null.
DigiWaterMark	object	数字水印。
Type	string	水印类型。如果设置过水印类型，则此值覆盖水印模板对应参数。可取值： Image：默认值，图片水印。 Text：文字水印。	Image
Alpha	string	文字或图片的透明度。取值范围：(0,1]。默认值：1.0。	1.0
InputFile	object	输入文件。
Object	string	输入文件的OSS Object。	example-intput.flv
Location	string	输入文件的OSS Location。	oss-cn-hangzhou
Bucket	string	输入文件的OSS Bucket。	example-bucket-****
VideoStreamMap	string	视频流序号。格式：格式：0:a:{序号}，示例：0:a:0。序号的含义是音频流列表的下标，序号从0开始。若未设置，选择默认的视频流。	0:a:0
OutputFile	object	输出文件。
RoleArn	string	代理授权使用的角色信息。	acs:ram::<your uid>:role/<your role name>
Object	string	输出文件的OSS Object。	example-output.flv
Location	string	输出文件的OSS Location。	oss-cn-hangzhou
Bucket	string	输入文件的OSS Bucket。	example-bucket-****
AmixList	array	混音列表。
	object	返回参数。
Map	string	在AmixURL中选取目标音轨，取值为：0:a:{audio_index}, 如0:a:0。	0:a:0
Start	string	起始时间。数字或时间格式例如："1:25:36.240"， "32000.23"。	0
AmixURL	string	需要被混音的背景音轨媒体。可取值：OSS地址或字符串`"input"`。 input场景：同一视频两路音轨合并。	https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3
Duration	string	持续时长。数字或时间格式。	20
MixDurMode	string	媒体时长取值。可取值：first、long。 first：输出媒体的时长以输入媒体的时长为准。 long：输出媒体的时长以两个媒体中时长最长的为准。默认值：long。	long
Rotate	string	视频顺时针旋转角度。	180
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
Clip	object	剪辑片段。
TimeSpan	object	剪辑时间段。
Seek	string	开始时间。格式：`hh:mm:ss[.SSS]`或`sssss[.SSS]`。取值范围：`[00:00:00.000,23:59:59.999]`或`[0.000，86399.999]`。	01:59:59.999
Duration	string	延续时间。格式：`hh:mm:ss[.SSS]`或`sssss[.SSS]`。取值范围：`[00:00:00.000,23:59:59.999]`或`[0.000，86399.999]`。	01:00:59.999
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"}]}
OpeningList	array	开板列表，JSON对象。
	object	返回参数。
openUrl	string	开板视频的OSS URL地址。	http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
Start	string	相对正片视频的开始时间。从0开始延迟多长时间后，显示开板视频。单位：秒。默认值：0。	1
Width	string	宽。可取值：0~4096、-1、full。默认值：-1。 -1代表片源的值。 full表示填满画面。	1920
Height	string	高。可取值：0~4096、-1、full。默认值：-1。 -1代表片源的值， full表示填满画面。	1080
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	分片时长。整数，单位：秒。可取值范围：[1,10]。默认值：10秒。	20
TailSlateList	array	尾板列表，JSON对象。
	object	返回参数。
Start	string	开始时间。	1
BgColor	string	如果尾板视频的宽、高小于正片时，设置空白处填充的背景色。默认为White，更多取值请参见bgcolor。	White
IsMergeAudio	boolean	是否要拼接尾板视频的音频内容。可取值： true：拼接。 false：不拼接。	false
Width	string	宽。可取值：0~4096、-1、full。 -1代表片源的值，full表示填满画面。默认为-1。	1920
Height	string	高。可取值：0~4096、-1、full。 -1代表片源的值，full表示填满画面。默认为-1。	1080
BlendDuration	string	正片视频和尾板视频过渡的时长。过渡的效果是淡入淡出：正片显示最后一帧，同时播放尾板视频，正片最后一帧逐步变暗，尾板视频逐步变亮。单位秒，默认0。	2
TailUrl	string	尾板视频的OSS URL地址。	http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
TemplateId	string	转码模板ID。	S00000000-000010
SubtitleConfig	object	字幕配置信息。
ExtSubtitleList	array	外部字幕列表，JSON数组，最多4个。
	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格式。
Object	string	输入文件的OSS Object。	example-output.flv
Location	string	输入文件所在的OSS Location。	oss-cn-hangzhou
Bucket	string	输入文件所在的OSS Bucket。	example-bucket-****
SubtitleList	array	字幕列表。
	object	返回参数。
Map	string	音轨。格式：`0:{流}:{流序号}` ，即`0:a:{audio_index}`。流取值为a: audio音频流，序号的含义是音频流列表的下标，序号从0开始。	0:a:0
Properties	object	媒体属性。
Width	string	视频宽。	1280
Height	string	视频长。	720
Duration	string	时长。	55
Fps	string	帧率，数字。	25
Bitrate	string	码率。	1000
FileFormat	string	文件格式。	QuickTime / MOV
Streams	object	流信息。
VideoStreamList	array	视频流列表。
	object	视频流详细信息。
Index	string	视频流序号，标识视频流在整个媒体流中的位置。	0
Timebase	string	时基。	1/24000
AvgFPS	string	平均帧率。	23.976025
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	视频分辨率长。	720
NumFrames	string	总帧数。	25
Bitrate	string	码率。	1496.46
CodecTagString	string	编码格式标记文本。	avc1
HasBFrames	string	是否有B帧。	2
Profile	string	编码预置。	high
StartTime	string	起始时间。	0.000000
NetworkCost	object	网络带宽消耗。
PreloadTime	string	预加载时间。	8
AvgBitrate	string	平均码率。	100
CostBandwidth	string	最大消耗带宽。	10
Dar	string	编码显示分辨率比。	16:9
CodecName	string	编码格式简述名。	h264
Width	string	视频分辨率宽，数字。	1280
Duration	string	时长。	17.225542
Fps	string	帧率。	23.976025
CodecTag	string	编码格式标记。	0x31637661
CodecTimeBase	string	编码时基。	1001/48000
Level	string	编码等级。	51
AudioStreamList	array	音频流列表。
	object	音频流详细信息。
Timebase	string	时基。	1/44100
Index	string	音频流序号。标识音频流在整个媒体流中的位置。	1
SampleFmt	string	采样格式。	fltp
ChannelLayout	string	声道输出样式。	stereo
Lang	string	语言。更多信息，请参见FFmeg语言定义、ISO-639。	eng
Samplerate	string	采样率。	44100
CodecLongName	string	编码格式长述名。	AAC (Advanced Audio Coding)
Channels	string	声道数。	2
NumFrames	string	总帧数。	25
Bitrate	string	码率。	128.806
CodecTagString	string	编码格式标记文本。	mp4a
StartTime	string	起始时间。	0.000000
CodecName	string	编码格式简述名。	aac
Duration	string	时长。	17.159546
CodecTag	string	编码格式标记。	0x6134706d
CodecTimeBase	string	编码时基。	1/44100
SubtitleStreamList	array	字幕流列表。
	object	字幕流详细信息。
Index	string	字幕流序号，标识字幕流在整个媒体流中的位置。	1
Lang	string	语言。更多信息，请参见FFmeg语言定义、ISO-639。	eng
Format	object	格式信息。
StartTime	string	起始时间。	0.000000
NumPrograms	string	节目流总数。	0
Size	string	文件大小。	3509895
NumStreams	string	媒体流总数。	2
FormatLongName	string	容器、封装格式长述名。	QuickTime / MOV
Duration	string	总时长。	55
Bitrate	string	总码率。	1000
FormatName	string	容器、封装格式简述名。可取值：mov、mp4、m4a、3gp、3g2、mj2。	mov
FileSize	string	文件大小。	3509895
PipelineId	string	管道ID。	88c6ca184c0e47098a5b665e2a126797
Input	object	作业输入。
Object	string	作业输入的OSS Object。	example.flv
Location	string	作业输入的OSS Location。	oss-cn-hangzhou
Bucket	string	作业输入的OSS Bucket。	example-bucket-****
MNSMessageResult	object	MNS通知用户作业完成的消息结果。
MessageId	string	失败时错误信息ID。成功时此参数不返回。	123
ErrorMessage	string	失败时错误信息。成功时此参数不返回。	The resource operated "%s" cannot be found.
ErrorCode	string	失败时错误码。成功时此参数不返回。	InvalidParameter.ResourceNotFound
Success	boolean	是否成功。可取值： true：成功。 false：失败。	true
Code	string	创建作业失败时错误码。创建成功时此参数不返回。	InvalidParameter.NullValue
Message	string	创建作业失败时错误消息。创建成功时此参数不返回。	The specified parameter "%s" cannot be null.
RequestId	string	请求ID。	25818875-5F78-4A45S71F6-D73936451234

示例

正常返回示例

JSON格式

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

错误码

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