All Products
Search
Document Center

Intelligent Media Services:MediaConvertJobConfig

Last Updated:Aug 14, 2026

Parameter

Type

Description

Example

object

Konfigurasi pekerjaan transkoding media.

JobName

string

Nama pekerjaan.

  • Panjang maksimum adalah 64 byte.

Name

Inputs

array

Daftar input pekerjaan transkoding.

object

Transcoding job input

Name

string

Input file name. Can be referenced by InputRef in Output.

InputVideo

InputFile

object

Input file

Type

string

媒体文件类型。取值:

  • OSS: OSS 文件。

  • Media: 媒资文件。

OSS

Media

string

媒资文件 URL 或 ID。

  • 当 Type 为 OSS 类型时,media 为 URL(支持 OSS/HTTP 协议),请勿带签名参数,否则可能导致权限校验失败。

  • 当 Type 为 media 类型时,media 为媒资 ID,默认使用源流输入。

http://bucket.loction.aliyuncs.com/path/to/video.mp4

OutputGroups

array

Daftar konfigurasi kelompok output pekerjaan transkoding.

object

Transcoding job output group configuration

Name

string

Output group name

hls-group

GroupConfig

object

Group information configuration.

Type

string

输出组类型,取值:

  • File:独立文件。

  • Hls:HLS 协议文件(生成自适应播放流)。

Hls

OutputFileBase

object

组输出目录。该 OutputGroup 产生的文件都会在该目录下。

Type

string

媒体对象类型,支持:

  • OSS: 阿里云 oss 文件

  • Media: 媒资

OSS

Media

string

文件媒资

  • Type 为 OSS 时,media 为 URL,且支持 OSS 协议和 HTTP 协议。

  • Type 为 Media 时,media 为媒资 ID。默认使用源流作为输入。

oss://bucket/path/to/dir

ManifestName

string

清单文件名称。当 Type Hls 或 Dash 时,用来指定生成的 manifest 文件的文件名。

manifest

ManifestExtend

object

清单文件扩展功能配置。该功能支持引用一个已存在的清单文件,并在此基础上结合当前输出组结果,生成新的清单文件。

InputRef

string

被引用的清单文件,其值为 Input 的 name。

Input-Manifest

Excludes

array

用来排除引用清单文件中的流。条件内部采用与的逻辑,条件之间采用或的逻辑进行筛选。

object

流排除条件。

Language

string

按流的 Language 字段查找被筛选项,遵循 RFC5646 标准。

en

Name

string

按流的 Name 字段查找被筛选项。

audio-1

Type

string

按流的 Type 字段查找被筛选项。

取值:

  • Audio。

  • Subtitle。

Audio

Outputs

array

List of single-output transcoding configurations. Each item in the array represents one output stream file.

object

Single-output transcoding configuration.

Name

string

转码输出名称,仅用于标记输出。

group-output

TemplateId

string

转码模板 ID

****96e8864746a0b6f3****

OutputFileName

string

转码输出文件名。配合 GroupConfig 中 OutputFileBase 一起使用。

720p.mp4

Priority

integer

优先级,数值越大优先级越高,取值:[1,10],默认值为 6。

6

Features

string

功能参数,详情请参见 MediaConvertJobFeature

{}

OverrideParams

string

覆盖参数(JSON 字符串),支持对转码模板关联的参数覆盖。

{}

HlsGroupConfig

object

Hls 组配置。配置当前流在 Manifest 中的行为。仅当组类型为 Hls 时有效。

Type

string

指定输出流类型:

取值:

  • video:视频流,处理时将仅保留与视频相关的设置。

  • audio:音频流,处理时将仅保留与音频相关的设置。

  • subtitle:字幕流,处理时将仅保留与字幕相关的设置。

  • hybrid:混合流,处理时将保留与音频和视频相关的设置。

默认值:hybrid。

hybrid

AudioGroup

string

该路视频流引用的音频组。当 Type 为 video 生效。

默认值: audio

audio

SubtitleGroup

string

该路视频流引用的字幕组。当 Type 为 video 和 hybrid 时生效。

默认值:subtitle

subtitle

Name

string

该输出流在 HLS manifest 中的 NAME 属性。当 Type 为 audio 或 subtitle 时,此项为必填

audio

Group

string

该输出流在 HLS Manifest 中的 GROUP_ID 属性。该属性在 Type 为 audio 和 subtitle 时生效。

默认与 Type 的取值相同。

audio

Language

string

该输出流在 HLS manifest 中的 LANGUAGE 属性,当 Type 为 audio 和 subtitle 时生效,需遵循 RFC 5646 标准。

zh

IsDefault

string

是否设为默认流。当 Type 为 audio 和 subtitle 时生效。同一个 Group 中只能有一个默认流。

false

Forced

string

是否强制显示。当 Type 为 audio 和 subtitle 时生效。

true

AutoSelect

string

是否自动选择流。当 Type 为 audio 和 subtitle 时生效。

true