All Products
Search

This Product

    Intelligent Media Management:TargetVideo

    Document Center

    Intelligent Media Management:TargetVideo

    Last Updated:Mar 24, 2026

    Parameter

    Type

    Description

    Example

    object

    Menentukan parameter untuk pemrosesan video.

    DisableVideo

    boolean

    Menentukan apakah akan menonaktifkan pembuatan aliran video. Nilai yang valid:

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

    • false (Default): Mengaktifkan aliran video.

    false
    Stream

    array

    Daftar indeks aliran video dari file sumber yang akan diproses. Jika dibiarkan kosong (nilai default), layanan akan memproses aliran video dengan indeks terkecil (aliran video pertama). Indeks lebih besar dari 100 menunjukkan bahwa semua aliran video diproses.

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

    Catatan

    Layanan mengabaikan indeks yang tidak sesuai dengan aliran video yang ada.

    integer

    Indeks aliran video yang akan diproses.

    0
    TranscodeVideo

    object

    Menentukan parameter transkoding video. Jika parameter ini dibiarkan kosong, pemrosesan video dinonaktifkan, dan file output tidak berisi aliran video.

    Catatan

    Menonaktifkan pemrosesan video dengan membiarkan parameter ini kosong tidak disarankan. Gunakan parameter DisableVideo sebagai gantinya.

    Codec

    string

    Kodek video. Nilai yang valid:

    • Untuk panggilan API CreateMediaConvert: copy (default), h264, h265, dan vp9.
      Peringatan Saat parameter ini diatur ke copy, aliran video yang dipilih langsung disalin ke file output tanpa re-encoding. Dalam kasus ini, parameter lain di bawah TranscodeVideo diabaikan. Nilai copy tidak dapat digunakan untuk penyambungan video dan biasanya digunakan untuk remuxing.

    • Untuk panggilan API GenerateVideoPlaylist: h264 (default) dan h265.

    h264
    PixelFormat

    string

    Format piksel. Default mengikuti format piksel video sumber. Nilai yang valid:

    • yuv420p

    • yuv422p

    • yuv444p

    • yuv420p10le

    • yuv422p10le

    • yuv444p10le

    • yuva420p

    Catatan

    Nilai yuva420p hanya tersedia untuk panggilan API CreateMediaConvert dan memerlukan parameter Codec bernilai vp9.

    yuv420p
    FrameRateOption

    string

    Opsi laju frame. Nilai yang valid:

    • fixed: Selalu menggunakan laju frame target yang ditentukan.

    • adaptive: Menggunakan laju frame sumber jika nilainya lebih rendah daripada laju frame target.

    • fall: Pekerjaan gagal jika laju frame sumber lebih rendah daripada laju frame target.

    Nilai default:

    • Untuk panggilan API CreateMediaConvert, nilai default adalah fixed.

    • Untuk panggilan API GenerateVideoPlaylist, nilai default adalah adaptive.

    Catatan

    Parameter ini harus diatur bersamaan dengan parameter FrameRate.

    fixed
    FrameRate

    number

    Laju frame video. Secara default, menggunakan laju frame video sumber.

    25
    ResolutionOption

    string

    Opsi resolusi. Nilai yang valid:

    • fixed: Selalu menggunakan resolusi target yang ditentukan.

    • adaptive: Menggunakan resolusi sumber jika luas area-nya lebih kecil daripada luas area resolusi target.

    • fall: Pekerjaan gagal jika luas area resolusi sumber lebih kecil daripada luas area resolusi target.

    Nilai default:

    • Untuk panggilan API CreateMediaConvert, nilai default adalah fixed.

    • Untuk panggilan API GenerateVideoPlaylist, nilai default adalah adaptive.

    Catatan

    Parameter ini harus diatur bersamaan dengan parameter Resolution.

    fixed
    Resolution

    string

    Resolusi video output dalam format widthxheight. Secara default, mengikuti resolusi pemutaran video sumber. Anda dapat menentukan lebar, tinggi, atau keduanya. Anda juga dapat mengonfigurasi sisi panjang dan pendek dengan menggunakan parameter AdaptiveResolutionDirection. Nilai untuk satu sisi harus berada dalam rentang (0, 4096].

    • Contoh 1: Jika AdaptiveResolutionDirection bernilai false, 1280x720 mengatur lebar menjadi 1280 dan tinggi menjadi 720; 1280x mengatur lebar menjadi 1280 dan mempertahankan tinggi sumber; x720 mengatur tinggi menjadi 720 dan mempertahankan lebar sumber.

    • Contoh 2: Jika AdaptiveResolutionDirection bernilai true, 1280x720 mengatur sisi panjang menjadi 1280 dan sisi pendek menjadi 720; 1280x mengatur sisi panjang menjadi 1280 dan mempertahankan sisi pendek sumber; x720 mengatur sisi pendek menjadi 720 dan mempertahankan sisi panjang sumber.

    Catatan

    Jika video sumber berisi metadata rotasi, sistem menentukan lebar, tinggi, serta sisi panjang dan pendek berdasarkan video yang telah diputar, yang sesuai dengan resolusi pemutaran-nya.

    640x480
    AdaptiveResolutionDirection

    boolean

    Menentukan apakah akan mengaktifkan pengubahan ukuran adaptif untuk sisi panjang dan pendek. Nilai yang valid:

    • true (Default): Diaktifkan. Parameter Resolution diinterpretasikan sebagai long_sidexshort_side.

    • false: Dinonaktifkan. Parameter Resolution diinterpretasikan sebagai widthxheight.

    true
    ScaleType

    string

    Mode penskalaan. Nilai yang valid:

    • stretch (Default): Meregangkan video agar sesuai dengan dimensi yang ditentukan, yang dapat mengubah rasio aspek.

    • crop: Menskalakan video secara proporsional hingga setidaknya sebesar dimensi yang ditentukan, lalu menerapkan potong tengah.

    • fill: Menskalakan video secara proporsional agar muat dalam dimensi yang ditentukan, lalu menambahkan bilah hitam (center fill).

    • fit: Menskalakan video secara proporsional agar muat dalam dimensi yang ditentukan tanpa pemotongan atau pengisian.

    Catatan

    Parameter ini harus diatur bersamaan dengan parameter Resolution.

    crop
    Rotation

    integer

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

    • 0 (Default)

    • 90

    • 180

    • 270

    90
    BitrateOption

    string

    Opsi bitrate video. Nilai yang valid:

    • fixed: Selalu menggunakan bitrate video target yang ditentukan.

    • adaptive: Menggunakan bitrate video sumber jika nilainya lebih rendah daripada bitrate video target.

    • fall: Pekerjaan gagal jika bitrate video sumber lebih rendah daripada bitrate video target.

    Nilai default:

    • Untuk panggilan API CreateMediaConvert, nilai default adalah fixed.

    • Untuk panggilan API GenerateVideoPlaylist, nilai default adalah adaptive.

    Catatan

    Parameter ini harus diatur bersamaan dengan parameter Bitrate.

    fixed
    Bitrate

    integer

    Bitrate video, dalam bit per detik (bps).

    Catatan

    Parameter ini saling eksklusif dengan CRF. Jika kedua parameter ini dan parameter CRF dihilangkan, sistem akan meng-encode video dengan nilai CRF default 23.

    128000
    GOPSize

    integer

    Interval keyframe, dalam jumlah frame. Default: 150.

    Catatan

    Parameter ini tidak didukung untuk panggilan API GenerateVideoPlaylist.

    60
    CRF

    number

    Menentukan Constant Rate Factor (CRF). Parameter ini saling eksklusif dengan Bitrate. Rentang nilai yang valid adalah [0, 51]. Nilai yang lebih tinggi menghasilkan kualitas yang lebih rendah. Rentang yang direkomendasikan adalah [18, 38].

    18
    BufferSize

    integer

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

    Catatan

    Parameter ini hanya berlaku saat digunakan bersama parameter CRF.

    4000000
    MaxBitrate

    integer

    Menetapkan bitrate maksimum untuk encoding bitrate variabel. Parameter ini memerlukan parameter BufferSize.

    Catatan

    Parameter ini hanya berlaku saat digunakan bersama parameter CRF.

    128000
    BFrames

    integer

    Jumlah B-frame berturut-turut. Default: 3.

    3
    Refs

    integer

    Jumlah reference frame. Default: 2.

    2
    VideoSlim

    integer

    Menentukan apakah akan mengaktifkan mode Video Slim. Nilai yang valid:

    0: (Default) Dinonaktifkan.

    1: Diaktifkan. Melakukan transkoding video menggunakan mode Video Slim.

    Catatan

    Untuk hasil optimal, gunakan parameter Bitrate atau CRF yang direkomendasikan saat melakukan transkoding dengan Video Slim.

    Penting Video Slim hanya mendukung kodek H.264 dan H.265, format piksel yuv420p, dan kedalaman 8-bit. Fitur ini tidak mendukung transkoding ke beberapa output video target atau penyambungan video. Untuk informasi selengkapnya, lihat Video Slim.

    0
    FilterVideo

    object

    Menentukan parameter filter video. Sistem mengabaikan parameter ini jika TranscodeVideo kosong atau jika TranscodeVideo.Codec bernilai copy.

    Catatan

    Parameter ini tidak didukung untuk panggilan API GenerateVideoPlaylist.

    Watermarks

    array

    Daftar watermark video yang akan diterapkan.

    object

    Konfigurasi untuk watermark video.

    Type

    string

    Jenis watermark. Nilai yang valid:

    • text (Default): Watermark teks.

    • file: Watermark gambar atau animasi.

    text
    Dx

    number

    Offset horizontal. Interpretasi nilai tergantung pada jenisnya:

    • 0 (Default): Tidak ada offset.

    • Bilangan bulat: Offset dalam piksel (px). Rentang valid: [1, 4096].

    • Desimal: Offset sebagai rasio terhadap lebar video output. Rentang valid: (0, 1).

    0
    Dy

    number

    Offset vertikal. Interpretasi nilai tergantung pada jenisnya:

    • 0 (Default): Tidak ada offset.

    • Bilangan bulat: Offset dalam piksel (px). Rentang valid: [1, 4096].

    • Desimal: Offset sebagai rasio terhadap tinggi video output. Rentang valid: (0, 1).

    0
    StartTime

    number

    Waktu, dalam detik (s), ketika watermark pertama kali muncul. Secara default, muncul di awal video.

    0
    Duration

    number

    Durasi, dalam detik (s), untuk menampilkan watermark. Secara default, tetap terlihat hingga akhir video.

    0
    ReferPos

    string

    Posisi referensi untuk watermark. Nilai yang valid:

    • topleft (Default): Sudut kiri atas.

    • topright: Sudut kanan atas.

    • bottomright: Sudut kanan bawah.

    • bottomleft: Sudut kiri bawah.

    topleft
    Content

    string

    Konten watermark teks. Default: kosong.

    Penting Parameter ini hanya berlaku saat Type bernilai text.

    example
    FontName

    string

    Nama font untuk watermark teks. Nilai yang valid:

    • SourceHanSans-Regular (Default)

    • SourceHanSans-Bold

    • SourceHanSerif-Regular

    • SourceHanSerif-Bold

    Penting Parameter ini hanya berlaku saat Type bernilai text.

    SourceHanSans-Bold
    FontSize

    integer

    Ukuran font untuk watermark teks. Nilai harus berupa bilangan bulat dalam rentang (4, 120). Default: 16.

    Penting Parameter ini hanya berlaku saat Type bernilai text.

    18
    FontColor

    string

    Warna font watermark teks. Nilai dapat dalam format #RRGGBB atau nama warna seperti red atau green. Default: #000000.

    Penting Parameter ini hanya berlaku saat Type bernilai text.

    red
    FontApha

    number

    Alpha font (transparansi) untuk watermark teks. Nilai harus dalam rentang (0, 1]. Nilai 1 (default) berarti teks sepenuhnya buram.

    Penting Parameter ini hanya berlaku saat Type bernilai text.

    0.8
    BorderWidth

    integer

    Lebar garis tepi untuk watermark teks, dalam piksel (px). Nilai harus berupa bilangan bulat dalam rentang [0, 4096]. Default: 0.

    Penting Parameter ini hanya berlaku saat Type bernilai text.

    2
    BorderColor

    string

    Warna garis tepi watermark teks. Nilai dapat dalam format #RRGGBB atau nama warna seperti red atau green. Default: #000000.

    Penting Parameter ini hanya berlaku saat Type bernilai text.

    red
    URI

    string

    URI OSS dari file watermark. Format yang didukung adalah PNG dan MOV.

    URI OSS harus mengikuti format oss://<bucket>/<object>, di mana <bucket> adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini, dan <object> adalah path lengkap file, termasuk ekstensinya.

    Penting Parameter ini hanya berlaku saat Type bernilai file.

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

    number

    Lebar gambar watermark. Secara default, menggunakan lebar asli gambar watermark. Interpretasi nilai tergantung pada jenisnya:

    • Bilangan bulat: Lebar dalam piksel (px). Rentang valid: [1, 4096].

    • Desimal: Lebar sebagai rasio terhadap lebar video output. Rentang valid: (0, 1).

    80
    Height

    number

    Tinggi gambar watermark. Secara default, menggunakan tinggi asli gambar watermark. Interpretasi nilai tergantung pada jenisnya:

    • Bilangan bulat: Tinggi dalam piksel (px). Rentang valid: [1, 4096].

    • Desimal: Tinggi sebagai rasio terhadap tinggi video output. Rentang valid: (0, 1).

    40
    Delogos

    array

    Menerapkan efek buram pada area persegi panjang video, biasanya untuk menghapus logo atau grafis di layar.

    object

    Parameter untuk efek buram video.

    StartTime

    number

    Waktu mulai penerapan efek buram, dalam detik (s). Secara default, efek diterapkan sejak awal video.

    0
    Duration

    number

    Durasi penerapan efek buram, dalam detik (s). Secara default, efek berlangsung hingga akhir video.

    15
    Dx

    number

    Offset horizontal. Interpretasi nilai tergantung pada jenisnya:

    • 0 (Default): Tidak ada offset.

    • Bilangan bulat: Offset dalam piksel (px). Rentang valid: [1, 4096].

    • Desimal: Offset sebagai rasio terhadap lebar video output. Rentang valid: (0, 1).

    0
    Dy

    number

    Offset vertikal. Interpretasi nilai tergantung pada jenisnya:

    • 0 (Default): Tidak ada offset.

    • Bilangan bulat: Offset dalam piksel (px). Rentang valid: [1, 4096].

    • Desimal: Offset sebagai rasio terhadap tinggi video output. Rentang valid: (0, 1).

    0
    Width

    number

    Lebar area buram. Secara default, nilainya 1.0 (desimal), yang mencakup seluruh lebar video output. Interpretasi nilai tergantung pada jenisnya:

    • Bilangan bulat: Lebar dalam piksel (px). Rentang valid: [1, 4096].

    • Desimal: Lebar sebagai rasio terhadap lebar video output. Rentang valid: (0, 1).

    100
    Height

    number

    Tinggi area buram. Secara default, nilainya 1.0 (desimal), yang mencakup seluruh tinggi video output. Interpretasi nilai tergantung pada jenisnya:

    • Bilangan bulat: Tinggi dalam piksel (px). Rentang valid: [1, 4096].

    • Desimal: Tinggi sebagai rasio terhadap tinggi video output. Rentang valid: (0, 1).

    40
    ReferPos

    string

    Posisi referensi untuk area buram. Nilai yang valid:

    • topleft (Default): Sudut kiri atas.

    • topright: Sudut kanan atas.

    • bottomright: Sudut kanan bawah.

    • bottomleft: Sudut kiri bawah.

    topleft
    Speed

    number

    Pengali kecepatan pemutaran video. Rentang nilai yang valid adalah [0.5, 1.0]. Default: 1.0.

    Catatan

    • Parameter ini menetapkan rasio kecepatan pemutaran file hasil transkoding terhadap file sumber. Parameter ini tidak melakukan transkoding kecepatan.

    Penting

    • Parameter ini hanya berlaku untuk panggilan API CreateMediaConvertTask.

    1.0
    Desensitization

    object

    Menentukan pengaturan desensitisasi video.

    Penting

    • Parameter ini hanya berlaku untuk panggilan API CreateMediaConvertTask.

    Face

    object

    Menentukan pengaturan desensitisasi wajah.

    Catatan

    Fitur ini sedang dalam tahap beta publik. Jika Anda memiliki pertanyaan, bergabunglah dengan grup DingTalk kami untuk memberikan masukan. Untuk nomor grup, lihat Hubungi kami.

    Confidence

    number

    Ambang batas confidence untuk deteksi wajah. Sistem tidak melakukan desensitisasi terhadap wajah dengan skor confidence di bawah ambang batas ini.

    • Rentang valid: 0.0 hingga 1.0.

    • Default: 0.0 (tanpa filter confidence).

    0.4
    MinSize

    integer

    Ambang batas ukuran wajah minimum. Sistem tidak melakukan desensitisasi terhadap wajah dengan lebar atau tinggi lebih kecil dari ambang batas ini. Satuan: piksel. Default: 0, yang berarti tidak ada batasan ukuran.

    0.4
    LicensePlate

    object

    Menentukan pengaturan desensitisasi plat nomor.

    Catatan

    Fitur ini sedang dalam tahap beta publik. Jika Anda memiliki pertanyaan, bergabunglah dengan grup DingTalk kami untuk memberikan masukan. Untuk nomor grup, lihat Hubungi kami.

    Confidence

    number

    Ambang batas confidence untuk deteksi plat nomor. Sistem tidak melakukan desensitisasi terhadap plat nomor dengan skor confidence di bawah ambang batas ini.

    • Rentang valid: 0.0 hingga 1.0.

    • Default: 0.0 (tanpa filter confidence).

    0.4
    MinSize

    integer

    Ambang batas ukuran plat nomor minimum. Sistem tidak melakukan desensitisasi terhadap plat nomor dengan lebar atau tinggi lebih kecil dari ambang batas ini. Satuan: piksel. Default: 0, yang berarti tidak ada batasan ukuran.

    0.4