全部产品
Search
文档中心

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

更新时间:Feb 22, 2023

提交转码作业。

接口说明

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

  • 如需在MPS服务中使用多个账号,可以为阿里云账号创建RAM用户,并授予RAM用户AliyunMTSFullAccess权限。如果提交转码作业和查询转码作业使用的是不同的阿里云账号,则会导致查询不到数据。具体操作,请参见设置RAM用户和授权

  • 一个转码输出会生成一个转码作业,本接口返回参数中包含转码作业列表。

  • 媒体处理中转码需要重新编码,不保证转码完成后码率与源文件一致,如果需要文件流码率不变,可以使用转封装。转封装模板详细信息,请参见预置模板详情

  • 作业会添加到管道中被调度执行,执行完成后需要调用查询转码作业接口轮询作业执行结果,也可使用异步通知机制。

    说明异步通知:为管道设定消息通知属性,管道内转码作业异步接口的返回消息可通过消息通知服务主动推送到用户的消息接收服务。
  • 使用预置智能模板对输入文件进行转码时,必须要先调用提交模板分析作业接口(SubmitAnalysisJob),分析作业成功完成后可以通过调用查询模板分析作业接口( QueryAnalysisJobList)获取该输入文件的可用预置模板列表。

    说明提交转码作业时,将TemplateId参数设置为可用的预置模板ID即可。若提交的转码作业中指定的模板不在可用的预置模板列表中,则转码作业会失败。
  • 使用预置静态模板对输入文件进行转码时,不需要提交模板分析作业。

  • 待转码文件单个文件大小最大支持100 GB,超过否则可能导致处理失败。

  • 更多转码常见问题,请参见媒体处理常见问题

QPS限制

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

调试

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

调试

授权信息

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

请求参数

名称类型必填描述示例值
Inputstring

作业输入,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防盗链参数"}
Outputsstring

作业输出。

  • 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"}]
OutputBucketstring

输出Bucket,可以通过MPS控制台 > 工作流管理 > 媒体Bucket获取。

exampleBucket
OutputLocationstring

输出Bucket所在地域。

oss-cn-hangzhou
PipelineIdstring

管道ID。可以通过MPS控制台 > 全局设置 > 管道查询。

  • 管道的详细定义,请参见术语表

  • 如果需要异步通知,须保证此管道绑定了可用的消息主题。具体绑定操作,请参见设置转码消息通知

dd3dae411e704030b921e52698e5****

返回参数

名称类型描述示例值
object

返回参数。

JobResultListarray

提交转码作业结果列表。

object

返回参数。

Jobobject

作业详细信息。如果提交失败则不会生成作业ID。

CreationTimestring

作业添加时间。

2014-01-10T12:00:00Z
Percentlong

转码进度。

100
FinishTimestring

作业完成时间。

2014-01-10T12:20:00Z
Statestring

作业状态。

  • Submitted:作业已提交。
  • TranscodeFail:转码失败。
Submitted
JobIdstring

任务ID。

31fa3c9ca8134f9cec2b4b0b0f78****
Codestring

转码失败时的错误码。转码成功时不返回。

InternalError
Messagestring

转码失败时的消息。转码成功时不返回。

The operation has failed due to some unknown error, exception or failure.
Outputobject

作业输出。

Videoobject

视频配置。

说明指定则替换TemplateId所指定模板的AliyunVideoCodec设置。
Bufsizestring

缓冲区大小。

  • 单位:Kb。
  • 默认值:6000
1000
Degrainstring

独立去噪算法强度。

5
BitrateBndobject

视频平均码率范围。

Maxstring

总码率上限。单位:Kbps。

20
Minstring

总码率下限。单位:Kbps。

10
PixFmtstring

