All Products
Search
Document Center

Intelligent Media Services:Konfigurasi efek

Last Updated:Aug 25, 2026

Efek mendefinisikan transformasi yang diterapkan pada klip dalam timeline. Setiap jenis efek menyediakan serangkaian parameter berbeda untuk mengontrol perilaku, posisi, waktu, dan tampilannya.

Ikhtisar jenis efek

Tabel berikut mencantumkan semua jenis efek yang tersedia beserta fungsi utamanya.

Jenis efek

Deskripsi

Text

Menambahkan teks banner (subtitle) ke video output.

DeWatermark

Menghapus watermark dengan mengaburkan area tertentu.

Crop

Memotong klip ke wilayah persegi panjang tertentu.

Scale

Menyesuaikan ukuran klip ke ukuran tertentu.

Pad

Menambahkan padding di sekitar gambar klip.

Background

Mengonfigurasi blur latar belakang atau warna saat ukuran klip dan ukuran output tidak cocok.

Transition

Menambahkan transisi antara dua klip berdekatan.

DLTransition

Menambahkan transisi berbasis interpolasi frame yang mempertahankan durasi output.

VFX

Menerapkan efek visual, termasuk efek mask.

Filter

Menerapkan filter warna dan color grading.

Volume

Menyesuaikan gain volume klip.

AFade

Menambahkan fade in atau fade out audio.

AI_ASR

Menghasilkan subtitle dari audio menggunakan pengenalan ucapan.

Rotate

Memutar klip sebesar 90°, 180°, atau 270°.

AI_Matting

Mengekstraksi subjek dari latar belakang hijau atau biru.

AI_RealMatting

Mengekstraksi figur manusia dari adegan live-action.

AI_Delogo

Menghapus logo stasiun secara cerdas dari video.

Clip

Memotong segmen waktu secara acak dari klip asli.

Flip

Membalik video atau gambar secara horizontal atau vertikal.

KenBurns

Menerapkan efek panning dan zooming ala Ken Burns.

ADenoise

Mengurangi noise audio.

Zoom

Menambahkan efek zoom ke klip.

Harmonization

Menyesuaikan klip video manusia digital dengan pencahayaan dan warna latar belakang.

ALoudNorm

Menormalisasi kenyaringan audio.

AEqualize

Menerapkan equalisasi kenyaringan global.

FreezeFrame

Membekukan frame terakhir klip video.

Efek teks dan subtitle

Jenis efek: Text (teks banner)

Contoh timeline: Subtitle dan templat subtitle

Posisi dan waktu

Nama

Tipe

Wajib

Deskripsi

X

Float

Tidak

Jarak horizontal antara pojok kiri atas teks banner dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥2 menentukan piksel absolut. Nilai default: 0. Koordinat ini diskalakan berdasarkan ukuran klip dan ukuran video output.

Y

Float

Tidak

Jarak vertikal antara pojok kiri atas teks banner dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥2 menentukan piksel absolut. Nilai default: 0. Koordinat ini diskalakan berdasarkan ukuran klip dan ukuran video output.

FixedX

Float

Tidak

Jarak horizontal antara pojok kiri atas teks banner dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥2 menentukan piksel absolut. Nilai default: 0. Koordinat ini tidak diskalakan berdasarkan ukuran klip dan ukuran video output.

FixedY

Float

Tidak

Jarak vertikal antara pojok kiri atas teks banner dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥2 menentukan piksel absolut. Nilai default: 0. Koordinat ini tidak diskalakan berdasarkan ukuran klip dan ukuran video output.

TimelineIn

Float

Tidak

Posisi awal teks banner pada timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika parameter ini dikosongkan, nilainya sama dengan nilai TimelineIn klip terkait.

TimelineOut

Float

Tidak

Posisi akhir teks banner pada timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika parameter ini dikosongkan, nilainya sama dengan nilai TimelineOut klip terkait.

Konten teks dan font

Nama

Tipe

Wajib

Deskripsi

Content

String

Ya

Konten teks banner.

Font

String

Tidak

Font teks banner. Untuk daftar font yang didukung, lihat Daftar font. Nilai default: SimSun.

FontSize

Int

Ya

Ukuran font teks banner. Ukuran font ini diskalakan berdasarkan ukuran klip dan ukuran video output. Nilai default: 0. Nilai maksimum: 5000. Tentukan hanya salah satu dari FontSize dan FixedFontSize. Jika keduanya ditentukan, hanya FontSize yang berlaku.

FixedFontSize

Int

Ya

Ukuran font teks banner. Ukuran font ini tidak diskalakan berdasarkan ukuran klip dan ukuran video output. Tentukan hanya salah satu dari FontSize dan FixedFontSize. Jika keduanya ditentukan, hanya FontSize yang berlaku.

SizeRequestType

String

Tidak

Metode yang digunakan untuk menghitung ukuran teks hasil rendering aktual dari ukuran font. Nilai default: RealDim. Nilai valid: Nominal: tinggi subtitle hasil rendering dalam piksel sama dengan nilai FontSize. RealDim: untuk beberapa font, tinggi subtitle hasil rendering dalam piksel mungkin lebih kecil daripada nilai FontSize.

FontUrl

String

Tidak

Jalur ke file font kustom di Bucket OSS Anda. Format TTF, OTF, dan WOFF didukung. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf

Tampilan teks

Nama

Tipe

Wajib

Deskripsi

FontColor

String

Tidak

Warna teks banner, dalam format tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff.

FontColorOpacity

String

Tidak

Opasitas teks banner. Nilai valid: 0 hingga 1. Nilai 1 menunjukkan tidak transparan. Nilai 0 menunjukkan sepenuhnya transparan. Nilai default: 1.

