全部产品
Search
文档中心

:Konfigurasi efek

更新时间:Nov 16, 2025

Struktur suatu efek bergantung pada jenisnya. Topik ini menjelaskan struktur berbagai jenis efek.

Jenis Efek: Teks (teks banner)

Contoh lini masa: Takarir dan templat takarir

Nama

Tipe

Diperlukan

Deskripsi

X

Float

Tidak

Jarak horizontal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. Koordinat ini diskalakan berdasarkan dimensi materi dan video keluaran.

Y

Float

Tidak

Jarak vertikal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. Koordinat ini diskalakan berdasarkan dimensi materi dan video keluaran.

TimelineIn

Float

Tidak

Waktu mulai teks banner pada timeline, dalam detik. Nilainya akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilainya sama dengan TimelineIn klip yang sesuai.

TimelineOut

Float

Tidak

Waktu akhir teks banner pada timeline, dalam detik. Nilainya akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilainya sama dengan TimelineOut klip yang sesuai.

Content

String

Ya

Isi teks banner.

Font

String

Tidak

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

FontSize

Int

Ya

Ukuran font teks banner. Ukuran font ini diskalakan berdasarkan dimensi materi dan video keluaran. Nilai default adalah 0. Nilai maksimum adalah 5000.

Catatan:

  • Anda dapat menentukan salah satu dari FontSize atau FixedFontSize. Jika Anda menentukan keduanya, hanya FontSize yang berlaku.

SizeRequestType

String

Tidak

Metode yang digunakan untuk menghitung ukuran sebenarnya dari teks yang dirender berdasarkan ukuran font. Nilai default adalah RealDim.

  • Nominal: Tinggi teks terjemahan yang dirender dalam piksel sama dengan ukuran font (FontSize).

  • RealDim: Untuk beberapa font, tinggi teks terjemahan yang dirender dalam piksel mungkin lebih kecil daripada ukuran font (FontSize).

FixedFontSize

Int

Ya

Ukuran font teks banner. Ukuran font ini tidak diskalakan berdasarkan dimensi materi dan video output.

Catatan:

  • Anda dapat menentukan salah satu dari FontSize atau FixedFontSize. Jika Anda menentukan keduanya, hanya FontSize yang berlaku.

FixedX

Float

Tidak

Jarak horizontal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. Koordinat ini tidak diskalakan berdasarkan dimensi materi dan video keluaran.

FixedY

Float

Tidak

Jarak horizontal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. Koordinat ini tidak diskalakan berdasarkan dimensi materi dan video keluaran.

FontColor

String

Tidak

Warna teks banner. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff.

FontColorOpacity

String

Tidak

Opasitas teks banner. Nilainya berkisar antara 0 hingga 1. Nilai 1 berarti teks tidak transparan (opaque). Nilai 0 berarti teks sepenuhnya transparan. Nilai default adalah 1.

FontFace

FontFace

Tidak

Gaya font teks banner.

Spacing

Integer

Tidak

Jarak antar karakter untuk teks banner, dalam piksel. Nilai default adalah 0.

LineSpacing

Integer

Tidak

Jarak antar baris untuk teks banner, dalam piksel. Nilai default adalah 0.

Angle

Float

Tidak

Sudut rotasi berlawanan arah jarum jam teks banner, dalam derajat. Nilai default adalah 0.

BorderStyle

Int

Tidak

Gaya garis tepi dan bayangan untuk teks banner. Nilai yang valid adalah 1 dan 3. 1: garis tepi dan bayangan. 3: kotak latar belakang buram. Nilai default adalah 1.

Outline

Int

Tidak

Lebar garis tepi teks banner, dalam piksel. Nilai default adalah 0.

OutlineColour

String

Tidak

Warna garis tepi teks banner. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff.

Shadow

Int

Tidak

Kedalaman bayangan yang dihasilkan oleh teks banner, dalam piksel. Nilai default adalah 0.

BackColour

String

Tidak

Warna bayangan teks banner. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff.

Alignment

String

Tidak

Penyelarasan teks banner. Nilai default adalah TopLeft. Nilai yang valid:

  • TopLeft: Pojok kiri atas video.

  • TopCenter: Tengah atas video.

  • TopRight: Pojok kanan atas video.

  • CenterLeft: Tengah kiri video.

  • CenterCenter: Tengah video.

  • CenterRight: Tengah kanan video.

  • BottomLeft: Pojok kiri bawah video.

  • BottomCenter: Tengah bawah video.

  • BottomRight: Pojok kanan bawah video.