视频颜色格式。

  • 默认值:yuv420p或原始颜色格式。

  • 可取值:yuv420pyuvj420p等标准颜色格式。

    说明非标准颜色格式(比如:yuvj420p(pc, bt470bg/bt470bg/smpte170m)需要配置兼容,否则会导致转码失败。
yuvj420p
Padstring

视频贴黑边。

  • 参数格式:width:height:left:top。

  • 单位:px。

1280:800:0:140
Codecstring

编解码格式。

  • 支持H.264H.265GIFWEBP
  • 默认值:H.264
H.264
Heightstring

高。

  • 单位:px。
  • 默认值:视频原始高度。
1280
Qscalestring

视频质量控制值。

15
Cropstring

视频画面裁切。支持2种方式:

  • 自动检测黑边并裁切:设置为border
  • 自定义裁切:参数格式为width:height:left:top。
1280:800:0:140
Bitratestring

视频输出文件的码率。单位:Kbps。

10
Maxratestring

视频码率峰值。单位:Kbps。

10
MaxFpsstring

最大帧率。

15
Profilestring

编码级别,目前仅H264支持此参数。默认值:high,可取值:

说明如果您有多个清晰度,建议最低清晰度配置成baseline,以保证最低端设备可播放。其他清晰度配置为main或high。
  • baseline:针对移动设备。

  • main:针对标准分辨率设备。

  • high:针对高分辨率设备。

baseline
Crfstring

码率-质量控制因子。

  • 如果设置了Crf,则Bitrate的设置失效。

  • 默认值:编码格式为H264,默认值为23。编码格式为H265,默认值为26

22
Gopstring

关键帧间最大时间间隔或最大帧数。单位:秒(s)。

  • 默认值:10s。

  • 最大帧数时无单位。

1
Widthstring

宽。

  • 单位:px。
  • 默认值:视频原始宽度
1080
Fpsstring

帧率。

  • 单位:fps。

  • 可取值范围:0~60,当输入文件帧率超过60时取60。

  • 默认值:取输入文件帧率。

60
Presetstring

视频算法器预置。默认值:medium。可取值:

  • veryfast:超快。

  • fast:快。

  • medium:中等。

  • slow:慢。

  • slower:超慢。

veryfast
ScanModestring

扫描模式。可取值:

  • interlaced:交叉扫描。

  • progressive:顺序扫描。

  • auto:根据视频源扫描。

interlaced
ResoPrioritystring

资源优先级。

1
TransConfigobject

转码通用配置。

说明如果请求参数中设置了该值,则覆盖指定转码模板中的对应参数。
IsCheckAudioBitratestring

是否检查音频码率。当输出音频码率大于媒体源音频码率时,则视为输出音频码率等于媒体源音频码率,即设置的音频码率参数不会生效。此值优先级小于IsCheckAudioBitrateFail。

  • true表示检查。
  • false表示不检查。
  • 默认值:
    • 参数为空,并且codec和输入源不一样:false。
    • 参数为空,并且codec和输入源一样:true。
false
TransModestring

转码模式。可取值:

  • onepass: 基于One-Pass算法,准确性较好。

  • twopass:基于Two-Pass算法,准确性较差。

  • CBR:Constant bit rate,固定码率。

onepass
IsCheckResostring

是否检查分辨率。如果输出分辨率大于输入分辨率(判断条件是宽或高),则视为输出分辨率等于输入分辨率。

  • true表示检查。

  • false表示不检查。

  • 默认值:false

false
IsCheckVideoBitrateFailstring

是否检查码率。当输出视频码率大于媒体源视频码率时,则不进行转码,直接返回转码失败。此值优先级大于IsCheckVideoBitrate

  • true表示检查。

  • false表示不检查。

  • 默认值:false

true
AdjDarMethodstring

分辨率改写方式。默认值:none。可取值:

  • rescale:重新做scale。

  • crop:裁剪。

  • pad:填充。

  • none:不改写。

crop
IsCheckVideoBitratestring

是否检查视频码率。如果视频输出码率大于视频输入码率,则视为视频输出码率等于视频输入码率。

  • true表示检查。

  • false表示不检查。

  • 默认值:false

false
IsCheckResoFailstring

是否检查分辨率。此值优先级大于IsCheckReso。如果输出分辨率大于输入分辨率(判断条件是宽或高),不进行转码,直接返回转码失败。

  • true:检查。

  • false:不检查。

  • 默认值:false

false
IsCheckAudioBitrateFailstring

是否检查音频码率。此值优先级大于IsCheckAudioBitrate。当输出音频码率大于媒体源音频码率时,不进行转码,直接返回转码失败。

  • false:检查。
  • true:不检查。
true
Encryptionobject

数据加密,只支持m3u8格式的输出。

Typestring

加密类型。取值:hls-aes-128

hls-aes-128
Keystring

加密视频的密钥。

encryptionkey128
KeyTypestring

密钥Key不能明文传输给MPS,需要加密,方式为Base64或KMS。如密钥为"encryptionkey128”, 则Base64(“encryptionkey128”), 或 KMS(Base64(“encryptionkey128”)。

Base64
Idstring

加密ID。

31fa3c9ca8134f9cec2b4b0b0f78****
KeyUristring

密钥的访问URL,使用BASE64进行编码。

https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/
SkipCntstring

前面不加密的片数(视频能快速播放起来)。

3
WaterMarkListarray

水印列表。

说明如果水印输出截断或失败,请先检查您添加的文本水印中是否包含特殊字符,如有,则需要对特殊字符进行转义后再传入,或提交工单联系阿里云客服进行兼容处理。
object

水印详细信息。

Typestring

水印类型。如果请求参数中设置了此参数,则此值覆盖水印模板对应参数。更多信息,请参见参数详情。可取值:

  • Image:图片水印。
  • Text:文字水印。
Image
ReferPosstring

水印的位置。如果请求参数中设置了此值,则覆盖水印模板对应参数。可取值:

  • TopRight:右上。
  • TopLeft:左上。
  • BottomRight:右下。
  • BottomLeft:左下。
TopRight
Dxstring

水印图片相对输出视频的水平偏移量。如果请求参数中设置了此值,则覆盖水印模板对应参数。默认值为0。值有两种形式:

  • 整数型:代表偏移像素值。

    • 范围:[8,4096]

    • 单位:px。

  • 小数型:代表水平偏移量与输出分辨率宽的比率。

    • 范围:(0,1)。

    • 支持四位小数,例如:0.9999,超出部分系统自动丢弃。

1
Widthstring

水印图片宽。如果在请求参数中设置了此值,则覆盖水印模板对应水印图片宽。值有两种形式:

  • 整数型:代表水印图片宽的像素值。

    • 范围:[8,4096]

    • 单位:px。

  • 小数型:代表相对输出视频分辨率宽的比率。

    • 范围:(0,1)

    • 支持4位小数,例如:0.9999,超出部分系统自动丢弃。

1080
Heightstring

水印图片高。如果在请求参数中设置了此值,则覆盖水印模板对应水印图片高。值有两种形式:

  • 整数型:代表水印图片高的像素值。

    • 范围:[8,4096]

    • 单位:px。

  • 小数型:代表相对输出视频分辨率高的比率。

    • 范围:(0,1)

    • 支持4位小数,例如:0.9999,超出部分系统自动丢弃。

1280
InputFileobject

水印输入文件。目前支持png图片、mov文件作为输入文件。

Objectstring

输入文件的OSS Object。

example-logo-****.png
Locationstring

输入文件的OSS Location。

oss-cn-hangzhou
Bucketstring

输入文件的OSS Bucket。

example-bucket
WaterMarkTemplateIdstring

水印模板ID。

88c6ca184c0e47098a5b665e2a12****
Dystring

水印图片相对输出视频的垂直偏移量。如果在请求参数中设置了此值,则覆盖水印模板对应水印图片相对输出视频的垂直偏移量。值有两种形式:

  • 整数型:代表水印图片相对输出视频的垂直偏移量像素。

    • 范围:[8,4096]

    • 单位:px。

  • 小数型:代表水印图片相对输出视频的垂直偏移量比率。

    • 范围:(0,1)

    • 支持4位小数,例如:0.9999,超出部分系统自动丢弃。

1
WaterMarkConfigUrlstring

水印配置文件URL。

http://example.com/configure
DeWatermarkstring

模糊处理,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}]}
M3U8NonStandardSupportobject

