SubmitTranscodeJob - 提交转码任务

提交转码任务。

调试

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

调试

授权信息

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

请求参数

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

任务名字。

job-name
InputGrouparray

任务输入组(目前只支持一个)。

object

任务输入。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
OutputGrouparray

任务输出组。

object

任务输出。

Outputobject

输出媒体配置。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
ProcessConfigobject

任务处理配置。

Transcodeobject

转码配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Videoobject

video 设置。

Codecstring

编码格式。

H.264
Profilestring

编码级别。 支持baseline、main、high。 baseline:针对移动设备。 main:针对标准分辨率设备。 high:针对高分辨率设备。 默认值:high。

Main
Bitratestring

视频平均码率。 取值范围:[10,50000]。 单位:Kbps。

3000
Crfstring

码率-质量控制因子。 取值范围:[0,51]。 默认值:编码格式为H264,默认值为23。编码格式为H265,默认值为26。 如果设置了Crf,则Bitrate的设置失效。

23
Widthstring

宽。 取值范围:[128,4096]。 单位:px。 默认值:视频原始宽度。

1920
Heightstring

高。 取值范围:[128,4096]。 单位:px。 默认值:视频原始高度。

1080
Fpsstring

帧率。 取值范围:(0,60]。 当输入文件帧率超过60时取60。 默认值:取输入文件帧率

25
Gopstring

关键帧间最大帧数。 取值范围:[1,1080000]。 默认值:250。

250
Presetstring

视频算法器预置。只有H264支持该参数。 支持veryfast、fast、medium、slow、slower。 默认值:medium。

medium
ScanModestring

扫描模式。 支持interlaced、progressive。

progressive
PixFmtstring

视频颜色格式。 范围:yuv420p,yuvj420p等标准颜色格式。

yuv420p
Removestring

是否去掉视频。

false
Cropstring

视频画面裁切 支持2种方式。 自动检测黑边并裁切,设置为“border” 自定义裁切,参数格式:width:height:left:top。 示例:1280:800:0:140

1280:800:0:140
Padstring

视频贴黑边 参数格式:width:height:left:top。 示例:1280:800:0:140

1280:800:0:140
LongShortModestring

是否开启横竖屏自适应(即:长短边模式)

false
Bufsizestring

缓冲区大小 值范围:[1000,128000] 默认值:6000 单位:Kb

6000
Maxratestring

视频码率峰值 值范围[10,50000],单位Kbps。

9000
AbrMaxstring

abr 最大码率(只有窄高1有效) 值范围[10,50000],单位Kbps。

6000
Audioobject

audio 设置。

Codecstring

音频编解码格式,AAC、MP3、VORBIS、FLAC。 默认值:AAC。

AAC
Profilestring

音频编码预置。 当Codec为 AAC时,范围aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

aac_low
Sampleratestring

采样率。 默认值:44100。 支持22050、32000、44100、48000、96000。 单位:Hz。

44100
Bitratestring

输出文件的音频码率。 值范围:[8,1000] 单位:Kbps 默认值:128

128
Channelsstring

声道数。 默认值:2

2
Removestring

是否删除音频流。

false
Volumeobject

音量控制。

Methodstring

音量调整方式。

auto
IntegratedLoudnessTargetstring

目标音量。

-6
TruePeakstring

最大峰值。

-1
LoudnessRangeTargetstring

音量范围。

8
Containerobject

封装格式设置。

Formatstring

容器格式。

mp4
MuxConfigobject

封装设置。

Segmentobject

切片设置。

Durationstring

切片时长。

10
ForceSegTimestring

强制切片时间点。

2,3
ImageWatermarksarray

图片水印配置。

object

图片水印配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Widthstring

输出视频上水印图片宽。 值有两种形式:

  • 整数型代水印图片宽的像素值。
    • 范围:[8,4096]
    • 单位:px
  • 小数型代表相对输出视频分辨率宽的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃。
32
Heightstring

