All Products
Search

This Product

    Intelligent Media Services:MediaConvertJobFeature

    Document Center

    Intelligent Media Services:MediaConvertJobFeature

    Last Updated:Dec 23, 2025
    ParameterTypeDescriptionExample
    object

    Parameters for transcoding features.

    Clipobject

    Configuration for clipping from the source video.

    TimeSpanobject

    The time range for the clip.

    Durationstring

    The duration of the clip, starting from the Seek time. The default duration is from the Seek time to the end of the video. Duration and End are mutually exclusive. If End is set, Duration is ignored.

    • Format: hh:mm:ss[.SSS] or sssss[.SSS].
    • Valid values: [00:00:00.000,23:59:59.999] or [0.000,86399.999].
    • Example: 00:01:59.99 or 180.30.
    		60.0
    Endstring

    Specifies a duration to trim from the end of the video. Duration and End are mutually exclusive. If End is set, Duration is ignored.

    • Format: hh:mm:ss[.SSS] or sssss[.SSS].
    • Valid values: [00:00:00.000,23:59:59.999] or [0.000,86399.999].
    • Example: 00:01:59.99 or 180.30.
    		50
    Seekstring

    The start time of the clip. It defaults to the beginning of the video.

    • Format: hh:mm:ss[.SSS] or sssss[.SSS].
    • Valid values: [00:00:00.000,23:59:59.999] or [0.000,86399.999].
    • Example: 00:01:59.99 or 180.30.
    		180.30
    ConfigToClipFirstPartstring

    Specifies the order of operations when concatenating multiple files and clipping.

    • true: Clips the first input file before it is concatenated.
    • false: Concatenates all input files first, then applies clipping.
    • Default value: false.
    		false
    Watermarksarray<object>

    Image or text watermarks to add to the video. These parameters override the corresponding settings from a specified watermark template.

    • You can add up to four watermarks to a transcoding task.
    object

    Configuration for a single watermark.

    FontColorstring

    The font color of the text watermark.

    • Default value: black.
    		black
    BorderColorstring

    The color of the font border.

    • Default value: Black.
    		Black
    BorderWidthstring

    The width of the font border.

    • Unit: pixels.
    • Valid values: [0,4096].
    • Default value: 0.
    		0
    FontAlphastring

    The font opacity.

    • Valid values: (0,1].
    • Default value: 1.0.
    		1.0
    Typestring

    The watermark type.

    • Text: a text watermark. In this case, you must specify the parameters related to the text watermark.
    • Image: an image watermark. In this case, you must specify the parameters related to the image watermark.

    If not specified, the type is inferred from the TemplateId.

    		Image
    Adaptivestring

    Specifies if the font size adapts to the output resolution. Valid values:

    • true
    • false
    • Default value: false.
    		true
    FontSizestring

    The font size of the text watermark.

    • Valid values: (4,120).
    • Default value: 16.
    Contentstring

    The text to be displayed as the watermark.

    		TextWatarmark
    Xstring

    The horizontal offset of the image watermark relative to the output video. This parameter overrides the corresponding setting from a specified watermark template. The following value types are supported:

    • Integer: the pixel value of the horizontal offset.

      • Unit: pixels.
      • Valid values: [8,4096].

    • Decimal: the ratio of the horizontal offset to the width of the output video.

      • Valid values: (0,1).
      • The decimal number can be accurate to four decimal places, such as 0.9999. Excessive digits are automatically discarded.
    		0.08
    FontNamestring

    The font of the text watermark.

    • Default value: SimSum.
    		SimSum
    Ystring

    The vertical offset of the image watermark relative to the output video. This parameter overrides the corresponding setting from a specified watermark template. The following value types are supported:

    • Integer: the pixel value of the vertical offset.

      • Unit: pixels.
      • Valid values: [8,4096].

    • Decimal: the ratio of the vertical offset to the height of the output video.

      • Valid values: (0,1).
      • The decimal number can be accurate to four decimal places, such as 0.9999. Excessive digits are automatically discarded.
    		0.08
    Heightstring

    The height of the image watermark. This parameter overrides the corresponding setting from a specified watermark template. The following value types are supported:

    • Integer: the pixel value of the watermark height.

      • Valid values: [8,4096].

    • Decimal: A decimal of the output video's height.

      • Valid values: (0,1).
      • The decimal number can be accurate to four decimal places, such as 0.9999. Excessive digits are automatically discarded.
    		0.1
    Widthstring

    The width of the image watermark. This parameter overrides the corresponding setting from a specified watermark template. The following value types are supported:

    • Integer: the pixel value of the watermark width.

      • Valid values: [8,4096].

    • Decimal: A decimal of the output video's width.

      • Valid values: (0,1).
      • The decimal number can be accurate to four decimal places, such as 0.9999. Excessive digits are automatically discarded.
    		0.1
    TemplateIdstring

    The ID of the watermark template.

    		962e1332fa2d4e12bdfb76dd1402fcfa
    Metadataobject

    A map of key-value pairs to be embedded as container-level metadata in the output file. Provided as a JSON string. Example: {"key1":"value1","key2":"value2"}.

    • Max key length: 64 characters.
    • Max value length: 512 characters.

    Max 4 key-value pairs.

    string

    The metadata of the vector data, which is a JSON string in the MAP format. The key specifies the field name, and the value specifies the data type.

    		{"AIGC": "xxx"}