M3U8非标准支持,JSON对象。更多信息请参见参数详情中的M3U8非标准参数支持详情

TSobject

JSON对象,TS文件相关非标准支持。更多信息请参见参数详情中的TS参数支持详情

SizeSupportboolean

是否支持在M3U8文件中输出TS文件的大小。可取值:

  • true:支持。

  • false:不支持。

true
Md5Supportboolean

是否支持在M3U8文件中输出TS的md5值。可取值:

  • true:支持。

  • false:不支持。

true
Prioritystring

任务在其对应管道内的优先级。

  • 最高优先级:10
  • 默认值:6
5
Audioobject

音频配置。

说明如果请求参数中指定了音频配置则覆盖指定转码模板中的对应参数。
Profilestring

音频编码预置。

说明Codecaac时可以取如下范围中的值:aac_lowaac_heaac_he_v2aac_ldaac_eld
aac_low
Codecstring

音频编解码格式。

  • 支持aacmp3vorbisflac
  • 默认值:aac
aac
Sampleratestring

采样率。

  • 支持2205032000441004800096000
  • 单位:Hz。
  • 默认值:44100
说明若视频容器格式为flv,音频编解码格式选择为mp3时,采样率不支持32000、48000、96000;音频编解码格式为mp3时,采样率不支持96000。
32000
Qscalestring