输出视频上水印图片高。 值有两种形式:

  • 整数型代水印图片高的像素值。
    • 范围:[8,4096]
    • 单位:px
  • 小数型代表相对输出视频分辨率高的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃。
32
Dxstring

水印图片相对输出视频的水平偏移量。 默认值:0

值有两种形式:

  • 整数型代表偏移像素。
    • 范围:[8,4096]
    • 单位:px
  • 小数型代表水平偏移量与输出分辨率宽的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃
10
Dystring

水印图片相对输出视频的垂直偏移量。 默认值:0

值有两种形式:

  • 整数型代表偏移像素。
    • 范围[8,4096]
    • 单位:px
  • 小数型代表垂直偏移量与输出分辨率高的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃
10
ReferPosstring

水印的位置。

  • 可取值:TopRight(右上)、TopLeft(左上)、BottomRight(右下)、BottomLeft(左下)
  • 默认值:TopRight
TopLeft
Timelineobject

动态水印,显示时间设置。

Startstring

水印开始出现时间。

  • 单位:秒
  • 取值范围:数字
  • 默认值:0
00:00:05
Durationstring

水印持续时间。

  • 取值范围:[数字,ToEND]
  • 默认值:ToEND
ToEND
Fileobject

水印图片文件。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
TextWatermarksarray

文字水印配置。

object

文字水印配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Contentstring

水印文本,不需要 base64 encode,字符串需要 utf-8 编码。

测试水印
FontNamestring

字体。默认:SimSun。

SimSun
FontColorstring

颜色。

#006400
FontAlphastring

字体透明度。

  • 范围:(0, 1]
  • 默认:1.0
1.0
Topstring

文本上边距。

  • 默认:0
  • 范围:[0,4096]
10
Leftstring

文本左边距。

  • 默认:0
  • 范围:[0,4096]
10
FontSizeinteger

字体大小。

  • 默认值:16
  • 范围:(4, 120)
16
BorderWidthinteger

描边宽度。

  • 默认:0
  • 范围:(0,4096]
0
BorderColorstring

描边颜色。 默认:Black 更多取值请参见BorderColor。

#006400
Adaptivestring

根据输出视频大小调整字体 size。 true / false, default: false

false
Subtitlesarray

字幕压制配置。

object

字幕压制配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Formatstring

字幕文件格式。

vtt
CharEncstring

文件 encoding 格式。

UTF-8
Fileobject

字幕文件。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
UserDatastring

用户数据。

user-data
ScheduleConfigobject

任务调度信息。

job-name
PipelineIdstring

管道 ID。

e37ebee5d98b4781897f6086e89f9c56
Priorityinteger

任务优先级。数字越大优先级越高,取值范围:1~10

5

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID

31E30781-9495-5E2D-A84D-759B0A01E262
TranscodeParentJobobject

TranscodeParentJobWithSubJobDTO

TranscodeJobListarray

子任务列表。

object

子任务详情。

CreateTimestring

任务创建时间。

2022-01-12T08:49:41Z
Namestring

任务名。

transcode-job
ParentJobIdstring

主任务 ID

8b2198504dd340b7b3c9842a74fc9baa
JobIdstring

子任务 ID

7d6a7e0d4db2457a8d45ff5d43e1bf0a
JobIndexinteger

子任务在整个任务中的索引号。

0
InputGrouparray

任务输入组(目前只支持单个输入)。

object

作业输入。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
ProcessConfigobject

转码处理配置。

Transcodeobject

转码配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Videoobject

video 设置。

Codecstring

编码格式。

H.264
Profilestring

编码级别。 支持baseline、main、high。 baseline:针对移动设备。 main:针对标准分辨率设备。 high:针对高分辨率设备。 默认值:high。

Main
Bitratestring

视频平均码率。 取值范围:[10,50000]。 单位:Kbps。

3000
Crfstring

码率-质量控制因子。 取值范围:[0,51]。 默认值:编码格式为H264,默认值为23。编码格式为H265,默认值为26。 如果设置了Crf,则Bitrate的设置失效。

23
Widthstring

宽。 取值范围:[128,4096]。 单位:px。 默认值:视频原始宽度。