Untuk memposisikan teks terjemahan secara akurat dengan penyelarasan berbeda, atur penyelarasan sebagai berikut:

  • Kiri: Rata kiri. Atur X dan Y ke koordinat vertex kiri atas teks terjemahan relatif terhadap pojok kiri atas video.

  • Tengah: Rata tengah. Atur X dan Y ke koordinat perpotongan sumbu tengah teks terjemahan dan batas atas relatif terhadap pojok kiri atas video.

  • Kanan: Rata kanan. Atur X dan Y ke koordinat vertex kanan atas teks terjemahan relatif terhadap pojok kiri atas video.

AdaptMode

String

Tidak

Metode untuk menangani teks banner yang melebihi lebar video atau TextWidth yang ditentukan:

  • AutoWrap: Secara otomatis membungkus teks.

  • AutoScale: Secara otomatis menskalakan teks.

  • AutoWrapAtSpaces: Secara otomatis membungkus teks hanya pada spasi. Ini cocok untuk membungkus otomatis teks terjemahan berbahasa Inggris saja.

TextWidth

String

Tidak

Lebar kotak teks terjemahan. Parameter ini hanya berlaku ketika AdaptMode diatur. Teks akan dibungkus atau diskalakan berdasarkan lebar ini. Jika Anda tidak menentukan parameter ini, teks akan dibungkus atau diskalakan berdasarkan lebar video. Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan persentase dari lebar video keluaran. Nilai yang lebih besar dari 1 merepresentasikan nilai piksel absolut.

FontUrl

String

Tidak

Jalur berkas font di bucket OSS yang ingin Anda gunakan untuk teks banner. Format TTF, OTF, dan WOFF didukung. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf

EffectColorStyle

String

Tidak

Jenis gaya teks artistik untuk teks banner. Untuk informasi selengkapnya, lihat Contoh efek teks artistik.

SubtitleEffects

SubtitleEffect[]

Tidak

Efek multilapis untuk teks banner. Anda dapat mengatur garis tepi multilapis, bayangan multilapis, efek buram Gaussian (hanya untuk bayangan), dan efek latar belakang teks terjemahan.

Catatan:

  • Jika Anda mengatur SubtitleEffects, bidang Outline dan Shadow pada track teks terjemahan tidak berlaku.

  • Ketika Anda mengatur efek garis tepi, bayangan, atau latar belakang multilapis, urutan array SubtitleEffects menentukan urutan lapisan. SubtitleEffect pertama dalam array dirender pada lapisan paling bawah, dan SubtitleEffect terakhir dirender pada lapisan paling atas.

AaiMotionInEffect

String

Tidak

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

AaiMotionIn

Float

Tidak

Durasi efek masuk untuk teks banner, dalam detik. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 0,5 detik. Jika durasi teks kurang dari 0,5 detik, durasi efek masuk adalah durasi total dikurangi durasi efek keluar.

AaiMotionOutEffect

String

Tidak

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

AaiMotionOut

Float

Tidak

Durasi efek keluar untuk teks banner, dalam detik. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 0,5 detik. Jika durasi teks kurang dari 0,5 detik, durasi efek keluar adalah durasi teks total.

AaiMotionLoopEffect

String

Tidak

Jenis efek loop untuk teks banner. Efek ini tidak dapat digunakan bersamaan dengan efek masuk atau keluar. Untuk informasi selengkapnya, lihat Contoh efek teks terjemahan.

Ratio

Float

Tidak

Kecepatan pemutaran efek loop untuk teks banner. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 1. Nilai lebih besar dari 1 menunjukkan loop lebih cepat. Nilai kurang dari 1 menunjukkan loop lebih lambat.

TextureURL

String

Tidak

Efek tekstur untuk teks terjemahan. Format PNG, JPG, JPEG, dan BMP didukung. Anda harus menggunakan berkas OSS. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png

BubbleStyleId

String

Tidak

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

BubbleWidth

Float

Tidak

Parameter ini hanya berlaku saat Anda menggunakan teks gelembung. Parameter ini menentukan lebar latar belakang gelembung relatif terhadap video keluaran. Nilai lebih besar dari 1 merepresentasikan nilai piksel absolut. Nilai kurang dari atau sama dengan 1 merepresentasikan nilai relatif.

BubbleHeight

Float

Tidak