音频质量控制度。

15
Channelsstring

声道数。

  • 当Codec设置为mp3时,声道数只支持12

  • 当Codec设置为aac时,声道数只支持124568

  • 默认值:2

6
Volumeobject

音量控置。

Methodstring

音量调整方式。可取值:

  • auto:自动调整。

  • dynamic:动态调整。

  • linear:线性调整。

auto
Levelstring

音量调整幅度

  • 单位:db。
  • 默认:-20db
-20
Bitratestring

输出文件的音频码率。

  • 单位:Kbps。
  • 默认值:128
128
AudioStreamMapstring

音频流序号。

  • 格式:格式:0:a:{序号},示例:0:a:0。

  • 序号的含义是音频流列表的下标,序号从0开始。

  • 若未设置,选择默认的音频流。

0:a:0
MergeListarray

视频拼接配置。

object

视频拼接配置详细信息。

Startstring

起始时间点。

  • 格式:hh:mm:ss[.SSS]或者sssss[.SSS]

  • 示例:01:59:59.999或者32000.23。

00000.50
RoleArnstring

代理授权使用的角色信息。

acs:ram::<your uid>:role/<your role name>
MergeURLstring

拼接片段地址。

  • 示例: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
Durationstring

持续时间。

  • 格式:hh:mm:ss[.SSS]或者sssss[.SSS]
  • 示例:01:59:59.999或者32000.23。
00000.20
SuperResoobject

分辨率随源。

IsHalfSamplestring

是否获取采样率相关参数。可取值:

  • true:是。

  • false:否。

true
UserDatastring

用户自定义数据。

example data
OutSubtitleListarray

输出字幕列表。

object

输出字幕详情。

Mapstring

视频轨。格式:0:{流}:{流序号} ,即0:v:{video_index}。流取值为v: video音频流,序号的含义是音频流列表的下标,序号从0开始。

0:v:0
OutSubtitleFileobject

输出文件详细信息。

RoleArnstring

代理授权使用的角色信息。

acs:ram::<your uid>:role/<your role name>
Objectstring

输出文件的OSS Object。

example-output.flv
Locationstring

输出文件的OSS Location。

oss-cn-hangzhou
Bucketstring

输入文件的OSS Bucket。

example-bucket-****
Successboolean

是否成功。可取值:

  • true:成功。

  • false:失败。

true
Messagestring

创建作业失败时错误消息。创建成功时此参数不返回。

The specified parameter “%s” cannot be null.
DigiWaterMarkobject

数字水印。

Typestring

水印类型。如果设置过水印类型,则此值覆盖水印模板对应参数。可取值:

  • Image:默认值,图片水印。

  • Text:文字水印。

Image
Alphastring

文字或图片的透明度。

  • 取值范围:(0,1]

  • 默认值:1.0

1.0
InputFileobject

输入文件。

Objectstring

输入文件的OSS Object。

example-intput.flv
Locationstring

输入文件的OSS Location。

oss-cn-hangzhou
Bucketstring

输入文件的OSS Bucket。

example-bucket-****
VideoStreamMapstring

视频流序号。

  • 格式:格式:0:a:{序号},示例:0:a:0。

  • 序号的含义是音频流列表的下标,序号从0开始。

  • 若未设置,选择默认的视频流。

0:a:0
OutputFileobject

输出文件。

RoleArnstring

代理授权使用的角色信息。

acs:ram::<your uid>:role/<your role name>
Objectstring

输出文件的OSS Object。

example-output.flv
Locationstring

输出文件的OSS Location。

oss-cn-hangzhou
Bucketstring

输入文件的OSS Bucket。

example-bucket-****
AmixListarray

混音列表。

object

返回参数。

Mapstring

在AmixURL中选取目标音轨,取值为:0:a:{audio_index}, 如0:a:0。

0:a:0
Startstring

起始时间。数字或时间格式例如:"1:25:36.240", "32000.23"。

0
AmixURLstring

需要被混音的背景音轨媒体。

  • 可取值:OSS地址或字符串"input"

  • input场景:同一视频两路音轨合并。

https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3
Durationstring

持续时长。数字或时间格式。

20
MixDurModestring