1920
Heightstring

高。 取值范围:[128,4096]。 单位:px。 默认值:视频原始高度。

1080
Fpsstring

帧率。 取值范围:(0,60]。 当输入文件帧率超过60时取60。 默认值:取输入文件帧率

25
Gopstring

关键帧间最大帧数。 取值范围:[1,1080000]。 默认值:250。

250
Presetstring

视频算法器预置。只有H264支持该参数。 支持veryfast、fast、medium、slow、slower。 默认值:medium。

medium
ScanModestring

扫描模式。 支持interlaced、progressive。

progressive
PixFmtstring

视频颜色格式。 范围:yuv420p,yuvj420p等标准颜色格式。

yuv420p
Removestring

是否去掉视频。

false
Cropstring

视频画面裁切 支持2种方式。 自动检测黑边并裁切,设置为“border” 自定义裁切,参数格式:width:height:left:top。 示例:1280:800:0:140

1280:800:0:140
Padstring

视频贴黑边 参数格式:width:height:left:top。 示例:1280:800:0:140

1280:800:0:140
LongShortModestring

是否开启横竖屏自适应(即:长短边模式)

false
Bufsizestring

缓冲区大小 值范围:[1000,128000] 默认值:6000 单位:Kb

6000
Maxratestring

视频码率峰值 值范围[10,50000],单位Kbps。

9000
AbrMaxstring

abr 最大码率(只有窄高1有效) 值范围[10,50000],单位Kbps。

6000
Audioobject

audio 设置。

Codecstring

音频编解码格式,AAC、MP3、VORBIS、FLAC。 默认值:AAC

AAC
Profilestring

音频编码预置。 当Codec为 AAC时,范围aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

aac_low
Sampleratestring

采样率。 默认值:44100 支持22050、32000、44100、48000、96000, 单位:Hz

44100
Bitratestring

输出文件的音频码率。 值范围:[8,1000] 单位:Kbps 默认值:128

128
Channelsstring

声道数。 默认值:2

2
Removestring

是否删除音频流。

false
Volumeobject

音量控制。

Methodstring

音量调整方式。

auto
IntegratedLoudnessTargetstring

目标音量。

-6
TruePeakstring

最大峰值。

-1
LoudnessRangeTargetstring

音量范围。

8
Containerobject

封装格式设置。

Formatstring

容器格式。

mp4
MuxConfigobject

封装设置。

Segmentobject

切片设置。

Durationstring

切片时长。

10
ForceSegTimestring

强制切片时间点。

2,3
ImageWatermarksarray

图片水印配置。

object

图片水印配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数

Widthstring

输出视频上水印图片宽。 值有两种形式:

  • 整数型代水印图片宽的像素值。
    • 范围:[8,4096]
    • 单位:px
  • 小数型代表相对输出视频分辨率宽的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃。
32
Heightstring

输出视频上水印图片高。 值有两种形式:

  • 整数型代水印图片高的像素值。
    • 范围:[8,4096]
    • 单位:px
  • 小数型代表相对输出视频分辨率高的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃。
32
Dxstring

水印图片相对输出视频的水平偏移量。 默认值:0

值有两种形式:

  • 整数型代表偏移像素。
    • 范围:[8,4096]
    • 单位:px
  • 小数型代表水平偏移量与输出分辨率宽的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃
10
Dystring

水印图片相对输出视频的垂直偏移量。 默认值:0

值有两种形式:

  • 整数型代表偏移像素。
    • 范围[8,4096]
    • 单位:px
  • 小数型代表垂直偏移量与输出分辨率高的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃
10
ReferPosstring

水印的位置。

  • 可取值:TopRight(右上)、TopLeft(左上)、BottomRight(右下)、BottomLeft(左下)
  • 默认值:TopRight
TopLeft
Timelineobject

动态水印,显示时间设置。

Startstring

水印开始出现时间。

  • 单位:秒
  • 取值范围:数字
  • 默认值:0
00:00:05
Durationstring