Parameter ini hanya berlaku saat Anda menggunakan teks gelembung. Parameter ini menentukan tinggi latar belakang gelembung relatif terhadap video keluaran. Nilai lebih besar dari 1 merepresentasikan nilai piksel absolut. Nilai kurang dari atau sama dengan 1 merepresentasikan nilai relatif.

Jenis Efek: DeWatermark (penyembunyian)

Nama

Tipe

Diperlukan

Deskripsi

X

Float

Tidak

Jarak horizontal dari pojok kiri atas area penyembunyian ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0.

Y

Float

Tidak

Jarak vertikal dari pojok kiri atas area penyembunyian ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0.

Width

Float

Ya

Lebar area penyembunyian dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

Height

Float

Ya

Tinggi area penyembunyian dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

Jenis Efek: Crop

Contoh timeline: Pemotongan video

Nama

Tipe

Diperlukan

Deskripsi

X

Float

Tidak

Jarak horizontal dari pojok kiri atas area yang dipangkas ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0.

Y

Float

Tidak

Jarak vertikal dari pojok kiri atas area yang dipangkas ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0.

Width

Float

Ya

Lebar area yang dipangkas dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

Height

Float

Ya

Tinggi area yang dipangkas dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

Jenis Efek: Scale

Catatan: Jika Anda tidak menentukan efek Scale dan rasio aspek materi tidak sesuai dengan rasio aspek video keluaran, materi akan secara otomatis diskalakan agar sesuai dengan lebar atau tinggi video keluaran. Bilah hitam akan ditambahkan di atas dan bawah atau di kiri dan kanan, serta materi diposisikan di tengah.

Contoh timeline: Konfigurasi skala

Nama

Tipe

Diperlukan

Deskripsi

Width

Float

Ya

Lebar area yang diskalakan dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut.

Height

Float

Ya

Tinggi area yang diskalakan dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut.

Jenis Efek: Pad (padding)

Catatan: Jika Anda tidak menentukan efek Pad dan rasio aspek materi tidak sesuai dengan rasio aspek video keluaran, materi akan secara otomatis diskalakan agar sesuai dengan lebar atau tinggi video keluaran. Bilah hitam akan ditambahkan di atas dan bawah atau di kiri dan kanan, serta materi diposisikan di tengah.

Contoh timeline: Mengonversi video lanskap menjadi video potret dan menambahkan area buram di atas dan bawah

Nama

Tipe

Diperlukan

Deskripsi

Left

Float

Tidak

Jarak dari tepi kiri materi ke tepi kiri video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut.

Right

Float

Tidak

Jarak dari tepi kanan materi ke tepi kanan video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut.

Top

Float

Tidak

Jarak dari tepi atas materi ke tepi atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut.

Bottom

Float

Tidak

Jarak dari tepi bawah materi ke tepi bawah video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut.

Color

String

Tidak

Warna padding. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #000000. Warna default adalah hitam.

Jenis Efek: Background

Pengaturan latar belakang mencakup efek buram latar belakang dan warna latar belakang. Jika dimensi materi tidak sesuai dengan dimensi video keluaran, Anda dapat menggunakan efek ini untuk mengonfigurasi area kosong.

Efek latar belakang dapat digunakan bersama efek lain seperti Crop, Scale, VFX, dan Transition.

Contoh timeline: Mengonversi video lanskap menjadi video potret dan mengatur warna latar belakang

Nama

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Subtipe. Nilai yang valid:

Blur: efek buram latar belakang

Color: warna latar belakang

Radius

Float

Tidak

Radius efek buram. Parameter ini hanya berlaku ketika SubType diatur ke Blur. Nilainya berkisar antara 0,01 hingga 1.

Color

String

Tidak

Nilai warna. Parameter ini hanya berlaku ketika SubType diatur ke Color. Tentukan warna dalam format heksadesimal RGB. Contoh: #FFFFFF

Jenis Efek: Transition

Penting

Transisi ini dibuat dengan menumpangkan lapisan dua materi berurutan, yang memperpendek durasi video akhir. Untuk menghindarinya, gunakan efek transisi pengunci durasi (DLTransition), yang dijelaskan di bagian selanjutnya dalam topik ini.

Efek transisi terjadi di antara dua materi. Anda hanya perlu mengatur durasi transisi pada materi pertama. Efek ini diterapkan pada akhir materi pertama dan awal materi kedua. Selama transisi, frame video tumpang tindih, yang mengurangi durasi total sebesar durasi transisi.

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

Tabel berikut menjelaskan properti transisi. Untuk informasi lebih lanjut mengenai efek transisi, lihat Contoh efek transisi.

