Tous les produits
Search
Centre de documentation

Intelligent Media Services:MediaConvertJobConfig

Dernière mise à jour :Aug 14, 2026

Parameter

Type

Description

Example

object

Les configurations de la tâche de transcodage.

JobName

string

Le nom de la tâche.

  • Longueur maximale : 64 octets.

Name

Inputs

array

Les entrées.

object

Les configurations des fichiers d'entrée.

Name

string

Le nom du fichier d'entrée. InputRef peut y faire référence dans la configuration de sortie.

InputVideo

InputFile

object

Le fichier d'entrée.

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

Un tableau de configurations de groupes de sortie.

object

Les configurations du groupe de sortie.

Name

string

Le nom du groupe de sortie.

hls-group

GroupConfig

object

La configuration de ce groupe de sortie.

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

Une liste de configurations de flux de sortie individuels. Chaque objet de ce tableau définit une version spécifique.

object

Configuration de flux de sortie individuel.

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