水印持续时间。

  • 取值范围:[数字,ToEND]
  • 默认值:ToEND
ToEND
Fileobject

水印图片文件。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
TextWatermarksarray

文字水印配置。

object

文字水印配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数

Contentstring

水印文本,不需要 base64 encode,字符串需要 utf-8 编码。

测试水印
FontNamestring

字体。默认:SimSun。

SimSun
FontColorstring

颜色。

#006400
FontAlphastring

字体透明度。

  • 范围:(0, 1]
  • 默认:1.0
1.0
Topstring

文本上边距。

  • 默认:0
  • 范围:[0,4096]
10
Leftstring

文本左边距。

  • 默认:0
  • 范围:[0,4096]
10
FontSizeinteger

字体大小。

  • 默认值:16
  • 范围:(4, 120)
16
BorderWidthinteger

描边宽度。

  • 默认:0
  • 范围:(0,4096]
0
BorderColorstring

描边颜色。 默认:Black 更多取值请参见BorderColor。

#006400
Adaptivestring

根据输出视频大小调整字体 size。 true / false, default: false

false
Subtitlesarray

字幕压制配置。

object

字幕压制配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Formatstring

字幕文件格式。

vtt
CharEncstring

文件 encoding 格式。

UTF-8
Fileobject

字幕文件。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
Outputobject

输出媒体配置。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
UserDatastring

用户数据。

user-data
ScheduleConfigobject

任务调度信息。

PipelineIdstring

管道 ID。

e37ebee5d98b4781897f6086e89f9c56
Priorityinteger

任务优先级。数字越大优先级越高,取值范围:1~10

5
Statusstring

转码任务状态 - Init:已提交, Processing:转码中, Success:转码成功, Fail:转码失败, Deleted:已删除

Init
OutFileMetaobject

任务生成视频 Media 信息。

FileBasicInfoobject

基础文件信息。

MediaIdstring

媒资 ID。

73e07de0f77171eca3fc7035d0b26402
FileNamestring

文件名。

file.m3u8
FileStatusstring

文件状态。

Normal
FileTypestring

文件类型。取值:source_file, transcode_file

source_file
FileSizestring

文件大小。单位:Byte。

31737
FileUrlstring

文件 URL。

http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8
Regionstring

文件所在区域。

cn-shanghai
FormatNamestring

视频格式名称。

hls,applehttp
Durationstring

视频时长(单位:秒)。

403.039999
Bitratestring

视频码率。

888.563
Widthstring

宽。

848
Heightstring

高。

478
AudioStreamInfoListarray

音频流信息。

object

音频流信息。

Indexstring

流序号。

1
CodecNamestring

编码格式。

aac
CodecLongNamestring

编码格式名。

AAC (Advanced Audio Coding)
CodecTimeBasestring

编码器时间基。

1/44100
CodecTagStringstring

编码器标签名。

[15][0][0][0]
CodecTagstring

编码器标签。

0x000f
SampleFmtstring

采样格式。

fltp
SampleRatestring

采样率(单位:Hz)。

44100
Channelsstring

声道数。

2
ChannelLayoutstring

声道布局。

stereo
Timebasestring

时间基。

1/90000
StartTimestring

开始时间。

1.473556
Durationstring

时长(单位:秒)。

403.039989
Bitratestring

码率。

0.f
Langstring

语言。

cn
VideoStreamInfoListarray

视频流信息。

object

视频流信息。

Indexstring

流序号。

0
Codec_namestring

编码格式。

h264
Codec_long_namestring

编码格式名。

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

编码器预设。

High
Codec_time_basestring

编码时基。

1/50
Codec_tag_stringstring

编码格式标记文本。

[27][0][0][0]
Codec_tagstring

编码格式标记。

0x001b
Widthstring

宽。

848
Heightstring

高。

478
Has_b_framesstring

是否有B帧。 取值:

  • 0: 没有 B 帧,
  • 1: 有一个 B 帧,
  • 2: 有多个连续 B 帧。
2
Sarstring

采集点数宽高比。

478:477
Darstring