Contoh timeline: Contoh konfigurasi timeline transisi

Nama

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

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

Duration

Float

Tidak

Durasi efek transisi, dalam detik. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 1 detik.

Jenis Efek: DLTransition (transisi pengunci durasi)

Berbeda dengan efek Transition standar, efek transisi pengunci durasi (DLTransition) tidak memperpendek durasi video akhir karena mengisi periode transisi dengan frame diam.

Parameter untuk efek ini sama dengan parameter untuk efek Transition.

Nama

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

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

Duration

Float

Tidak

Durasi efek transisi, dalam detik. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 1 detik.

Jenis Efek: VFX

Contoh timeline: Efek VFX

Nama

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Subtipe VFX. Anda dapat menentukan beberapa subtipe yang dipisahkan koma, dari mana satu dipilih secara acak. Anda juga dapat menentukan `random` untuk memilih secara acak dari semua subtipe yang tersedia. Contoh: colorfulradial. Untuk daftar lengkap nilai dan efeknya, lihat Contoh efek VFX.

X

Float

Tidak

Bidang ini hanya didukung ketika SubType diatur ke mosaic_rect atau blur. Jarak horizontal dari pojok kiri atas area efek ke pojok kiri atas video keluaran.

Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

Y

Float

Tidak

Bidang ini hanya didukung ketika SubType diatur ke mosaic_rect atau blur.

Jarak vertikal dari area efek ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

Width

Float

Tidak

Bidang ini hanya didukung ketika SubType diatur ke mosaic_rect atau blur. Lebar area efek dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

Height

Float

Tidak

Bidang ini hanya didukung ketika SubType diatur ke mosaic_rect atau blur. Tinggi area efek dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

ExtParams

String

Tidak

Parameter tambahan untuk efek. Bidang ini hanya berlaku untuk skenario penyembunyian, di mana SubType diatur ke mask_circle, mask_rec, mask_linear, atau mask_minor. Untuk informasi tentang konfigurasi ExtParams untuk penyembunyian, lihat bagian berikut.

Untuk contoh penyembunyian dan efek yang dihasilkannya, lihat Efek penyembunyian.

Penting

Untuk parameter penyembunyian berikut, jika suatu parameter berupa bilangan titik mengambang, Anda harus menentukannya dalam format titik mengambang, seperti 0,5 atau 2,0.

Parameter efek penyembunyian lingkaran

SubType=mask_circle

Parameter ExtParams

Parameter

Tipe

Rentang nilai

Nilai default

Deskripsi

x

float

[0,0, lebar material]

0,5

Koordinat x pusat penyembunyian relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

y

float

[0,0, tinggi materi]

0,5

Koordinat y pusat penyembunyian relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

width

float

[0,0, lebar material]

0,8

Lebar penyembunyian elips relatif terhadap lebar materi. Nilai dari 0,0 hingga 1,0 merepresentasikan lebar relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

height

float

[0,0, tinggi materi]

0,8

Tinggi penyembunyian elips relatif terhadap lebar materi. Nilai dari 0,0 hingga 1,0 merepresentasikan tinggi relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

antialias

float

[0.0, 1.0]

0,1

Parameter anti-aliasing untuk penyembunyian elips. Nilai yang lebih besar menunjukkan tingkat feathering tepi yang lebih tinggi.

angle

float

[-9999,0, 9999,0]

0,0

Sudut rotasi.

Parameter efek penyembunyian persegi panjang

SubType=mask_rec

Parameter ExtParams

Parameter

Tipe

Rentang nilai

Nilai default

Deskripsi

x

float

[0,0, lebar material]

0,5

Koordinat x pusat penyembunyian persegi panjang relatif terhadap pojok kiri atas materi video. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

y

float

[0,0; tinggi bahan]

0,5

Koordinat y pusat penyembunyian persegi panjang relatif terhadap pojok kiri atas materi video. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

width

float

[0,0; lebar bahan]

0,8

Lebar penyembunyian persegi panjang. Nilai dari 0,0 hingga 1,0 merepresentasikan lebar relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

height

float

[0,0; tinggi material]

0,8

Tinggi penyembunyian persegi panjang. Nilai dari 0,0 hingga 1,0 merepresentasikan tinggi relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

antialias

float

[0,0, 1,0]

0,1

Parameter anti-aliasing untuk penyembunyian persegi panjang. Nilai yang lebih besar menunjukkan tingkat feathering tepi yang lebih tinggi.

radius

float

[0,0; nilai yang lebih besar antara lebar dan tinggi material]