媒体时长取值。可取值:firstlong

  • first:输出媒体的时长以输入媒体的时长为准。

  • long:输出媒体的时长以两个媒体中时长最长的为准。

  • 默认值:long

long
Rotatestring

视频顺时针旋转角度。

180
Containerobject

容器。

Formatstring

容器格式。

  • 默认值: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
Clipobject

剪辑片段。

TimeSpanobject

剪辑时间段。

Seekstring

开始时间。

  • 格式:hh:mm:ss[.SSS]sssss[.SSS]

  • 取值范围:[00:00:00.000,23:59:59.999][0.000,86399.999]

01:59:59.999
Durationstring

延续时间。

  • 格式:hh:mm:ss[.SSS]sssss[.SSS]

  • 取值范围:[00:00:00.000,23:59:59.999][0.000,86399.999]

01:00:59.999
MergeConfigUrlstring

MergeListMergeConfigUrl两个参数只支持二选一。

  • 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"}]}
OpeningListarray

开板列表,JSON对象。

object

返回参数。

openUrlstring

开板视频的OSS URL地址。

http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
Startstring

相对正片视频的开始时间。从0开始延迟多长时间后,显示开板视频。

  • 单位:秒。

  • 默认值:0

1
Widthstring

宽。

  • 可取值:0~4096-1full

  • 默认值:-1

  • -1代表片源的值。

  • full表示填满画面。

1920
Heightstring

高。

  • 可取值:0~4096-1full

  • 默认值:-1

  • -1代表片源的值,

  • full表示填满画面。

1080
MuxConfigobject

转码封包配置。如果请求参数中设置了此参数,则覆盖指定转码模板中的对应参数。

Webpobject

Webp对应的封包配置。

Loopstring

循环次数。

0
Gifobject

Gif对应的封包配置。

FinalDelaystring

终帧暂停时间,单位:厘秒。

0
DitherModestring

调色板颜色抖动方式。可取值:sierrabayer

bayer
Loopstring

循环次数。

0
IsCustomPalettestring

自定义调色板功能。可取值:

  • true:自定义

  • false:非自定义。

false
Segmentobject

切片配置,JSON对象。

Durationstring

分片时长。整数,单位:秒。

  • 可取值范围:[1,10]

  • 默认值:10秒。

20
TailSlateListarray

尾板列表,JSON对象。

object

返回参数。

Startstring

开始时间。

1
BgColorstring

如果尾板视频的宽、高小于正片时,设置空白处填充的背景色。默认为White,更多取值请参见bgcolor

White
IsMergeAudioboolean

是否要拼接尾板视频的音频内容。可取值:

  • true:拼接。

  • false:不拼接。

false
Widthstring

宽。

  • 可取值:0~4096-1full
  • -1代表片源的值,full表示填满画面。
  • 默认为**-1**。
1920
Heightstring

高。

  • 可取值:0~4096-1full
  • -1代表片源的值,full表示填满画面。
  • 默认为**-1**。
1080
BlendDurationstring

正片视频和尾板视频过渡的时长。过渡的效果是淡入淡出:正片显示最后一帧,同时播放尾板视频,正片最后一帧逐步变暗,尾板视频逐步变亮。单位秒,默认0

2
TailUrlstring

尾板视频的OSS URL地址。

http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
TemplateIdstring

转码模板ID。

S00000000-000010
SubtitleConfigobject

字幕配置信息。

ExtSubtitleListarray

外部字幕列表,JSON数组,最多4个。

object

外部字幕详细信息。

CharEncstring

外部字幕字符编码。

  • 范围:UTF-8GBKBIG5auto
  • 默认:auto
说明外部字幕字符编码设置为auto时,存在误检情况,建议您指定具体的字符编码。
UTF-8
FontNamestring

外挂字幕转换成硬字幕对应的字体名称。默认值:SimSun。更多字体信息请参见字体列表

"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"
Inputobject

JSON对象,外部输入字幕文件。目前支持srtass格式。

Objectstring

输入文件的OSS Object。

example-output.flv
Locationstring

输入文件所在的OSS Location。

oss-cn-hangzhou
Bucketstring

输入文件所在的OSS Bucket。

example-bucket-****
SubtitleListarray

字幕列表。

object

返回参数。

Mapstring

音轨。格式:0:{流}:{流序号} ,即0:a:{audio_index}。流取值为a: audio音频流,序号的含义是音频流列表的下标,序号从0开始。

0:a:0
Propertiesobject

媒体属性。