FontFace

FontFace

Tidak

Tampilan font teks banner.

Spacing

Integer

Tidak

Jarak karakter teks banner. Satuan: piksel. Nilai default: 0.

LineSpacing

Integer

Tidak

Jarak baris teks banner. Satuan: piksel. Nilai default: 0.

Angle

Float

Tidak

Sudut rotasi berlawanan arah jarum jam teks banner. Satuan: derajat. Nilai default: 0.

BorderStyle

Int

Tidak

Gaya border dan bayangan teks banner. Nilai valid: 1 (border dan bayangan) dan 3 (kotak latar belakang tidak transparan). Nilai default: 1.

Outline

Int

Tidak

Lebar outline teks banner. Satuan: piksel. Nilai default: 0.

OutlineColour

String

Tidak

Warna outline teks banner, dalam format tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff.

Shadow

Int

Tidak

Kedalaman bayangan yang dilemparkan oleh teks banner. Satuan: piksel. Nilai default: 0.

BackColour

String

Tidak

Warna bayangan teks banner, dalam format tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff.

Penyelarasan dan adaptasi

Nama

Tipe

Wajib

Deskripsi

Alignment

String

Tidak

Mode posisi dan penyelarasan teks banner. Nilai default: TopLeft. Parameter ini memiliki dua aspek: Anchor posisi — menentukan lokasi teks pada video. Nilai valid: TopLeft (pojok kiri atas), TopCenter (bagian atas garis tengah vertikal), TopRight (pojok kanan atas), CenterLeft (bagian kiri garis tengah horizontal), CenterCenter (pusat video), CenterRight (bagian kanan garis tengah horizontal), BottomLeft (pojok kiri bawah), BottomCenter (bagian bawah garis tengah vertikal), BottomRight (pojok kanan bawah). Mode penyelarasan teks — menentukan bagaimana koordinat X dan Y dipetakan ke teks subtitle. Untuk posisi presisi, gunakan salah satu mode berikut: Left (rata kiri; X dan Y menentukan koordinat vertex kiri atas subtitle relatif terhadap pojok kiri atas video), Center (rata tengah; X dan Y menentukan koordinat titik perpotongan pada batas atas garis tengah subtitle relatif terhadap pojok kiri atas video), Right (rata kanan; X dan Y menentukan koordinat vertex kanan atas subtitle relatif terhadap pojok kiri atas video).

AdaptMode

String

Tidak

Menentukan apakah teks banner secara otomatis membungkus atau diskalakan saat melebihi lebar video atau nilai TextWidth yang ditentukan. Nilai valid: AutoWrap (pembungkusan baris otomatis), AutoScale (penskalaan otomatis), AutoWrapAtSpaces (pembungkusan baris otomatis hanya pada spasi, berlaku untuk subtitle bahasa Inggris saja).

TextWidth

String

Tidak

Lebar kotak teks subtitle. Parameter ini berlaku saat AdaptMode ditentukan. Pembungkusan baris atau penskalaan dilakukan berdasarkan lebar kotak teks ini. Jika parameter ini dikosongkan, pembungkusan baris atau penskalaan dilakukan berdasarkan lebar video. Nilai >0 dan ≤1 menentukan lebar relatif terhadap video output. Nilai >1 menentukan piksel absolut.

EnableLocalStyleAutoScale

Boolean

Tidak

Menentukan apakah ukuran font, ukuran outline, dan ukuran bayangan gaya subtitle lokal diskalakan berdasarkan ukuran video output dan ukuran FECanvas. Nilai default: false.

SupportBidi

Boolean

Tidak

Menentukan apakah rendering teks dua arah diaktifkan. Aktifkan fitur ini saat teks subtitle berisi teks kiri-ke-kanan (LTR) seperti bahasa Inggris, angka, dan huruf Latin, serta teks kanan-ke-kiri (RTL). Nilai default: false.

Animasi dan efek

Nama

Tipe

Wajib

Deskripsi

EffectColorStyle

String

Tidak

Jenis gaya teks artistik teks banner. Untuk informasi selengkapnya, lihat Word art.

TextureURL

String

Tidak

Efek tekstur subtitle. Format PNG, JPG, JPEG, dan BMP didukung. Hanya file OSS yang didukung. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png

AaiMotionInEffect

String

Tidak

Jenis efek masuk teks banner. Untuk informasi selengkapnya, lihat Contoh efek subtitle.

AaiMotionIn

Float

Tidak

Durasi efek masuk. Satuan: detik, akurat hingga empat tempat desimal. Nilai default: 0.5. Jika durasi teks kurang dari 0.5, nilainya adalah durasi total dikurangi durasi efek keluar.

AaiMotionOutEffect

String

Tidak

Jenis efek keluar teks banner. Untuk informasi selengkapnya, lihat Contoh efek subtitle.

AaiMotionOut

Float

Tidak

Durasi efek keluar. Satuan: detik, akurat hingga empat tempat desimal. Nilai default: 0.5. Jika durasi teks kurang dari 0.5, nilainya adalah durasi teks total.

AaiMotionLoopEffect

String

Tidak

Jenis efek loop teks banner. Parameter ini tidak dapat berlaku bersamaan dengan efek masuk atau keluar subtitle. Untuk informasi selengkapnya, lihat Contoh efek subtitle.

Ratio

Float

Tidak

Kecepatan pemutaran efek loop, akurat hingga empat tempat desimal. Nilai default: 1. Nilai >1 menunjukkan loop dipercepat. Nilai <1 menunjukkan loop diperlambat.

SubtitleEffects

SubtitleEffect[]

Tidak