0,1

Jari-jari sudut penyembunyian persegi panjang. Nilai dari 0,0 hingga 1,0 merepresentasikan jari-jari relatif terhadap nilai yang lebih besar antara lebar atau tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

angle

float

[-9999,0, 9999,0]

0,0

Sudut rotasi.

Parameter efek penyembunyian linear

SubType=mask_linear

Parameter ExtParams

Parameter

Tipe

Rentang nilai

Nilai default

Deskripsi

x

float

[0,0; lebar material]

0,5

Koordinat x titik referensi pusat penyembunyian linear relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

y

float

[0,0; tinggi bahan]

0,5

Koordinat y titik referensi pusat penyembunyian linear relatif terhadap pojok kiri atas video. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

antialias

float

[0.0, 1.0]

0,1

Parameter anti-aliasing untuk penyembunyian linear. Nilai yang lebih besar menunjukkan tingkat feathering tepi yang lebih tinggi.

angle

float

[-9999,0, 9999,0]

0,0

Sudut rotasi.

Parameter efek penyembunyian cermin

SubType=mask_minor

Parameter ExtParams

Parameter

Tipe

Rentang nilai

Nilai default

Deskripsi

x

float

[0,0, lebar material]

0,5

Koordinat x titik referensi pusat penyembunyian cermin relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

y

float

[0,0, tinggi material]

0,5

Koordinat y titik referensi pusat penyembunyian cermin relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut.

antialias

float

[0.0, 1.0]

0,1

Parameter anti-aliasing untuk penyembunyian cermin. Nilai yang lebih besar menunjukkan tingkat feathering tepi yang lebih tinggi.

angle

float

[-9999,0, 9999,0]

0,0

Sudut rotasi.

Jenis Efek: Filter

Contoh timeline: Efek filter

Nama

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Subtipe filter. Anda dapat menentukan beberapa subtipe yang dipisahkan koma, dari mana satu dipilih secara acak. Anda juga dapat menentukan `random` untuk memilih secara acak dari semua subtipe yang tersedia. Contoh: M1. Untuk daftar lengkap nilai dan efeknya, lihat Contoh efek filter.

TimelineIn

Float

Tidak

Waktu mulai filter pada timeline, dalam detik. Nilainya akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilainya sama dengan TimelineIn klip yang sesuai.

TimelineOut

Float

Tidak

Waktu akhir filter pada timeline, dalam detik. Nilainya akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilainya sama dengan TimelineOut klip yang sesuai.

ExtParams

String

Tidak

Parameter tambahan untuk filter. Bidang ini hanya berlaku ketika SubType diatur ke color (filter warna). Untuk informasi tentang konfigurasi ExtParams untuk filter warna, lihat bagian berikut.

ExtParams untuk filter warna

Contoh timeline: Menggunakan filter warna

Parameter ExtParams

Parameter

Tipe

Rentang nilai

Deskripsi

Nilai default

brightness

int

[-255,255]

Kecerahan

0

contrast

int

[-100,100]

Kontras

0

saturation

int

[-100,100]

Saturasi

0

kelvin_temperature

int

[1000,40000]

Suhu. Parameter ini digunakan bersama

Parameter temperature_ratio berlaku.

6000

temperature_ratio

int

[0,100]

Rasio suhu

0

tint

int

[-100,100]

Rona

0

dark_corner_ratio

int

[0,100]

Rasio sudut gelap

0

Jenis Efek: Volume

Contoh timeline: Membisukan seluruh video, Menyesuaikan volume video dan audio

Nama

Tipe

Diperlukan

Deskripsi

Gain

Float

Ya

Penguatan volume. Nilainya berkisar antara 0 hingga 10. Nilai yang lebih kecil menunjukkan volume lebih rendah. Nilai 0 membisukan audio. Nilai 1 mempertahankan volume asli. Nilai kurang dari 1 menurunkan volume. Nilai lebih dari 1 meningkatkan volume. Jangan mengatur gain terlalu tinggi untuk menghindari distorsi audio.

Jenis Efek: AFade (fade-in/fade-out audio)

Contoh timeline: Mengonfigurasi fade-in/fade-out untuk klip hanya audio dan audio dalam klip video

Nama

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Subtipe fade-in/fade-out audio. Nilai yang valid:

  • In (fade-in)

  • Out (fade-out)

Duration

Float

Tidak

