All Products
Search

This Product

    Intelligent Media Services:MediaConvertJobConfig

    Document Center

    Intelligent Media Services:MediaConvertJobConfig

    Last Updated:Jan 13, 2026
    ParameterTypeDescriptionExample
    object

    The configurations of the transcoding task.

    JobNamestring

    The task name.

    • Maximum length: 64 bytes.
    		Name
    Inputsarray<object>

    Inputs.

    object

    Input file configurations.

    Namestring

    The name of the input file. InputRef can reference it in the output configuration.

    		InputVideo
    InputFileobject

    The input file.

    Typestring

    The type of the media file. Valid values:

    • OSS: an OSS object.
    • Media: a media asset.
    		OSS
    Mediastring

    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
    OutputGroupsarray<object>

    An array of output group configurations.

    object

    Output group configurations.

    Namestring

    The name of the output group.

    		hls-group
    GroupConfigobject

    The configuration for this output group.

    Typestring

    The type of the output group. Valid values:

    • File: An individual file.
    • Hls: HLS files for adaptive bitrate streaming.
    		Hls
    OutputFileBaseobject

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

    Typestring

    The type of the output file. Valid values:

    • OSS: an OSS object.
    • Media: a media asset.
    		OSS
    Mediastring

    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
    ManifestNamestring

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

    		manifest
    ManifestExtendobject

    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.

    InputRefstring

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

    		Input-Manifest
    Excludesarray<object>

    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.

    Languagestring

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

    		en
    Namestring

    Excludes streams based on their Name field.

    		audio-1
    Typestring

    Excludes streams based on their Type field.

    Valid values:

    • Audio
    • Subtitle
    		Audio
    Outputsarray<object>

    A list of individual output stream configurations. Each object in this array defines a specific rendition.

    object

    Individual output stream configuration.

    Namestring

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

    		group-output
    TemplateIdstring

    The ID of the transcoding template.

    		****96e8864746a0b6f3****
    OutputFileNamestring

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

    		720p.mp4
    Priorityinteger

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

    		6
    Featuresstring

    Additional feature parameters. See MediaConvertJobFeature for details.

    		{}
    OverrideParamsstring

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

    		{}
    HlsGroupConfigobject

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

    Typestring

    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
    AudioGroupstring

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

    Default value: audio.

    		audio
    SubtitleGroupstring

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

    Default value: subtitle.

    		subtitle
    Namestring

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

    		audio
    Groupstring

    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
    Languagestring

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

    		zh
    IsDefaultstring

    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
    Forcedstring

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

    		true
    AutoSelectstring

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

    		true