Efek multi-lapis teks banner. Outline multi-lapis, bayangan multi-lapis, blur Gaussian (hanya didukung saat tipe adalah bayangan), dan efek latar belakang subtitle didukung. Jika Anda menentukan SubtitleEffects, bidang Outline dan Shadow pada track subtitle tidak lagi berlaku. Saat mengonfigurasi efek outline, bayangan, atau latar belakang multi-lapis, urutan array SubtitleEffects menentukan urutan lapisan. SubtitleEffect pertama dalam array dirender pada lapisan paling bawah, dan SubtitleEffect terakhir dalam array dirender pada lapisan paling atas.

Teks gelembung

Nama

Tipe

Wajib

Deskripsi

BubbleStyleId

String

Tidak

Jenis gaya teks gelembung. Untuk jenis dan efek gelembung, lihat Contoh efek teks gelembung.

BubbleWidth

Float

Tidak

Lebar gambar latar belakang gelembung relatif terhadap video output. Parameter ini hanya berlaku saat menggunakan teks gelembung. Nilai >1 menentukan piksel absolut. Nilai ≤1 menentukan nilai relatif.

BubbleHeight

Float

Tidak

Tinggi gambar latar belakang gelembung relatif terhadap video output. Parameter ini hanya berlaku saat menggunakan teks gelembung. Nilai >1 menentukan piksel absolut. Nilai ≤1 menentukan nilai relatif.

Jenis efek: AI_ASR (ucapan ke teks)

Menghasilkan subtitle berdasarkan audio. Anda dapat menempatkan efek ini dalam array Effects pada track video atau track audio. Parameternya sama dengan yang tercantum di . Secara default, subtitle diposisikan di tengah bawah video.

Catatan

Efek ini hanya dapat dipanggil di Wilayah Beijing, Shanghai, dan Hangzhou.

Contoh timeline: Gunakan AI_ASR untuk mengonversi ucapan ke teks dan menggabungkan keterangan ke dalam video

Nama

Tipe

Wajib

Deskripsi

X

Float

Tidak

Jarak horizontal antara pojok kiri atas teks banner dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥2 menentukan piksel absolut.

Y

Float

Tidak

Jarak vertikal antara pojok kiri atas teks banner dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥2 menentukan piksel absolut.

Font

String

Tidak

Font teks banner. Untuk daftar font yang didukung, lihat Daftar font. Nilai default: SimSun.

FontSize

Int

Ya

Ukuran font teks banner.

FontColor

String

Tidak

Warna teks banner, dalam format tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff.

FontColorOpacity

String

Tidak

Opasitas teks banner. Nilai valid: 0 hingga 1. Nilai 1 menunjukkan tidak transparan. Nilai 0 menunjukkan sepenuhnya transparan. Nilai default: 1.

FontFace

FontFace

Tidak

Tampilan font teks banner.

NeedHighlighting

Boolean

Tidak

Menentukan apakah penyorotan otomatis untuk subtitle ASR diaktifkan.

HighlightingStyle

Style

Tidak

Gaya subtitle yang disorot.

AlignmentText

String

Tidak

Teks waktu subtitle. Setelah Anda menentukan parameter ini, hasil pengenalan ASR disejajarkan dengan teks yang diberikan, dan kalimat secara otomatis dibagi serta diisi ke posisi waktu yang sesuai.

Efek video

Jenis efek: DeWatermark (penghapusan watermark)

Nama

Tipe

Wajib

Deskripsi

X

Float

Tidak

Jarak horizontal antara pojok kiri atas area yang dikaburkan dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥2 menentukan piksel absolut. Nilai default: 0.

Y

Float

Tidak

Jarak vertikal antara pojok kiri atas area yang dikaburkan dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥2 menentukan piksel absolut. Nilai default: 0.

Width

Float

Ya

Lebar area yang dikaburkan dalam video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥2 menentukan piksel absolut.

Height

Float

Ya

Tinggi area yang dikaburkan dalam video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥2 menentukan piksel absolut.

Jenis efek: Crop

Contoh timeline: Potong video

Nama

Tipe

Wajib

Deskripsi

X

Float

Tidak

Jarak horizontal antara pojok kiri atas area yang dipertahankan setelah pemotongan dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥2 menentukan piksel absolut. Nilai default: 0.

Y

Float

Tidak

Jarak vertikal antara pojok kiri atas area yang dipertahankan setelah pemotongan dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥2 menentukan piksel absolut. Nilai default: 0.

Width

Float

Ya

Lebar area yang dipertahankan setelah pemotongan dalam video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥2 menentukan piksel absolut.

Height

Float

Ya

Tinggi area yang dipertahankan setelah pemotongan dalam video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥2 menentukan piksel absolut.

Jenis efek: Scale

Catatan

Jika efek Scale tidak ditentukan dan lebar serta tinggi gambar klip tidak sesuai dengan video output, gambar klip akan diskalakan secara otomatis hingga lebar atau tingginya sesuai dengan gambar output. Bilah hitam akan ditambahkan secara otomatis di bagian atas dan bawah atau kiri dan kanan, serta gambar klip diposisikan di tengah.

Contoh timeline: Mode penskalaan

Nama

Tipe

Wajib

Deskripsi

Width

Float

Ya

Lebar area yang dipertahankan setelah penskalaan dalam video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥1 menentukan piksel absolut.

Height

Float

Ya

Tinggi area yang dipertahankan setelah penskalaan dalam video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥1 menentukan piksel absolut.

Jenis efek: Pad (padding)

Catatan

Jika efek Pad tidak ditentukan dan rasio aspek gambar klip tidak sesuai dengan video output, gambar klip akan diskalakan secara otomatis hingga lebar atau tingginya sesuai dengan gambar output. Bilah hitam akan ditambahkan secara otomatis di bagian atas dan bawah atau kiri dan kanan, serta gambar klip diposisikan di tengah.