Durasi efek fade-in atau fade-out. Efek fade-in diterapkan pada awal segmen materi. Efek fade-out diterapkan pada akhir segmen materi. Nilai default adalah 0, yang berarti efek dinonaktifkan.

Curve

String

Tidak

Kurva volume untuk efek fade-in/fade-out. Nilai default adalah exp.

Nilai valid:

  • exp (Peningkatan/penurunan volume eksponensial)

  • tri (Peningkatan/penurunan volume linier)

Jenis Efek: AI_ASR (speech-to-text)

Efek ini menghasilkan teks terjemahan dari audio. Anda dapat menambahkan efek ini ke objek Effects pada track video atau audio. Parameternya sama dengan Jenis Efek: Teks (teks banner). Secara default, teks terjemahan diposisikan di tengah bawah video. Fitur ini hanya tersedia di wilayah Tiongkok (Beijing), Tiongkok (Shanghai), dan Tiongkok (Hangzhou).

Nama

Tipe

Diperlukan

Deskripsi

X

Float

Tidak

Jarak horizontal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

Y

Float

Tidak

Jarak vertikal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut.

Font

String

Tidak

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

FontSize

Int

Ya

Ukuran font teks banner.

FontColor

String

Tidak

Warna teks banner. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff.

FontColorOpacity

String

Tidak

Opasitas teks banner. Nilainya berkisar dari 0 hingga 1. Nilai 1 berarti teks tidak transparan. Nilai 0 berarti teks sepenuhnya transparan. Nilai default adalah 1.

FontFace

FontFace

Tidak

Gaya font teks banner.

NeedHighlighting

Boolean

Tidak

Menentukan apakah akan mengaktifkan penyorotan otomatis untuk teks terjemahan ASR.

HighlightingStyle

Style

Tidak

Gaya teks terjemahan yang disorot.

Jenis Efek: Rotate (rotasi materi)

Efek ini memutar materi dengan sudut tertentu. Hanya rotasi 90°, 180°, dan 270° yang didukung. Anda dapat menambahkan efek ini ke objek Effects pada materi video atau citra di track video.

Contoh timeline: Rotasi materi

Nama

Tipe

Diperlukan

Deskripsi

Derajat

Bilangan Bulat

Ya

Sudut rotasi searah jarum jam materi. Hanya 90, 180, dan 270 yang didukung.

Jenis Efek: AI_Matting (matting citra)

Efek ini mengekstraksi objek dari latar belakang layar hijau atau biru dan menumpangkannya ke video atau citra latar belakang lain. Fitur ini hanya tersedia di wilayah Tiongkok (Beijing), Tiongkok (Shanghai), dan Tiongkok (Hangzhou).

Nama

Tipe

Diperlukan

Deskripsi

Warna

String

Ya

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

Otomatis

Integer

Ya

Menentukan apakah akan mendeteksi warna latar belakang secara otomatis. Nilai yang valid:

  • 0: Mendeteksi berdasarkan ambang batas.

  • 1: Mendeteksi secara otomatis.

Ambang

Float

Tidak

Ambang batas untuk deteksi warna latar belakang. Nilai yang lebih besar menunjukkan deteksi yang lebih longgar. Nilainya berkisar antara 0 hingga 10.

Jenis Efek: AI_RealMatting (matting adegan nyata)

Efek ini mengekstraksi sosok manusia dari adegan dunia nyata dalam video dan menumpangkannya ke video atau citra latar belakang lain. Fitur ini hanya tersedia di wilayah Tiongkok (Beijing), Tiongkok (Shanghai), dan Tiongkok (Hangzhou).

Nama

Tipe

Diperlukan

Deskripsi

Thres

Float

Tidak

Ambang batas untuk deteksi warna latar belakang. Nilai yang lebih besar menunjukkan deteksi yang lebih longgar. Nilainya berkisar antara 0 hingga 10. Nilai default adalah 2.

Jenis Efek: AI_Delogo (penghapusan logo cerdas)

Efek ini secara cerdas mengenali dan menghapus logo stasiun dari video. Fitur ini hanya tersedia di wilayah Tiongkok (Beijing) dan Tiongkok (Shanghai).

Jenis Efek: Clip (pemangkasan acak)

Efek ini menyediakan fitur pemangkasan. Saat ini, hanya pemangkasan acak yang didukung. Segmen dengan durasi acak dipangkas dari materi asli dan ditambahkan ke timeline.

Nama

Tipe

Wajib

Deskripsi

SubType

String

Ya

Jenis pemangkasan. Saat ini, hanya pemangkasan acak yang didukung: RandomClip.

ClipDuration