图像显示宽高比。

16:9
PixFmtstring

颜色存储格式。

yuv420p
Levelstring

编码等级。

31
Fpsstring

帧率。

25.0
Avg_fpsstring

平均帧率。

25.0
Time_basestring

时基。

1/90000
Start_timestring

起始时间。

1.473556
Durationstring

时长(单位:秒)。

403.039989
Bit_ratestring

码率。

888.563
NumFramesstring

总帧数。

10040
Langstring

语言。

cn
Rotatestring

视频画面旋转角度。 取值 0, 90, 180, 270。 默认值 0

0
SubmitResultJsonobject

任务提交结果。

{}
SubmitTimestring

任务提交时间。

2022-01-12T08:49:41Z
FinishTimestring

任务结束时间。

2022-01-12T08:49:41Z
RequestIdstring

提交任务时请求 ID。

31E30781-9495-5E2D-A84D-759B0A01E262
CreateTimestring

任务创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ 。

2022-01-12T08:49:41Z
Namestring

任务名。

transcode-job
RequestIdstring

提交任务时请求 ID。

31E30781-9495-5E2D-A84D-759B0A01E262
ParentJobIdstring

主任务 ID。

8b2198504dd340b7b3c9842a74fc9baa
JobCountinteger

子任务数量。

1
Statusstring

任务状态。 Success: 所有子任务完成后,有一个子任务则为成功, Fail: 所有子任务失败。

Success
TriggerSourcestring

任务来源。 API: API, WorkFlow: 工作流, Console: 控制台

API
Percentinteger

任务完成百分比。

0
SubmitTimestring

任务提交时间。格式为:yyyy-MM-ddTHH:mm:ssZ 。

2022-01-12T08:49:41Z
FinishTimestring

任务结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ 。

2022-01-12T08:49:41Z
InputGrouparray

任务输入组(目前只支持单个输入)。

object

作业输入。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
OutputGrouparray

任务输出组。

object

作业输出。

Outputobject

输出媒体配置。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
ProcessConfigobject

任务处理配置。

Transcodeobject

转码配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Videoobject

video 设置

Codecstring

编码格式。

H.264
Profilestring

编码级别。 支持baseline、main、high。 baseline:针对移动设备。 main:针对标准分辨率设备。 high:针对高分辨率设备。 默认值:high。

Main
Bitratestring

视频平均码率。 取值范围:[10,50000]。 单位:Kbps。

3000
Crfstring

码率-质量控制因子。 取值范围:[0,51]。 默认值:编码格式为H264,默认值为23。编码格式为H265,默认值为26。 如果设置了Crf,则Bitrate的设置失效。

23
Widthstring

宽。 取值范围:[128,4096]。 单位:px。 默认值:视频原始宽度。

1920
Heightstring

高。 取值范围:[128,4096]。 单位:px。 默认值:视频原始高度。

1080
Fpsstring

帧率。 取值范围:(0,60]。 当输入文件帧率超过60时取60。 默认值:取输入文件帧率

25
Gopstring

关键帧间最大帧数。 取值范围:[1,1080000]。 默认值:250。

250
Presetstring

视频算法器预置。只有H264支持该参数。 支持veryfast、fast、medium、slow、slower。 默认值:medium。

medium
ScanModestring

扫描模式。 支持interlaced、progressive。

progressive
PixFmtstring

视频颜色格式。 范围:yuv420p,yuvj420p等标准颜色格式。

yuv420p
Removestring

是否去掉视频。

false
Cropstring

视频画面裁切。 支持2种方式。 自动检测黑边并裁切,设置为“border” 自定义裁切,参数格式:width:height:left:top。 示例:1280:800:0:140

1280:800:0:140
Padstring

视频贴黑边。 参数格式:width:height:left:top。 示例:1280:800:0:140

1280:800:0:140
LongShortModestring

是否开启横竖屏自适应(即:长短边模式)

false
Bufsizestring

缓冲区大小。 值范围:[1000,128000] 默认值:6000 单位:Kb

6000
Maxratestring

