All Products
Search

This Product

    Intelligent Media Management:TargetVideo

    Document Center

    Intelligent Media Management:TargetVideo

    Last Updated:Jul 16, 2026

    Parameter

    Type

    Description

    Example

    object

    Pengaturan parameter pemrosesan video.

    DisableVideo

    boolean

    Apakah akan menonaktifkan pembuatan aliran video. Nilai valid:

    • true: Dinonaktifkan. File output tidak berisi aliran video.

    • false (default): Tidak dinonaktifkan.

    false
    Stream

    array

    Daftar nomor indeks aliran video yang akan diproses dari file sumber. Nilai kosong (default) menunjukkan bahwa aliran video dengan nomor indeks terkecil (aliran video pertama) diproses. Nomor indeks lebih besar dari 100 menunjukkan bahwa semua aliran video diproses.

    • Contoh: [0,1] memproses aliran video dengan nomor indeks 0 dan 1. [1] memproses aliran video dengan nomor indeks 1. [101] memproses semua aliran video.

    Catatan

    Hanya aliran video dengan nomor indeks yang ada yang diproses. Jika aliran video yang sesuai dengan nomor indeks tidak ada, nomor indeks tersebut diabaikan.

    integer

    Nomor indeks aliran video yang akan diproses.

    0
    TranscodeVideo

    object

    Parameter transkoding video. Nilai kosong menunjukkan bahwa pemrosesan video dinonaktifkan dan file output tidak berisi aliran video.

    Catatan

    Menetapkan parameter ini ke nilai kosong untuk menonaktifkan pemrosesan video tidak direkomendasikan.

    Codec

    string

    Format encoding video. Nilai valid:

    • Untuk API CreateMediaConvert: copy (default), h264, h265, vp9.
      Peringatan Jika parameter ini diatur ke copy, aliran video yang akan diproses langsung disalin ke file output, dan parameter lain di bawah TranscodeVideo tidak berlaku. copy tidak dapat digunakan untuk penggabungan video dan biasanya digunakan untuk skenario konversi format kontainer.

    • Untuk API GenerateVideoPlaylist: h264 (default), h265.

    h264
    PixelFormat

    string

    Format piksel. Nilai default sama dengan video sumber. Nilai valid:

    • yuv420p

    • yuv422p

    • yuv444p

    • yuv420p10le

    • yuv422p10le

    • yuv444p10le

    • yuva420p

    Catatan

    yuva420p hanya tersedia untuk API CreateMediaConvert, dan parameter Codec harus diatur ke vp9.

    yuv420p
    FrameRateOption

    string

    Opsi laju frame. Nilai valid:

    • fixed: Selalu menggunakan laju frame video target yang ditentukan.

    • adaptive: Menggunakan laju frame video sumber jika lebih rendah dari laju frame video target yang ditentukan.

    • fall: Mengembalikan kegagalan jika laju frame video sumber lebih rendah dari laju frame video target yang ditentukan.

    Nilai default:

    • Untuk API CreateMediaConvert, nilai default adalah fixed.

    • Untuk API GenerateVideoPlaylist, nilai default adalah adaptive.

    Catatan

    Parameter ini harus diatur bersama dengan parameter FrameRate.

    fixed
    FrameRate

    number

    Laju frame video. Nilai default sama dengan video sumber.

    25
    ResolutionOption

    string

    Opsi resolusi. Nilai valid:

    • fixed: Selalu menggunakan resolusi video target yang ditentukan.

    • adaptive: Menggunakan resolusi video sumber jika area resolusi video sumber lebih kecil dari area resolusi video target yang ditentukan.

    • fall: Mengembalikan kegagalan jika area resolusi video sumber lebih kecil dari area resolusi video target yang ditentukan.

    Nilai default:

    • Untuk API CreateMediaConvert, nilai default adalah fixed.

    • Untuk API GenerateVideoPlaylist, nilai default adalah adaptive.

    Catatan

    Parameter ini harus diatur bersama dengan parameter Resolution.

    fixed
    Resolution

    string

    Resolusi video output dalam format WidthxHeight. Nilai default sama dengan resolusi pemutaran video sumber. Anda dapat mengonfigurasi lebar dan tinggi, atau hanya mengonfigurasi lebar atau tinggi. Anda juga dapat menggunakan parameter AdaptiveResolutionDirection untuk mengonfigurasi sisi panjang dan pendek, atau hanya mengonfigurasi sisi panjang atau pendek. Rentang nilai untuk satu sisi adalah (0,4096].

    • Contoh 1: Jika AdaptiveResolutionDirection adalah false, 1280x720 mengatur lebar ke 1280 dan tinggi ke 720. 1280x mengatur lebar ke 1280 dan menjaga tinggi tetap sama dengan video sumber. x720 mengatur tinggi ke 720 dan menjaga lebar tetap sama dengan video sumber.

    • Contoh 2: Jika AdaptiveResolutionDirection adalah true, 1280x720 mengatur sisi panjang ke 1280 dan sisi pendek ke 720. 1280x mengatur sisi panjang ke 1280 dan menjaga sisi pendek tetap sama dengan video sumber. x720 mengatur sisi pendek ke 720 dan menjaga sisi panjang tetap sama dengan video sumber.

    Catatan

    Jika video sumber berisi informasi rotasi, penentuan lebar/tinggi dan sisi panjang/pendek didasarkan pada keadaan pasca-rotasi, yaitu resolusi pemutaran.

    640x480
    AdaptiveResolutionDirection

    boolean

    Apakah akan mengaktifkan mode sisi panjang/pendek adaptif. Nilai valid:

    • true: Diaktifkan. Format parameter Resolution adalah LongSide×ShortSide.

    • false (default): Dinonaktifkan. Format parameter Resolution adalah Width×Height.

    true
    ScaleType

    string

    Mode penskalaan. Nilai valid:

    • stretch (default): Memperbaiki lebar/tinggi atau sisi panjang/pendek dan secara paksa menskalakan video untuk mengisi area kosong dengan peregangan.

    • crop: Menskalakan secara proporsional ke resolusi minimum yang melampaui persegi panjang lebar/tinggi atau sisi panjang/pendek yang ditentukan, lalu memotong area berlebih dari tengah.

    • fill: Menskalakan secara proporsional ke resolusi maksimum dalam persegi panjang lebar/tinggi atau sisi panjang/pendek yang ditentukan, lalu mengisi area kosong di tengah dengan warna hitam.

    • fit: Menskalakan secara proporsional ke resolusi maksimum dalam persegi panjang lebar/tinggi atau sisi panjang/pendek yang ditentukan.

    Catatan

    Parameter ini harus diatur bersama dengan parameter Resolution.

    crop
    Rotation

    integer

    Sudut rotasi searah jarum jam video dalam derajat. Nilai valid:

    • 0 (default)

    • 90

    • 180

    • 270

    90
    BitrateOption

    string

    Opsi bitrate video. Nilai valid:

    • fixed: Selalu menggunakan laju bitrate video target yang ditentukan.

    • adaptive: Menggunakan laju bitrate video sumber jika lebih rendah dari laju bitrate video target yang ditentukan.

    • fall: Mengembalikan kegagalan jika laju bitrate video sumber lebih rendah dari laju bitrate video target yang ditentukan.

    Nilai default:

    • Untuk API CreateMediaConvert, nilai default adalah fixed.

    • Untuk API GenerateVideoPlaylist, nilai default adalah adaptive.

    Catatan

    Parameter ini harus diatur bersama dengan parameter Bitrate.

    fixed
    Bitrate

    integer

    Laju bitrate aliran video, dalam bit per detik (bit/s).

    Catatan

    Parameter ini saling eksklusif dengan CRF. Jika kedua parameter ini dan CRF kosong, encoding dilakukan dengan nilai CRF 23.

    128000
    GOPSize

    integer

    Jumlah frame antar keyframe. Nilai default: 150.

    Catatan

    Parameter ini tidak didukung untuk API GenerateVideoPlaylist.

    60
    CRF

    number

    Menentukan mode kualitas konstan. Parameter ini saling eksklusif dengan Bitrate. Nilai valid: [0,51]. Nilai lebih tinggi menghasilkan kualitas lebih rendah. Nilai yang direkomendasikan: [18,38].

    18
    BufferSize

    integer

    Ukuran buffer decoding untuk variable bitrate, dalam bit per detik (bps).

    Catatan

    Parameter ini hanya berlaku jika digunakan bersama dengan parameter CRF.

    4000000
    MaxBitrate

    integer

    Batas laju bitrate maksimum untuk variable bitrate. Saat menggunakan parameter ini, Anda harus menentukan parameter BufferSize.

    Catatan

    Parameter ini hanya berlaku jika digunakan bersama dengan parameter CRF.

    128000
    BFrames

    integer

    Jumlah B-frame berurutan. Nilai default: 3.

    3
    Refs

    integer

    Jumlah frame referensi. Nilai default: 2.

    2
    VideoSlim

    integer

    Mengaktifkan mode Narrowband HD. Nilai valid:

    0: Nilai default. Dinonaktifkan.

    1: Menggunakan mode Narrowband HD untuk transkoding.

    Catatan

    Untuk hasil optimal, gunakan parameter Bitrate atau CRF yang direkomendasikan secara resmi untuk transkoding video dengan Narrowband HD.

    Penting Narrowband HD hanya mendukung format H.264/H.265, hanya yuv420p, kedalaman 8-bit, dan tidak mendukung output transkoding video multi-target atau penggabungan video. Untuk informasi lebih lanjut, lihat Ikhtisar Narrowband HD.

    0
    FilterVideo

    object

    Parameter filter video. Parameter ini tidak berlaku jika TranscodeVideo kosong atau TranscodeVideo.Codec diatur ke copy.

    Catatan

    Parameter ini tidak didukung untuk API GenerateVideoPlaylist.

    Watermarks

    array

    Daftar watermark video.

    object

    Informasi watermark video.

    Type

    string

    The watermark type. Valid values:

    • text (default): Text watermark.

    • file: Image or animated image watermark.

    text
    Dx

    number

    The meanings differ depending on whether the value is an integer or a decimal:

    • 0 (default): Both the offset in pixels and the ratio of horizontal offset to the output resolution height are 0.

    • Integer: Indicates the offset in pixels (px). Valid values: [1,4096].

    • Decimal: Indicates the ratio of the horizontal offset to the output resolution height. Valid values: (0,1).

    0
    Dy

    number

    The meanings differ depending on whether the value is an integer or a decimal:

    • 0 (default): Both the offset in pixels and the ratio of vertical offset to the output resolution height are 0.

    • Integer: Indicates the offset in pixels (px). Valid values: [1,4096].

    • Decimal: Indicates the ratio of the vertical offset to the output resolution height. Valid values: (0,1).

    0
    StartTime

    number

    The start time for adding the watermark, in seconds (s). Default value: starts from the beginning of the video.

    0
    Duration

    number

    The duration for which the watermark is displayed, in seconds (s). Default value: lasts until the end of the video.

    0
    ReferPos

    string

    The reference position for adding the watermark. Valid values:

    • topleft (default): Top-left corner

    • topright: Top-right corner

    • bottomright: Bottom-right corner

    • bottomleft: Bottom-left corner

    topleft
    Content

    string

    The content of the text watermark. Default value: empty.

    Penting This parameter takes effect when the Type parameter is set to text.

    example
    FontName

    string

    The font name for the text watermark. Valid values:

    • SourceHanSans-Regular (default)

    • SourceHanSans-Bold

    • SourceHanSerif-Regular

    • SourceHanSerif-Bold

    Penting This parameter takes effect when the Type parameter is set to text.

    SourceHanSans-Bold
    FontSize

    integer

    The font size for the text watermark. Default value: 16. The value must be an integer. Valid values: (4,120).

    Penting This parameter takes effect when the Type parameter is set to text.

    18
    FontColor

    string

    The font color for the watermark text. The format is #RRGGBB. Default value: #000000. Values such as "red" and "green" are also supported.

    Penting This parameter takes effect when the Type parameter is set to text.

    red
    FontApha

    number

    The font opacity for the text watermark. Valid values: (0,1]. Default value: 1, indicating fully opaque.

    Penting This parameter takes effect when the Type parameter is set to text.

    0.8
    BorderWidth

    integer

    The stroke width for the text watermark, in pixels (px). The value must be an integer. Valid values: [0,4096]. Default value: 0.

    Penting This parameter takes effect when the Type parameter is set to text.

    2
    BorderColor

    string

    The stroke color for the watermark text. The format is #RRGGBB. Default value: #000000. Values such as "red" and "green" are also supported.

    Penting This parameter takes effect when the Type parameter is set to text.

    red
    URI

    string

    The OSS address of the watermark file. Supported formats are PNG and MOV.

    The OSS address format is oss://<bucket>/<object>, where <bucket> is the name of the OSS Bucket in the same region as the current project, and <object> is the full file path including the file extension.

    Penting This parameter takes effect when the Type parameter is set to file.

    oss://test-bucket/watermark.jpg
    Width

    number

    The width of the watermark image. Default value: the original width of the watermark image. The meanings differ depending on whether the value is an integer or a decimal:

    • Integer: Indicates the pixel value of the watermark width, in pixels (px). Valid values: [1,4096].

    • Decimal: Indicates the ratio relative to the output video resolution width. Valid values: (0,1).

    80
    Height

    number

    The height of the watermark image. Default value: the original height of the watermark image. The meanings differ depending on whether the value is an integer or a decimal:

    • Integer: Indicates the pixel value of the watermark height, in pixels (px). Valid values: [1,4096].

    • Decimal: Indicates the ratio relative to the output video resolution height. Valid values: (0,1).

    40
    Delogos

    array

    Menerapkan pemrosesan mosaik ke area persegi panjang video untuk menghapus logo atau watermark stasiun.

    object

    Parameter pemrosesan mosaik video.

    StartTime

    number

    The start time for adding the mosaic, in seconds (s). Default value: starts from the beginning of the video.

    0
    Duration

    number

    The duration for which the mosaic is applied, in seconds (s). Default value: lasts until the end of the video.

    15
    Dx

    number

    The meanings differ depending on whether the value is an integer or a decimal:

    • 0 (default): Both the offset in pixels and the ratio of horizontal offset to the output resolution height are 0.

    • Integer: Indicates the offset in pixels (px). Valid values: [1,4096].

    • Decimal: Indicates the ratio of the horizontal offset to the output resolution height. Valid values: (0,1).

    0
    Dy

    number

    Default value: 0. The meanings differ depending on whether the value is an integer or a decimal:

    • 0 (default): Both the offset in pixels and the ratio of vertical offset to the output resolution height are 0.

    • Integer: Indicates the offset in pixels (px). Valid values: [1,4096].

    • Decimal: Indicates the ratio of the vertical offset to the output resolution height. Valid values: (0,1).

    0
    Width

    number

    The width of the mosaic. Default value: 1.0 (decimal), which fills the entire output video width. The meanings differ depending on whether the value is an integer or a decimal:

    • Integer: The pixel value, in pixels (px). Valid values: [1,4096].

    • Decimal: Indicates the ratio relative to the output video resolution width. Valid values: (0,1).

    100
    Height

    number

    The height of the mosaic. Default value: 1.0 (decimal), which fills the entire output video height. The meanings differ depending on whether the value is an integer or a decimal:

    • Integer: The pixel value, in pixels (px). Valid values: [1,4096].

    • Decimal: Indicates the ratio relative to the output video resolution height. Valid values: (0,1).

    40
    ReferPos

    string

    The reference position for adding the mosaic. Valid values:

    • topleft (default): Top-left corner

    • topright: Top-right corner

    • bottomright: Bottom-right corner

    • bottomleft: Bottom-left corner

    topleft
    Speed

    number

    Pengaturan kecepatan pemutaran video. Nilai valid: [0.5,1.0]. Nilai default: 1.0.

    Catatan

    • Ini adalah rasio kecepatan pemutaran file media yang ditranskode terhadap kecepatan pemutaran default file media sumber, bukan transkoding percepatan.

    Penting

    • Parameter ini hanya berlaku untuk API CreateMediaConvertTask.

    1.0
    Desensitization

    object

    Konfigurasi desensitisasi video.

    Penting

    • Parameter ini hanya berlaku untuk API CreateMediaConvertTask.

    Face

    object

    Face desensitization configuration.

    Catatan

    In public preview. If you have any questions, please join the DingTalk group to provide feedback. For the DingTalk group number, see Contact Us.

    Confidence

    number

    The face confidence threshold, used to set the lower limit of confidence for face detection. If the confidence value of a detected face is lower than this threshold, the face will not be desensitized.

    • Valid values: 0.0 to 1.0.

    • Default value: 0.0 (indicates no confidence filtering).

    0.4
    MinSize

    integer

    The minimum face size threshold, used to set the minimum size of faces to be desensitized. If the width or height of a detected face is smaller than this threshold, the face will not be desensitized. Unit: pixels. Default value: 0, indicating no restriction on face size.

    0.4
    ScaleRatio

    number

    BlurRadius

    integer

    Transparency

    number

    LicensePlate

    object

    License plate desensitization configuration.

    Catatan

    In public preview. If you have any questions, please join the DingTalk group to provide feedback. For the DingTalk group number, see Contact Us.

    Confidence

    number

    The license plate confidence threshold, used to set the lower limit of confidence for license plate detection. If the confidence value of a detected license plate is lower than this threshold, the license plate will not be desensitized.

    • Valid values: 0.0 to 1.0.

    • Default value: 0.0 (indicates no confidence filtering).

    0.4
    MinSize

    integer

    The minimum license plate size threshold, used to set the minimum size of license plates to be desensitized. If the width or height of a detected license plate is smaller than this threshold, the license plate will not be desensitized. Unit: pixels. Default value: 0, indicating no restriction on license plate size.

    0.4
    ScaleRatio

    number

    BlurRadius

    integer

    Transparency

    number