Float

Ya

Durasi segmen yang dipotong.

Jenis Efek: Flip

Efek ini membalik frame video atau citra pada track video secara horizontal atau vertikal.

Contoh timeline: Pembalikan horizontal dan vertikal

Nama

Tipe

Diperlukan

Deskripsi

Arah

String

Ya

  • horizontal: Membalik frame secara horizontal.

  • vertical: Membalik frame secara vertikal.

Jenis Efek: KenBurns (pan dan zoom)

Efek ini menerapkan efek pan dan zoom pada video atau citra di track video.

Batasan:

  • Efek ini berlaku untuk citra dan video. Dapat digunakan bersama efek VFX, filter, dan transisi.

  • Efek ini memungkinkan Anda mengatur lebar dan tinggi frame keluaran (lihat parameter WindowW/WindowH di bawah). Oleh karena itu, tidak dapat digunakan bersama efek Crop, Scale, Pad, atau Background.

Nama

Tipe

Diperlukan

Deskripsi

Contoh

Durasi

Float

Tidak

Durasi efek, dalam detik (s). Nilai default adalah durasi klip. Nilai maksimum adalah 10.

5

WindowW

Float

Tidak

Lebar segmen keluaran akhir, dalam piksel (px). Nilai default adalah lebar video keluaran.

Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif. Nilai lebih besar dari 1 merepresentasikan nilai absolut.

1

WindowH

Float

Tidak

Tinggi segmen keluaran akhir, dalam piksel (px). Nilai default adalah tinggi video keluaran.

Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif.

> 1 merepresentasikan nilai absolut.

1

Mulai

String

Tidak

Posisi (koordinat x, koordinat y, lebar, dan tinggi) pojok kiri atas frame dalam materi asli pada awal efek. Nilainya dipisahkan koma. Semua nilai bersifat opsional.

"StartX,StartY,StartW,StartH"

Batas:

0 < StartX + StartW <=1

0 < StartY + StartH <=1

"0,0,0.9,0.9"

StartX

Float

Tidak

Koordinat x pojok kiri atas frame dalam materi asli pada awal efek, dalam piksel (px).

Nilai dalam interval tertutup-terbuka [0, 1) merepresentasikan nilai relatif.

Nilai lebih besar atau sama dengan 1 merepresentasikan nilai absolut.

0

StartY

Float

Tidak

Koordinat y pojok kiri atas frame dalam materi asli pada awal efek, dalam piksel (px).

Nilai dalam interval tertutup-terbuka [0, 1) merepresentasikan nilai relatif.

Nilai lebih besar atau sama dengan 1 merepresentasikan nilai absolut.

0

StartW

Float

Tidak

Lebar frame dalam materi asli pada awal efek, dalam piksel (px).

Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif.

Nilai lebih besar dari 1 merepresentasikan nilai absolut.

0.9

StartH

Float

Tidak

Tinggi frame dalam materi asli pada awal efek, dalam piksel (px).

Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif.

> 1 merepresentasikan nilai absolut.

0.9

Akhir

String

Tidak

Posisi (koordinat x, koordinat y, lebar, dan tinggi) pojok kiri atas frame dalam materi asli pada akhir efek. Nilainya dipisahkan koma. Semua nilai bersifat opsional.

"EndX,EndY,EndW,EndH"

Batas:

0 < EndX + EndW <=1

0 < EndY + EndH <=1

"0,0,1,1"

EndX

Float

Tidak

Koordinat x pojok kiri atas frame dalam materi asli pada akhir efek, dalam piksel (px).

Nilai dalam interval tertutup-terbuka [0, 1) merepresentasikan nilai relatif.

Nilai lebih besar atau sama dengan 1 merepresentasikan nilai absolut.

0

EndY

Float

Tidak

Koordinat y pojok kiri atas frame dalam materi asli pada akhir efek, dalam piksel (px).

Nilai dalam interval tertutup-terbuka [0, 1) merepresentasikan nilai relatif.

Nilai lebih besar atau sama dengan 1 merepresentasikan nilai absolut.

0

EndW

Float

Tidak

Lebar frame dalam materi asli pada akhir efek, dalam piksel (px).

Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif.

> 1 merepresentasikan nilai absolut.

1

EndH

Float

Tidak

Tinggi frame dalam materi asli pada akhir efek, dalam piksel (px).

Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif.

> Nilai 1 merepresentasikan nilai absolut.

1

Jenis Efek: ADenoise (penghilangan derau audio)