视频码率峰值。 值范围[10,50000],单位Kbps。

9000
AbrMaxstring

abr 最大码率(只有窄高1有效) 值范围[10,50000],单位Kbps。

6000
Audioobject

audio 设置。

Codecstring

音频编解码格式,AAC、MP3、VORBIS、FLAC。 默认值:AAC

AAC
Profilestring

音频编码预置。 当Codec为 AAC时,范围aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

aac_low
Sampleratestring

采样率。 默认值:44100 支持22050、32000、44100、48000、96000, 单位:Hz

44100
Bitratestring

输出文件的音频码率。 值范围:[8,1000] 单位:Kbps 默认值:128

128
Channelsstring

声道数。 默认值:2

2
Removestring

是否删除音频流。

false
Volumeobject

音量控制。

Methodstring

音量调整方式。

auto
IntegratedLoudnessTargetstring

目标音量。

-6
TruePeakstring

最大峰值。

-1
LoudnessRangeTargetstring

音量范围。

8
Containerobject

封装格式设置。

Formatstring

容器格式。

mp4
MuxConfigobject

封装设置。

Segmentobject

切片设置。

Durationstring

切片时长。

10
ForceSegTimestring

强制切片时间点。

2,3
ImageWatermarksarray

图片水印配置。

object

图片水印配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Widthstring

输出视频上水印图片宽。 值有两种形式:

  • 整数型代水印图片宽的像素值。
    • 范围:[8,4096]
    • 单位:px
  • 小数型代表相对输出视频分辨率宽的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃。
32
Heightstring

输出视频上水印图片高。 值有两种形式:

  • 整数型代水印图片高的像素值。
    • 范围:[8,4096]
    • 单位:px
  • 小数型代表相对输出视频分辨率高的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃。
32
Dxstring

水印图片相对输出视频的水平偏移量。 默认值:0

值有两种形式:

  • 整数型代表偏移像素。
    • 范围:[8,4096]
    • 单位:px
  • 小数型代表水平偏移量与输出分辨率宽的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃
10
Dystring

水印图片相对输出视频的垂直偏移量。 默认值:0

值有两种形式:

  • 整数型代表偏移像素。
    • 范围[8,4096]
    • 单位:px
  • 小数型代表垂直偏移量与输出分辨率高的比率。
    • 范围:(0,1)
    • 支持4位小数,如0.9999,超出部分系统自动丢弃
10
ReferPosstring

水印的位置。

  • 可取值:TopRight(右上)、TopLeft(左上)、BottomRight(右下)、BottomLeft(左下)
  • 默认值:TopRight
TopLeft
Timelineobject

动态水印,显示时间设置。

Startstring

水印开始出现时间。

  • 单位:秒
  • 取值范围:数字
  • 默认值:0
00:00:05
Durationstring

水印持续时间。

  • 取值范围:[数字,ToEND]
  • 默认值:ToEND
ToEND
Fileobject

水印图片文件。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
TextWatermarksarray

文字水印配置。

object

文字水印配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Contentstring

水印文本,不需要 base64 encode,字符串需要 utf-8 编码。

测试水印
FontNamestring

字体。默认:SimSun。

SimSun
FontColorstring

颜色。

#006400
FontAlphastring

字体透明度。

  • 范围:(0, 1]
  • 默认:1.0
1.0
Topstring

文本上边距。

  • 默认:0
  • 范围:[0,4096]
10
Leftstring

文本左边距。

  • 默认:0
  • 范围:[0,4096]
10
FontSizeinteger

字体大小。

  • 默认值:16
  • 范围:(4, 120)
16
BorderWidthinteger

描边宽度。

  • 默认:0
  • 范围:(0,4096]
0
BorderColorstring

描边颜色。 默认:Black 更多取值请参见BorderColor。

#006400
Adaptivestring

根据输出视频大小调整字体 size。 true / false, default: false

false
Subtitlesarray

字幕压制配置。

object

字幕压制配置。

TemplateIdstring

模板 ID。

9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParamsobject

