Todos os produtos
Search
Central de documentação

Intelligent Media Services:MediaConvertJobConfig

Última atualização: Jun 29, 2026

Parâmetro

Tipo

Descrição

Exemplo

object

As configurações da tarefa de transcodificação.

JobName

string

O nome da tarefa.

  • Tamanho máximo: 64 bytes.

Name

Inputs

array

Entradas.

object

Configurações dos arquivos de entrada.

Name

string

O nome do arquivo de entrada. InputRef pode fazer referência a ele na configuração de saída.

InputVideo

InputFile

object

O arquivo de entrada.

Type

string

The type of the media file. Valid values:

  • OSS: an OSS object.

  • Media: a media asset.

OSS

Media

string

The URL or ID of the media file.

  • If Type is OSS, this is the file URL (OSS or HTTP). Do not use a signed URL, as it may cause authentication failure.

  • If Type is Media, this is the media asset ID. The source stream is used by default.

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

OutputGroups

array

Uma matriz de configurações de grupo de saída.

object

Configurações do grupo de saída.

Name

string

O nome do grupo de saída.

hls-group

GroupConfig

object

A configuração para este grupo de saída.

Type

string

The type of the output group. Valid values:

  • File: An individual file.

  • Hls: HLS files for adaptive bitrate streaming.

Hls

OutputFileBase

object

The base output directory. All files generated by this OutputGroup are placed in this directory.

Type

string

The type of the output file. Valid values:

  • OSS: an OSS object.

  • Media: a media asset.

OSS

Media

string

The media asset location.

  • If Type is OSS, this is the destination URL (OSS or HTTP).

  • If Type is Media, this is the destination media asset ID.

oss://bucket/path/to/dir

ManifestName

string

The name of the manifest file. This parameter is only applicable when Type is set to Hls or Dash.

manifest

ManifestExtend

object

Configures an extension to an existing manifest file. This allows you to reference an existing manifest and combine it with the results of the current output group to generate a new manifest.

InputRef

string

References the Name of an input that contains the manifest to be extended.

Input-Manifest

Excludes

array

Specifies streams to exclude from the referenced manifest. Multiple conditions within a single exclusion object are combined using AND logic. Multiple exclusion objects in the array are combined using OR logic.

object

Stream exclusion condition.

Language

string

Excludes streams based on their Language field. It must conform to RFC 5646.

en

Name

string

Excludes streams based on their Name field.

audio-1

Type

string

Excludes streams based on their Type field.

Valid values:

  • Audio

  • Subtitle

Audio

Outputs

array

Uma lista de configurações de fluxo de saída individuais. Cada objeto nesta matriz define uma rendição específica.

object

Configuração de fluxo de saída individual.

Name

string

A name to label this output. This is for identification purposes only and does not affect the filename.

group-output

TemplateId

string

The ID of the transcoding template.

****96e8864746a0b6f3****

OutputFileName

string

The filename for this output. It is used in conjunction with OutputFileBase from the GroupConfig.

720p.mp4

Priority

integer

The priority of the task, from 1 to 10. A higher value indicates a higher priority. Default: 6.

6

Features

string

Additional feature parameters. See MediaConvertJobFeature for details.

{}

OverrideParams

string

A JSON string of parameters to override the settings in the specified template.

{}

HlsGroupConfig

object

HLS-specific settings for this stream's behavior in the manifest. Effective only when the group Type is Hls.

Type

string

Specifies the stream type.

Valid values:

  • video: Video stream.

  • audio: Audio stream.

  • subtitle: Subtitle stream.

  • hybrid: A stream containing both audio and video.

Default value: hybrid.

hybrid

AudioGroup

string

The audio group this video stream references. Effective when Type is video.

Default value: audio.

audio

SubtitleGroup

string

The subtitle group this video or hybrid stream references. Effective when Type is video or hybrid.

Default value: subtitle.

subtitle

Name

string

The NAME attribute for this stream in the HLS manifest. Required when Type is audio or subtitle.

audio

Group

string

The GROUP-ID attribute for this stream in the HLS manifest. Effective when Type is audio or subtitle.

Default value: Same as the Type value.

audio

Language

string

The LANGUAGE attribute for this stream in the HLS manifest (must conform to RFC 5646). Effective when Type is audio or subtitle.

zh

IsDefault

string

Whether this is the default stream within its group. Effective when Type is audio or subtitle. Only one stream per group can be the default.

false

Forced

string

Whether this stream must be played. Effective when Type is audio or subtitle.

true

AutoSelect

string

Whether this stream should be automatically selected by the player. Effective when Type is audio or subtitle.

true