Efek ini melakukan penghilangan derau pada audio dalam video di track video atau pada klip audio di track audio.

Nama

Tipe

Diperlukan

Deskripsi

Mode

Integer

Tidak

  • 0: Tidak ada pemrosesan (default).

  • 1: Penghilangan derau ringan.

  • 2: Menghapus derau stasioner sambil mempertahankan musik. Cocok untuk konten musik.

  • 3: Penghapusan kuat derau stasioner. Cocok untuk konten ucapan tanpa musik.

  • 4: Ekstraksi suara. Menghapus derau stasioner dan non-stasioner. Cocok untuk konten non-musik.

Jenis Efek: Zoom

Efek ini menambahkan efek zoom pada klip yang sesuai.

Penting

Efek ini hanya dapat digunakan untuk klip pada VideoTrack.

Nama

Tipe

Diperlukan

Deskripsi

StartRate

Float

Tidak

  • Rasio zoom awal.

  • Nilai default: 1,0.

  • Rentang nilai: [1,0, 5,0].

EndRate

Float

Tidak

  • Rasio zoom akhir.

  • Nilai default: StartRate + 0,3.

  • Rentang nilai: [StartRate, 5,0].

Duration

Float

Tidak

  • Durasi efek.

  • Nilai default: Durasi rendering klip saat ini.

  • Rentang nilai: [0, durasi rendering klip saat ini].

Jenis Efek: Harmonization (penggabungan latar belakang)

Efek ini menambahkan efek penggabungan latar belakang pada klip yang sesuai. Efek ini terutama digunakan untuk klip video manusia digital. Ketika Anda menambahkan efek ini ke klip video manusia digital, efek ini menyesuaikan pencahayaan, kecerahan, dan suhu warna latar belakang citra untuk menciptakan penggabungan yang lebih mulus antara klip video manusia digital dan citra latar belakang.

Penting
  1. Efek ini hanya dapat digunakan untuk klip pada VideoTrack.

  2. Anda hanya dapat menambahkan satu efek Harmonization dalam satu permintaan pengeditan video.

Efek ini tidak memiliki parameter input lainnya.

Jenis Efek: ALoudNorm (normalisasi kenyaringan)

ALoudNorm hanya berlaku untuk satu materi audio atau video. Jika Anda memiliki beberapa materi audio atau video dan ingin semuanya memiliki kenyaringan yang sama, Anda harus mengonfigurasi ALoudNorm untuk setiap materi secara terpisah.

Catatan

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

Contoh timeline: Normalisasi kenyaringan

Nama

Tipe

Diperlukan

Deskripsi

Loudness

Float

Tidak

Kenyaringan target, yang menentukan tingkat volume dan mematuhi standar EBU R 128. Nilainya berkisar antara -70,0 hingga -5,0. Nilai default adalah -24,0.

TruePeak

Float

Tidak

Tingkat true peak, yang membatasi tingkat puncak tertinggi sinyal audio. Nilainya berkisar antara -9,0 hingga +0,0. Nilai default adalah -2,0.

Jenis Efek: AEqualize (equalisasi audio)

Efek ini berlaku untuk track efek sebagai efek global. Efek ini melakukan equalisasi audio seragam pada seluruh audio proyek.

Catatan

Efek ini hanya berlaku secara global dan tidak didukung untuk klip individual.

Contoh timeline: Equalisasi audio

Nama

Tipe

Diperlukan

Deskripsi

Peak

Float

Tidak

Tingkat puncak target audio. Nilai default adalah 0,95. Kami menyarankan agar Anda tidak melebihi nilai ini.

Nilai harus dalam interval terbuka (0, 1).

Gain

Float

Tidak

Koefisien gain maksimum. Nilainya berkisar antara 1,0 hingga 100,0. Nilai default adalah 10,0.

Normalizer audio dinamis menentukan faktor gain (lokal) maksimum yang mungkin untuk setiap frame input yang tidak menyebabkan clipping atau distorsi.

Jenis Efek: FreezeFrame (freeze frame)

Efek ini berlaku untuk materi video pada track video. Efek ini membekukan frame terakhir video.

Catatan

Efek ini hanya berlaku untuk materi video pada track video. Efek ini tidak berlaku untuk materi citra pada track video atau materi pada track audio.

Efek ini tidak dapat digunakan bersama efek Jenis Efek: Transition.

Contoh timeline: Freeze frame video

Nama

Tipe

Wajib

Deskripsi

Duration

Float

Tidak

Durasi freeze frame, dalam detik (s). Nilai default adalah 0.