覆盖参数, 若填写会覆盖模板对应参数。

Formatstring

字幕文件格式。

vtt
CharEncstring

文件 encoding 格式。

UTF-8
Fileobject

字幕文件。

Typestring

媒体对象类型。 取值:

  • OSS: OSS文件。
  • Media: 媒资 ID。
OSS
Mediastring

媒体值: type 为 OSS 时,为 URL, 支持 OSS 协议和 HTTP 协议; type 为 Media 时,为媒资 ID。

oss://bucket/path/to/video.mp4
UserDatastring

用户数据。

user-data
ScheduleConfigobject

任务调度配置。

PipelineIdstring

管道 ID。

e37ebee5d98b4781897f6086e89f9c56
Priorityinteger

任务优先级。数字越大优先级越高,取值范围:1~10

5

示例

正常返回示例

JSON格式

{
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "TranscodeParentJob": {
    "TranscodeJobList": [
      {
        "CreateTime": "2022-01-12T08:49:41Z",
        "Name": "transcode-job",
        "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
        "JobId": "7d6a7e0d4db2457a8d45ff5d43e1bf0a",
        "JobIndex": 0,
        "InputGroup": [
          {
            "Type": "OSS",
            "Media": "oss://bucket/path/to/video.mp4"
          }
        ],
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "测试水印",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ]
        },
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4"
        },
        "UserData": "user-data",
        "ScheduleConfig": {
          "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
          "Priority": 5
        },
        "Status": "Init",
        "OutFileMeta": {
          "FileBasicInfo": {
            "MediaId": "73e07de0f77171eca3fc7035d0b26402",
            "FileName": "file.m3u8",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "31737",
            "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
            "Region": "cn-shanghai",
            "FormatName": "hls,applehttp",
            "Duration": "403.039999",
            "Bitrate": "888.563",
            "Width": "848",
            "Height": "478"
          },
          "AudioStreamInfoList": [
            {
              "Index": "1",
              "CodecName": "aac",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "CodecTimeBase": "1/44100",
              "CodecTagString": "[15][0][0][0]",
              "CodecTag": "0x000f",
              "SampleFmt": "fltp",
              "SampleRate": "44100",
              "Channels": "2",
              "ChannelLayout": "stereo",
              "Timebase": "1/90000",
              "StartTime": "1.473556",
              "Duration": "403.039989",
              "Bitrate": "0.f",
              "Lang": "cn"
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "0",
              "Codec_name": "h264",
              "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
              "Profile": "High",
              "Codec_time_base": "1/50",
              "Codec_tag_string": "[27][0][0][0]",
              "Codec_tag": "0x001b",
              "Width": "848",
              "Height": "478",
              "Has_b_frames": "2",
              "Sar": "478:477",
              "Dar": "16:9",
              "PixFmt": "yuv420p",
              "Level": "31",
              "Fps": "25.0",
              "Avg_fps": "25.0",
              "Time_base": "1/90000",
              "Start_time": "1.473556",
              "Duration": "403.039989",
              "Bit_rate": "888.563",
              "NumFrames": "10040",
              "Lang": "cn",
              "Rotate": "0"
            }
          ]
        },
        "SubmitResultJson": "{}",
        "SubmitTime": "2022-01-12T08:49:41Z",
        "FinishTime": "2022-01-12T08:49:41Z",
        "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262"
      }
    ],
    "CreateTime": "2022-01-12T08:49:41Z",
    "Name": "transcode-job",
    "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
    "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
    "JobCount": 1,
    "Status": "Success",
    "TriggerSource": "API",
    "Percent": 0,
    "SubmitTime": "2022-01-12T08:49:41Z",
    "FinishTime": "2022-01-12T08:49:41Z",
    "InputGroup": [
      {
        "Type": "OSS",
        "Media": "oss://bucket/path/to/video.mp4"
      }
    ],
    "OutputGroup": [
      {
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4"
        },
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "测试水印",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ]
        }
      }
    ],
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    }
  }
}

错误码

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

阿里云首页 智能媒体生产 相关技术圈