Contoh timeline: Konversi video landscape ke portrait dan tambahkan area kabur

Nama

Tipe

Wajib

Deskripsi

Left

Float

Tidak

Jarak antara tepi kiri gambar klip dan tepi kiri video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥1 menentukan piksel absolut.

Right

Float

Tidak

Jarak antara tepi kanan gambar klip dan tepi kanan video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥1 menentukan piksel absolut.

Top

Float

Tidak

Jarak antara tepi atas gambar klip dan tepi atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥1 menentukan piksel absolut.

Bottom

Float

Tidak

Jarak antara tepi bawah gambar klip dan tepi bawah video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥1 menentukan piksel absolut.

Color

String

Tidak

Warna padding, dalam format tanda pagar (#) diikuti nilai heksadesimal. Contoh: #000000. Nilai default: hitam.

Jenis efek: Background (pengaturan latar belakang)

Pengaturan latar belakang mencakup blur latar belakang dan warna latar belakang. Saat ukuran klip dan ukuran video output tidak sesuai, Anda dapat menggunakan efek ini untuk mengonfigurasi area kosong. Pengaturan latar belakang dapat digunakan bersamaan dengan efek seperti crop, scale, efek visual, dan transisi.

Contoh timeline: Konversi video landscape ke portrait dan atur warna latar belakang

Nama

Tipe

Wajib

Deskripsi

SubType

String

Ya

Subtipe latar belakang. Nilai valid: Blur (blur latar belakang), Color (warna latar belakang).

Radius

Float

Tidak

Jari-jari blur. Parameter ini berlaku saat SubType diatur ke Blur. Nilai valid: [0.01, 1].

Color

String

Tidak

Nilai warna latar belakang, dinyatakan sebagai warna RGB heksadesimal. Parameter ini berlaku saat SubType diatur ke Color. Contoh: #FFFFFF.

Jenis efek: Rotate (rotasi klip)

Memutar klip dengan sudut tertentu. Hanya rotasi 90°, 180°, dan 270° yang didukung. Anda dapat menempatkan efek ini dalam array Effects klip pada track video atau track gambar.

Contoh timeline: Putar materi

Nama

Tipe

Wajib

Deskripsi

Degree

Integer

Ya

Sudut rotasi searah jarum jam klip. Nilai valid: 90, 180, dan 270.

Jenis efek: Flip

Membalik video atau gambar pada track video secara horizontal atau vertikal.

Contoh timeline: Pembalikan horizontal dan vertikal

Nama

Tipe

Wajib

Deskripsi

Direction

String

Ya

Arah pembalikan. Nilai valid: horizontal (membalik gambar secara horizontal), vertical (membalik gambar secara vertikal).

Jenis efek: VFX (efek visual)

Contoh timeline: Efek visual

Nama

Tipe

Wajib

Deskripsi

SubType

String

Ya

Subtipe efek visual. Anda dapat menentukan beberapa subtipe yang dipisahkan koma (,), dan salah satunya dipilih secara acak. Anda juga dapat menentukan random untuk memilih satu secara acak dari semua subtipe efek visual. Contoh nilai: colorfulradial. Untuk daftar nilai valid lengkap dan efeknya, lihat Contoh efek khusus.

X

Float

Tidak

Hanya didukung saat SubType diatur ke mosaic_rect atau blur. Jarak horizontal antara pojok kiri atas area efek dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥2 menentukan piksel absolut.

Y

Float

Tidak

Hanya didukung saat SubType diatur ke mosaic_rect atau blur. Jarak vertikal antara pojok kiri atas area efek dan pojok kiri atas video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥2 menentukan piksel absolut.

Width

Float

Tidak

Hanya didukung saat SubType diatur ke mosaic_rect atau blur. Lebar area efek dalam video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap lebar video output. Nilai integer ≥2 menentukan piksel absolut.

Height

Float

Tidak

Hanya didukung saat SubType diatur ke mosaic_rect atau blur. Tinggi area efek dalam video output. Format persentase dan piksel didukung. Nilai dalam rentang [0, 0.9999] menentukan rasio relatif terhadap tinggi video output. Nilai integer ≥2 menentukan piksel absolut.

ExtParams

String

Tidak

Parameter ekstensi efek visual. Parameter ini hanya berlaku saat SubType diatur ke mask_circle, mask_rec, mask_linear, atau mask_minor (skenario mask). Untuk parameter konfigurasi ExtParams mask, lihat bagian berikut.

Contoh mask dan efek video output: Efek mask

Catatan

Untuk parameter mask berikut, jika tipe parameternya float, Anda harus menentukan nilainya secara ketat dalam format float, seperti 0.5 atau 2.0.

Parameter mask lingkaran

SubType = mask_circle

Parameter

Tipe

Nilai valid

Nilai default

Deskripsi

x

float

[0.0, lebar klip]

0.5

Koordinat X pusat lingkaran mask dalam klip, relatif terhadap pojok kiri atas klip. Nilai dalam rentang [0.0, 1.0] menentukan koordinat relatif terhadap lebar klip. Nilai >1.0 menentukan piksel absolut.

y

float

[0.0, tinggi klip]

0.5

Koordinat Y pusat lingkaran mask dalam klip, relatif terhadap pojok kiri atas klip. Nilai dalam rentang [0.0, 1.0] menentukan koordinat relatif terhadap tinggi klip. Nilai >1.0 menentukan piksel absolut.

width

float

[0.0, lebar klip]

0.8

Lebar elips mask, relatif terhadap lebar klip. Nilai dalam rentang [0.0, 1.0] menentukan lebar relatif terhadap lebar klip. Nilai >1.0 menentukan piksel absolut.

height

float

[0.0, tinggi klip]

0.8

Tinggi elips mask, relatif terhadap tinggi klip. Nilai dalam rentang [0.0, 1.0] menentukan tinggi relatif terhadap tinggi klip. Nilai >1.0 menentukan piksel absolut.

antialias

float

[0.0, 1.0]

0.1

Parameter antialiasing elips mask. Nilai yang lebih besar menghasilkan tingkat feathering tepi yang lebih tinggi.

angle

float

[-9999.0, 9999.0]

0.0

Sudut rotasi.

blur_intensity

float

[0.0, 1.0]

0

Intensitas blur di dalam mask. Nilai 0.0 menonaktifkan blur. Nilai yang lebih besar menghasilkan tingkat blur yang lebih tinggi di area mask.

outer_alpha

float

[0.0, 1.0]

0

Opasitas area di luar mask. Nilai 0.0 menunjukkan area di luar mask sepenuhnya transparan. Nilai 1.0 menunjukkan gambar asli di luar mask sepenuhnya dipertahankan. Nilai di antaranya menunjukkan retensi semi-transparan.

Parameter mask persegi panjang

SubType = mask_rec

Parameter

Tipe

Nilai valid

Nilai default

Deskripsi

x

float

[0.0, lebar klip]

0.5

Koordinat X pusat persegi panjang mask dalam klip video, relatif terhadap pojok kiri atas klip. Nilai dalam rentang [0.0, 1.0] menentukan koordinat relatif terhadap lebar klip. Nilai >1.0 menentukan piksel absolut.

y

float

[0.0, tinggi klip]

0.5

Koordinat Y pusat persegi panjang mask dalam klip video, relatif terhadap pojok kiri atas klip. Nilai dalam rentang [0.0, 1.0] menentukan koordinat relatif terhadap tinggi klip. Nilai >1.0 menentukan piksel absolut.

width

float

[0.0, lebar klip]

0.8

Lebar persegi panjang mask. Nilai dalam rentang [0.0, 1.0] menentukan lebar relatif terhadap lebar klip. Nilai >1.0 menentukan piksel absolut.

height

float

[0.0, tinggi klip]

0.8

Tinggi persegi panjang mask. Nilai dalam rentang [0.0, 1.0] menentukan tinggi relatif terhadap tinggi klip. Nilai >1.0 menentukan piksel absolut.

antialias

float

[0.0, 1.0]

0.1

Parameter antialiasing persegi panjang mask. Nilai yang lebih besar menghasilkan tingkat feathering tepi yang lebih tinggi.

radius

float

[0.0, nilai lebih besar antara lebar dan tinggi klip]

0.1

Jari-jari sudut persegi panjang mask. Nilai dalam rentang [0.0, 1.0] menentukan jari-jari relatif terhadap nilai lebih besar antara lebar dan tinggi klip. Nilai >1.0 menentukan piksel absolut.

angle

float

[-9999.0, 9999.0]

0.0

Sudut rotasi.

blur_intensity

float

[0.0, 1.0]

0

Intensitas blur di dalam mask. Nilai 0.0 menonaktifkan blur. Nilai yang lebih besar menghasilkan tingkat blur yang lebih tinggi di area mask.

outer_alpha

float

[0.0, 1.0]

0

Opasitas area di luar mask. Nilai 0.0 menunjukkan area di luar mask sepenuhnya transparan. Nilai 1.0 menunjukkan gambar asli di luar mask sepenuhnya dipertahankan. Nilai di antaranya menunjukkan retensi semi-transparan.

Parameter mask linear

SubType = mask_linear

Parameter

Tipe

Nilai valid

Nilai default

Deskripsi

x

float

[0.0, lebar klip]

0.5

Koordinat X titik referensi pusat mask linear dalam klip, relatif terhadap pojok kiri atas klip. Nilai dalam rentang [0.0, 1.0] menentukan koordinat relatif terhadap lebar klip. Nilai >1.0 menentukan piksel absolut.

y

float

[0.0, tinggi klip]

0.5

Koordinat Y titik referensi pusat mask linear dalam klip video, relatif terhadap pojok kiri atas video. Nilai dalam rentang [0.0, 1.0] menentukan koordinat relatif terhadap tinggi klip. Nilai >1.0 menentukan piksel absolut.

antialias

float

[0.0, 1.0]

0.1

Parameter antialiasing mask linear. Nilai yang lebih besar menghasilkan tingkat feathering tepi yang lebih tinggi.

angle

float

[-9999.0, 9999.0]

0.0

Sudut rotasi.

blur_intensity

float

[0.0, 1.0]

0

Intensitas blur di dalam mask. Nilai 0.0 menonaktifkan blur. Nilai yang lebih besar menghasilkan tingkat blur yang lebih tinggi di area mask.

outer_alpha

float

[0.0, 1.0]

0

Opasitas area di luar mask. Nilai 0.0 menunjukkan area di luar mask sepenuhnya transparan. Nilai 1.0 menunjukkan gambar asli di luar mask sepenuhnya dipertahankan. Nilai di antaranya menunjukkan retensi semi-transparan.

Parameter mask cermin

SubType = mask_minor

Parameter

Tipe

Nilai valid

Nilai default

Deskripsi

x

float

[0.0, lebar klip]

0.5

Koordinat X titik referensi pusat mask cermin dalam klip, relatif terhadap pojok kiri atas klip. Nilai dalam rentang [0.0, 1.0] menentukan koordinat relatif terhadap lebar klip. Nilai >1.0 menentukan piksel absolut.

y

float

[0.0, tinggi klip]

0.5

Koordinat Y titik referensi pusat mask cermin dalam klip, relatif terhadap pojok kiri atas klip. Nilai dalam rentang [0.0, 1.0] menentukan koordinat relatif terhadap tinggi klip. Nilai >1.0 menentukan piksel absolut.

antialias

float

[0.0, 1.0]

0.1

Parameter antialiasing mask cermin. Nilai yang lebih besar menghasilkan tingkat feathering tepi yang lebih tinggi.

angle

float

[-9999.0, 9999.0]

0.0

Sudut rotasi.

blur_intensity

float

[0.0, 1.0]

0

Intensitas blur di dalam mask. Nilai 0.0 menonaktifkan blur. Nilai yang lebih besar menghasilkan tingkat blur yang lebih tinggi di area mask.

outer_alpha

float

[0.0, 1.0]

0

Opasitas area di luar mask. Nilai 0.0 menunjukkan area di luar mask sepenuhnya transparan. Nilai 1.0 menunjukkan gambar asli di luar mask sepenuhnya dipertahankan. Nilai di antaranya menunjukkan retensi semi-transparan.

Jenis efek: Filter

Contoh timeline: Filter

Nama

Tipe

Wajib

Deskripsi

SubType

String

Ya

Subtipe filter. Anda dapat menentukan beberapa subtipe yang dipisahkan koma (,), dan salah satunya dipilih secara acak. Anda juga dapat menentukan random untuk memilih satu secara acak dari semua subtipe filter. Contoh nilai: M1. Untuk daftar nilai valid lengkap dan efeknya, lihat Contoh filter.

TimelineIn

Float

Tidak

Posisi awal filter pada timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika parameter ini dikosongkan, nilainya sama dengan nilai TimelineIn klip terkait.

TimelineOut

Float

Tidak

Posisi akhir filter pada timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika parameter ini dikosongkan, nilainya sama dengan nilai TimelineOut klip terkait.

ExtParams

String

Tidak

Parameter ekstensi filter. Parameter ini hanya berlaku saat SubType diatur ke color (filter warna). Untuk parameter konfigurasi ExtParams filter color grading, lihat bagian berikut.

Parameter filter color grading

Contoh timeline: Gunakan filter warna

Parameter

Tipe

Nilai valid

Nilai default

Deskripsi

brightness

int

[-255, 255]

0

Penyesuaian kecerahan.

contrast

int

[-100, 100]

0

Penyesuaian kontras.

saturation

int

[-100, 100]

0

Penyesuaian saturasi.

kelvin_temperature

int

[1000, 40000]

6000

Suhu warna. Berlaku bersamaan dengan temperature_ratio.

temperature_ratio

int

[0, 100]

0

Rasio suhu warna.

tint

int

[-100, 100]

0

Penyesuaian tint.

dark_corner_ratio

int

[0, 100]

0

Rasio vignette.

Jenis efek: Zoom

Menambahkan efek zoom ke klip terkait. Efek ini hanya didukung untuk klip dalam VideoTrack.

Nama

Tipe

Wajib

Deskripsi

StartRate

Float

Tidak

Rasio zoom awal. Nilai default: 1.0. Nilai valid: [1.0, 5.0].

EndRate

Float

Tidak

Rasio zoom akhir. Nilai default: StartRate + 0.3. Nilai valid: [StartRate, 5.0].

Duration

Float

Tidak

Durasi efek. Nilai default: durasi rendering Clip saat ini. Nilai valid: [0, durasi rendering Clip saat ini].

Jenis efek: KenBurns (efek Ken Burns)

Menerapkan efek Ken Burns ke video atau gambar dalam track video.

Pertimbangan:

  • Efek ini berlaku untuk gambar dan video, dan dapat digunakan bersamaan dengan VFX, filter, dan transisi.

  • Efek ini mendukung pengaturan lebar dan tinggi gambar output (lihat parameter WindowW dan WindowH). Oleh karena itu, efek ini tidak dapat digunakan bersamaan dengan efek Crop, Scale, Pad, atau Background.

Contoh timeline: Ken Burns

Nama

Tipe

Wajib

Deskripsi

Contoh

Duration

Float

Tidak

Durasi efek. Nilai default: durasi klip. Nilai maksimum: 10. Satuan: detik.

5

WindowW

Float

Tidak

Lebar gambar segmen output akhir. Nilai default: lebar video output. Satuan: piksel. Nilai dalam rentang (0, 1] menentukan nilai relatif. Nilai >1 menentukan nilai absolut.

1

WindowH

Float

Tidak

Tinggi gambar segmen output akhir. Nilai default: tinggi video output. Satuan: piksel. Nilai dalam rentang (0, 1] menentukan nilai relatif. Nilai >1 menentukan nilai absolut.

1

Start

String

Tidak

Posisi pojok kiri atas frame dalam klip asli saat efek dimulai. Format: "StartX,StartY,StartW,StartH". Semua nilai opsional. Batasan: 0 < StartX + StartW <= 1, 0 < StartY + StartH <= 1.

"0,0,0.9,0.9"

StartX

Float

Tidak

Koordinat X pojok kiri atas frame dalam klip asli saat efek dimulai. Nilai dalam rentang [0, 1) menentukan nilai relatif. Nilai ≥1 menentukan piksel absolut.

0

StartY

Float

Tidak

Koordinat Y pojok kiri atas frame dalam klip asli saat efek dimulai. Nilai dalam rentang [0, 1) menentukan nilai relatif. Nilai ≥1 menentukan piksel absolut.

0

StartW

Float

Tidak

Lebar frame dalam klip asli saat efek dimulai. Nilai dalam rentang (0, 1] menentukan nilai relatif. Nilai >1 menentukan piksel absolut.

0.9

StartH

Float

Tidak

Tinggi frame dalam klip asli saat efek dimulai. Nilai dalam rentang (0, 1] menentukan nilai relatif. Nilai >1 menentukan piksel absolut.

0.9

End

String

Tidak

Posisi pojok kiri atas frame dalam klip asli saat efek berakhir. Format: "EndX,EndY,EndW,EndH". Semua nilai opsional. Batasan: 0 < EndX + EndW <= 1, 0 < EndY + EndH <= 1.

"0,0,1,1"

EndX

Float

Tidak

Koordinat X pojok kiri atas frame dalam klip asli saat efek berakhir. Nilai dalam rentang [0, 1) menentukan nilai relatif. Nilai ≥1 menentukan piksel absolut.

0

EndY

Float

Tidak

Koordinat Y pojok kiri atas frame dalam klip asli saat efek berakhir. Nilai dalam rentang [0, 1) menentukan nilai relatif. Nilai ≥1 menentukan piksel absolut.

0

EndW

Float

Tidak

Lebar frame dalam klip asli saat efek berakhir. Nilai dalam rentang (0, 1] menentukan nilai relatif. Nilai >1 menentukan piksel absolut.

1

EndH

Float

Tidak

Tinggi frame dalam klip asli saat efek berakhir. Nilai dalam rentang (0, 1] menentukan nilai relatif. Nilai >1 menentukan piksel absolut.

1

Jenis efek: FreezeFrame (freeze frame)

Menerapkan pemrosesan freeze-frame ke frame terakhir klip video. Efek ini hanya berlaku untuk klip video dalam track video. Efek ini tidak berlaku untuk klip gambar dalam track video atau klip dalam track audio.

Efek ini tidak dapat digunakan bersamaan dengan transisi. Untuk informasi selengkapnya, lihat .

Contoh timeline: Freeze frame video

Nama

Tipe

Wajib

Deskripsi

Duration

Float

Tidak

Durasi freeze-frame. Nilai default: 0. Satuan: detik.

Efek transisi

Jenis efek: Transition

Transisi menumpangkan layer dua klip berdekatan dalam periode waktu yang sama, sehingga memperpendek durasi video output. Untuk menghindari durasi yang lebih pendek, gunakan efek DLTransition (transisi berbasis interpolasi frame).

Efek transisi ditempatkan di antara dua klip. Anda hanya perlu mengatur durasi transisi untuk klip sebelumnya. Transisi berlaku pada akhir klip sebelumnya dan awal klip berikutnya. Selama transisi, gambar video ditumpangkan, sehingga durasi total berkurang sebesar durasi transisi.

Sebagai contoh, track video berisi dua klip: Clip1 (10 detik) dan Clip2 (8 detik). Jika Anda menambahkan transisi 4 detik di antara Clip1 dan Clip2, durasi total track video berkurang dari 18 detik menjadi 14 detik.

Untuk daftar efek transisi yang tersedia, lihat Contoh efek transisi.

Contoh timeline: Contoh konfigurasi timeline transisi

Nama

Tipe

Wajib

Deskripsi

SubType

String

Ya

Subtipe transisi. Anda dapat menentukan beberapa subtipe yang dipisahkan koma (,), dan salah satunya dipilih secara acak. Anda juga dapat menentukan random untuk memilih satu secara acak dari semua subtipe transisi. Contoh nilai: directional. Untuk daftar nilai valid lengkap dan efeknya, lihat Contoh efek transisi.

Duration

Float

Tidak

Durasi efek transisi. Satuan: detik, akurat hingga empat tempat desimal. Nilai default: 1.

Jenis efek: DLTransition (transisi berbasis interpolasi frame)

Berbeda dengan Transition standar, DLTransition (Duration Lock Transition) mengisi transisi dengan frame beku sehingga durasi video output tidak berkurang.

Parameternya digunakan dengan cara yang sama seperti efek Transition.

Nama

Tipe

Wajib

Deskripsi

SubType

String

Ya

Subtipe transisi. Anda dapat menentukan beberapa subtipe yang dipisahkan koma (,), dan salah satunya dipilih secara acak. Anda juga dapat menentukan random untuk memilih satu secara acak dari semua subtipe transisi. Contoh nilai: directional. Untuk daftar nilai valid lengkap dan efeknya, lihat Contoh efek transisi.

Duration

Float

Tidak

Durasi efek transisi. Satuan: detik, akurat hingga empat tempat desimal. Nilai default: 1.

Efek audio

Jenis efek: Volume (penyesuaian volume)

Contoh timeline: Bisukan seluruh video, Contoh penyesuaian volume video dan volume klip audio

Nama

Tipe

Wajib

Deskripsi

Gain

Float

Ya

Gain volume. Nilai valid: 0 hingga 10. Nilai 0 menunjukkan bisu. Nilai 1 menunjukkan volume asli. Nilai <1 menunjukkan volume lebih rendah daripada volume asli. Nilai >1 menunjukkan volume lebih tinggi daripada volume asli. Jangan mengatur gain volume yang terlalu besar karena dapat menyebabkan distorsi audio.

Jenis efek: AFade (fade in dan fade out audio)

Contoh timeline: Konfigurasi fade in dan fade out untuk klip hanya audio dan audio dalam klip video

Nama

Type

Wajib

Deskripsi

SubType

String

Ya

Subtipe fade. Nilai valid: In (fade in), Out (fade out).

Duration

Float

Tidak

Durasi fade in atau fade out. Fade in berlaku pada awal klip. Fade out berlaku pada akhir klip. Nilai default: 0, yang menunjukkan fade in dan fade out tidak berlaku.

Curve

String

Tidak

Kurva volume efek fade. Nilai default: exp. Nilai valid: exp (kenaikan atau penurunan volume eksponensial), tri (kenaikan atau penurunan volume linear).

Jenis efek: ADenoise (pengurangan noise audio)

Mengurangi noise untuk audio dalam track video atau track audio.

Nama

Type

Wajib

Deskripsi

Mode

Integer

Tidak

Mode pengurangan noise. Nilai valid: 0 (tanpa pemrosesan, default), 1 (pengurangan noise dengan amplitudo kecil), 2 (menghapus noise stasioner sambil melindungi musik, cocok untuk konten musik), 3 (menghapus kuat noise stasioner, cocok untuk konten ucapan tanpa musik), 4 (ekstraksi ucapan, menghapus noise stasioner dan non-stasioner, cocok untuk konten non-musik).

Jenis efek: ALoudNorm (normalisasi kenyaringan)

ALoudNorm hanya berlaku untuk satu klip audio atau video. Jika Anda memiliki beberapa klip audio atau video dan ingin agar semuanya memiliki kenyaringan yang sama, konfigurasikan ALoudNorm secara terpisah untuk setiap klip.

Efek ini hanya berlaku untuk klip audio dan video. Jika ALoudNorm digunakan bersamaan dengan ADenoise atau Volume, urutan penerapannya adalah: ADenoise > Volume > ALoudNorm.

Contoh timeline: Normalisasi audio

Nama

Tipe

Wajib

Deskripsi

Loudness

Float

Tidak

Kenyaringan target, yang menentukan tingkat volume dan mematuhi pengukuran EBU R128. Nilai valid: [-70.0, -5.0]. Nilai default: -24.0.

TruePeak

Float

Tidak

Tingkat true peak, yang membatasi tingkat puncak tertinggi sinyal audio. Nilai valid: [-9.0, +0.0]. Nilai default: -2.0.

Jenis efek: AEqualize (equalisasi kenyaringan)

Menerapkan equalisasi kenyaringan seragam ke audio global. Efek ini berlaku untuk track efek dan merupakan efek global. Efek ini tidak didukung untuk satu klip saja.

Contoh timeline: Equalisasi volume

Nama

Tipe

Wajib

Deskripsi

Peak

Float

Tidak

Puncak target audio. Nilai default: 0.95. Jangan melebihi nilai ini. Nilai valid: (0, 1).

Gain

Float

Tidak

Faktor gain maksimum. Nilai valid: 1.0 hingga 100.0. Nilai default: 10.0. Normalizer audio dinamis menentukan faktor gain (lokal) maksimum yang mungkin untuk setiap frame input, yaitu faktor gain maksimum yang tidak menyebabkan clipping atau distorsi.

Efek berbasis AI

Jenis efek: AI_Matting (matting gambar)

Mengekstraksi subjek dari latar belakang warna hijau atau biru dan menumpangkannya pada video atau gambar latar belakang lain.

Catatan

Efek ini hanya dapat dipanggil di Wilayah Beijing, Shanghai, dan Hangzhou.

Contoh timeline: AI_Matting: Matting layar hijau

Nama

Tipe

Wajib

Deskripsi

Color

String

Ya

Warna latar belakang. Hanya hijau (matting gambar) dan biru (matting layar biru) yang didukung.

Auto

Integer

Ya

Menentukan apakah warna latar belakang ditentukan secara otomatis. Nilai valid: 0 (ditentukan berdasarkan ambang batas), 1 (ditentukan secara otomatis).

Thres

Float

Tidak

Ambang batas untuk menentukan warna latar belakang. Nilai yang lebih besar menghasilkan penentuan yang lebih longgar. Nilai valid: [0, 10].

Jenis efek: AI_RealMatting (matting live-action)

Mengekstraksi figur manusia dalam video dari adegan live-action dan menumpangkannya pada video atau gambar latar belakang lain.

Catatan

Efek ini hanya dapat dipanggil di Wilayah Beijing, Shanghai, dan Hangzhou.

Contoh timeline: AI_RealMatting: Penggantian latar belakang

Nama

Tipe

Wajib

Deskripsi

Thres

Float

Tidak

Ambang batas untuk menentukan warna latar belakang. Nilai yang lebih besar menghasilkan penentuan yang lebih longgar. Nilai valid: [0, 10]. Nilai default: 2.

Jenis efek: AI_Delogo (penghapusan logo cerdas)

Mengidentifikasi dan menghapus logo stasiun dalam video secara cerdas.

Catatan

Efek ini hanya dapat dipanggil di Wilayah Beijing dan Shanghai.

Jenis efek: Harmonization (harmonisasi latar belakang)

Menambahkan efek harmonisasi latar belakang ke klip terkait. Efek ini terutama berlaku untuk klip video manusia digital. Setelah Anda menambahkan efek ini ke klip video manusia digital, efek ini menyesuaikan dengan pencahayaan, kecerahan, dan suhu warna gambar latar belakang, sehingga mengurangi ketidaksesuaian visual antara klip video manusia digital dan gambar latar belakang.

  • Efek ini hanya didukung untuk klip dalam VideoTrack.

  • Hanya satu efek harmonisasi latar belakang yang dapat ditambahkan dalam satu permintaan editing.

    Efek ini tidak memiliki parameter input tambahan.

Efek lainnya

Jenis efek: Clip (pemotongan acak)

Fitur pemotongan. Hanya pemotongan acak yang didukung. Segmen waktu dipotong secara acak dari klip asli dan dimasukkan ke timeline.

Nama

Tipe

Wajib

Deskripsi

SubType

String

Ya

Jenis pemotongan. Hanya pemotongan acak yang didukung: RandomClip.

ClipDuration

Float

Ya

Durasi segmen yang dipotong.