Widthstring

视频宽。

1280
Heightstring

视频长。

720
Durationstring

时长。

55
Fpsstring

帧率,数字。

25
Bitratestring

码率。

1000
FileFormatstring

文件格式。

QuickTime / MOV
Streamsobject

流信息。

VideoStreamListarray

视频流列表。

object

视频流详细信息。

Indexstring

视频流序号,标识视频流在整个媒体流中的位置。

0
Timebasestring

时基。

1/24000
AvgFPSstring

平均帧率。

23.976025
PixFmtstring

像素格式。

yuv420p
Sarstring

编码信号分辨率比。

1:1
Langstring

语言。更多信息,请参见FFmeg语言定义ISO-639

eng
CodecLongNamestring

编码格式长述名。

H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Heightstring

视频分辨率长。

720
NumFramesstring

总帧数。

25
Bitratestring

码率。

1496.46
CodecTagStringstring

编码格式标记文本。

avc1
HasBFramesstring

是否有B帧。

2
Profilestring

编码预置。

high
StartTimestring

起始时间。

0.000000
NetworkCostobject

网络带宽消耗。

PreloadTimestring

预加载时间。

8
AvgBitratestring

平均码率。

100
CostBandwidthstring

最大消耗带宽。

10
Darstring

编码显示分辨率比。

16:9
CodecNamestring

编码格式简述名。

h264
Widthstring

视频分辨率宽,数字。

1280
Durationstring

时长。

17.225542
Fpsstring

帧率。

23.976025
CodecTagstring

编码格式标记。

0x31637661
CodecTimeBasestring

编码时基。

1001/48000
Levelstring

编码等级。

51
AudioStreamListarray

音频流列表。

object

音频流详细信息。

Timebasestring

时基。

1/44100
Indexstring

音频流序号。标识音频流在整个媒体流中的位置。

1
SampleFmtstring

采样格式。

fltp
ChannelLayoutstring

声道输出样式。

stereo
Langstring

语言。更多信息,请参见FFmeg语言定义ISO-639

eng
Sampleratestring

采样率。

44100
CodecLongNamestring

编码格式长述名。

AAC (Advanced Audio Coding)
Channelsstring

声道数。

2
NumFramesstring

总帧数。

25
Bitratestring

码率。

128.806
CodecTagStringstring

编码格式标记文本。

mp4a
StartTimestring

起始时间。

0.000000
CodecNamestring

编码格式简述名。

aac
Durationstring

时长。

17.159546
CodecTagstring

编码格式标记。

0x6134706d
CodecTimeBasestring

编码时基。

1/44100
SubtitleStreamListarray

字幕流列表。

object

字幕流详细信息。

Indexstring

字幕流序号,标识字幕流在整个媒体流中的位置。

1
Langstring

语言。更多信息,请参见FFmeg语言定义ISO-639

eng
Formatobject

格式信息。

StartTimestring

起始时间。

0.000000
NumProgramsstring

节目流总数。

0
Sizestring

文件大小。

3509895
NumStreamsstring

媒体流总数。

2
FormatLongNamestring

容器、封装格式长述名。

QuickTime / MOV
Durationstring

总时长。

55
Bitratestring

总码率。

1000
FormatNamestring

容器、封装格式简述名。可取值:mov、mp4、m4a、3gp、3g2、mj2。

mov
FileSizestring

文件大小。

3509895
PipelineIdstring

管道ID。

88c6ca184c0e47098a5b665e2a126797
Inputobject

作业输入。

Objectstring

作业输入的OSS Object。

example.flv
Locationstring

作业输入的OSS Location。

oss-cn-hangzhou
Bucketstring

作业输入的OSS Bucket。

example-bucket-****
MNSMessageResultobject

MNS通知用户作业完成的消息结果。

MessageIdstring

失败时错误信息ID。成功时此参数不返回。

123
ErrorMessagestring

失败时错误信息。成功时此参数不返回。

The resource operated "%s" cannot be found.
ErrorCodestring

失败时错误码。成功时此参数不返回。

InvalidParameter.ResourceNotFound
Successboolean

是否成功。可取值:

  • true:成功。

  • false:失败。

true
Codestring

创建作业失败时错误码。创建成功时此参数不返回。

InvalidParameter.NullValue
Messagestring

创建作业失败时错误消息。创建成功时此参数不返回。

The specified parameter "%s" cannot be null.
RequestIdstring

请求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"
}

错误码

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