Topik ini menjelaskan parameter produksi untuk montase sorotan.
Catatan: Saat menggunakan API ini, wilayah yang ditentukan dalam URL Object Storage Service (OSS) untuk semua aset media harus sesuai dengan wilayah titik akhir OpenAPI yang Anda panggil.
Wilayah yang didukung: Tiongkok (Shanghai), Tiongkok (Beijing), Tiongkok (Hangzhou), Tiongkok (Shenzhen), AS (Barat), dan Singapura. Fitur deteksi label aksi (sesuai dengan parameter EnableActionRecog dan CustomActions) hanya didukung di wilayah Tiongkok (Shanghai).
Versi ini tidak mendukung materi video tanpa suara manusia. Pastikan materi video Anda memenuhi persyaratan ini.
Saat menggunakan layanan ini, ganti parameter seperti [your-bucket], [your-region-id], [your-file-name], [your-file-path], dan ID aset media (misalnya, "****9d46c8b4548681030f6e****") dalam contoh dengan nilai aktual Anda.
Catatan penggunaan
Untuk membuat montase sorotan dari beberapa materi video dan memproduksi video secara batch dengan satu klik, lihat SubmitScreenMediaHighlightsJob - Kirim pekerjaan montase sorotan. Untuk informasi lebih lanjut mengenai parameter API utama, lihat bagian parameter InputConfig, EditingConfig, dan OutputConfig di bawah ini.
Untuk mengambil detail pekerjaan produksi video cerdas batch, lihat GetBatchMediaProducingJob - Dapatkan informasi tentang pekerjaan produksi video cerdas batch.
Parameter InputConfig
Konfigurasikan InputConfig untuk menentukan parameter materi dasar seperti cuplikan video, narasi suara, musik latar, dan stiker.
Parameter | Tipe | Deskripsi | Contoh | Diperlukan |
MediaArray | List<String> |
| Lihat Contoh parameter. | Ya |
HighlightStrategy | Kebijakan montase sorotan. | Lihat Contoh parameter. | Tidak | |
OpeningArray | List<Media> |
| Lihat Contoh parameter. | Tidak |
EndingArray | List<Media> |
| Lihat Contoh parameter. | Tidak |
TitleArray | List<String> | Judul. Maksimal 50 judul didukung. Satu judul dipilih secara acak untuk setiap produksi. Setiap judul dapat berisi hingga 50 karakter. | ["Hema Fresh di Huilongguan kini buka","Hema Fresh kini buka"] | Tidak |
SubHeadingArray | List<SubHeading> | Subjudul. Mendukung hingga lima tingkat subjudul. | Lihat Contoh parameter. | Tidak |
StickerArray | List<Sticker> |
| Lihat Contoh parameter. | Tidak |
BackgroundMusicArray | List<String> |
| Lihat Contoh parameter. | Tidak |
BackgroundImageArray | List<String> |
| Lihat Contoh parameter. | Tidak |
Parameter HighlightStrategy
Parameter | Tipe data | Deskripsi | Contoh | Diperlukan |
IntroConfig | JSON | Konfigurasi untuk awal bagian sorotan.
| {"Mode":"Disabled"} | Tidak |
TargetDurationConfig | Konfigurasi untuk durasi video keluaran. | {"TargetDuration": 180, "SpeedRange": [0.95, 1]} | Tidak | |
PlotPacingType | String |
| Lambat | Tidak. Nilai default: Normal. |
ThemeConfig | Konfigurasi terkait tema penyuntingan. | {"ThemeType":"JumpHighlight" } | Tidak | |
HighlightDescription | String | Deskripsi kebijakan ekstraksi sorotan. Parameter ini hanya berlaku ketika ThemeConfig.ThemeType diatur ke SmoothHighlight. | Prioritaskan adegan dengan fitur-fitur berikut. Emosi eksternal yang jelas: Protagonis pria secara langsung mengekspresikan emosi kuat melalui tindakan, seperti kemarahan, perlindungan, atau comeback (misalnya, 'persaingan' antara protagonis pria dan kakak laki-lakinya). Kontras kuat: Sampaikan konflik internal melalui perilaku atau identitas yang kontras (seperti perebutan kekuasaan atau ketegangan emosional). Konflik alur cerita terkonsentrasi: Fokus pada konflik inti protagonis, seperti permusuhan keluarga atau identitas tersamar, untuk meningkatkan keterlibatan penonton. Alur dramatis menonjol: Sertakan dialog aneh atau plot twist (seperti 'wanita yang menyamar sebagai pria dikenali') untuk meningkatkan daya tarik dan menciptakan buzz. | Tidak |
FaceInfo |
| {"ImageInfoList":[{"Name":"Ning X","ImageURL":"http://[your-cdn-domain]/[your-file-path]/face1.png"}]} | Tidak | |
EnableActionRecog | Boolean | Menentukan apakah akan mengaktifkan deteksi aksi. Jika diaktifkan, cuplikan sorotan dipilih berdasarkan hasil deteksi aksi. Catatan Deteksi aksi hanya didukung di wilayah Tiongkok (Shanghai). | true | Tidak. Nilai default: false. |
CustomActions | List<String> | Label aksi kustom. Sistem memprioritaskan pemetaan berdasarkan nama label yang disediakan. Contoh: ["fighting","crying"]. Array dapat berisi hingga 50 label. Setiap label dapat berisi hingga 5 karakter. Catatan Deteksi aksi hanya didukung di wilayah Tiongkok (Shanghai). | ["fighting","crying"] | Tidak |
Parameter ThemeConfig
Parameter | Tipe Data | Deskripsi | Contoh | Wajib |
ThemeType | String |
| SmoothHighlight | Tidak. Nilai default: JumpHighlight. |
Parameter TargetDurationConfig
Parameter | Tipe Data | Deskripsi | Contoh | Diperlukan |
TargetDuration | Float |
| 180 | Tidak |
SpeedRange | List<String> | Kisaran penyesuaian kecepatan. Jika Anda ingin video keluaran memiliki kecepatan tetap, atur nilai awal dan akhir kisaran kecepatan agar sama. Misalnya, [1.2, 1.2] mengatur kecepatan menjadi 1.2x. Jika Anda ingin durasi aktual video keluaran sedekat mungkin dengan TargetDuration, Anda dapat mengatur kisaran kecepatan yang dapat diterima. Misalnya:
| [0.95, 1] | Tidak |
Parameter FaceInfo
Parameter | Tipe | Deskripsi | Wajib |
ImageInfoList | List<ImageInfo> | Daftar foto karakter (wajah). Daftar dapat berisi hingga 200 foto. | Tidak |
Parameter ImageInfo
Parameter | Tipe | Deskripsi | Contoh | Wajib |
Name | String | Nama karakter (wajah). | Daniel | Ya |
ImageURL | String | Alamat penyimpanan foto karakter (wajah). URL harus dapat diakses melalui Internet. Pastikan citra wajah hanya berisi satu orang, dan wajahnya jelas, tanpa halangan signifikan atau bagian yang hilang. | http://[your-cdn-domain]/[your-file-path]/face1.png | Ya, salah satu wajib diisi. |
ImageId | String | ID aset media citra. | ****9d46c886b45481030f6e**** |
Parameter Media
Parameter | Tipe Data | Deskripsi | Contoh | Diperlukan |
MediaId | String | ID aset media. | ****b4549dfvc88681030f6e**** | Anda harus menentukan salah satu dari keduanya. Jika keduanya ditentukan, MediaId yang digunakan. |
MediaURL | String | URL aset media. Hanya OSS yang dikelola sendiri yang didukung. | Aturan: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4 Contoh: http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4 | |
In | Float | Jika materi berupa video, ini adalah titik masuk materi, dalam detik. | 0 | Tidak |
Out | Float | Jika materi berupa video, ini adalah titik keluar materi, dalam detik. | 5 | Tidak |
Duration | Float | Jika materi berupa citra, ini adalah durasi tampilan materi, dalam detik. | 2 | Tidak |
DyncFrames | Integer | Jika materi berupa GIF, ini adalah jumlah frame dalam citra animasi. | 25 | Tidak |
Contoh parameter
Penyuntingan potong-halus
{
"MediaArray": [
"****9d46c8b42f4581030f6e****",
"****9d46c8b4frtf81030f6e****",
"****9d46c8b4asdf81030f6e****",
"****9d46c8b43d3481030f6e****"
],
"HighlightStrategy": {
"IntroConfig": {
"Mode": "Disabled"
},
"TargetDurationConfig": {
"TargetDuration": 300
},
"ThemeConfig": {
"ThemeType": "SmoothHighlight"
},
"HighlightDescription":"Prioritize scenes with the following features. Obvious externalized emotions: The male protagonist directly expresses strong emotions through actions, such as anger, protection, or comeback (for example, the 'rivalry' between the male protagonist and his older brother). Strong contrast: Convey internal conflicts through contrasting behaviors or identities (such as power struggles or emotional tension). Concentrated plot conflicts: Focus on the protagonist's core conflicts, such as family feuds or disguised identities, to enhance viewer engagement. Prominent dramatic plots: Include bizarre dialogues or plot twists (such as 'a woman disguised as a man is recognized') to increase appeal and create buzz.",
"FaceInfo":{"ImageInfoList":[{"Name":"Ning X","ImageURL":"http://[your-cdn-domain]/[your-file-path]/face1.png"}]},
"EnableActionRecog": true,
"CustomActions": ["fighting","crying"]
},
"OpeningArray": [
{
"MediaId": "****9d46c8b4548681030f6e****",
"In": 0,
"Out": 5
},
{
"MediaId": "****9d46c8b4548661030f6e****",
"In": 0,
"Out": 5
}
],
"EndingArray": [
{
"MediaId": "****9d46c8b4548681030f6e****",
"In": 0,
"Out": 5
},
{
"MediaId": "****9d46c8b4548661030f6e****",
"In": 0,
"Out": 5
}
],
"TitleArray": [
"Hema Fresh in Huilongguan is now open",
"Hema Fresh is now open"
],
"SubHeadingArray": [
{
"Level": 1,
"TitleArray": [
"Subheading 1",
"Subheading 2"
]
},
{
"Level": 3,
"TitleArray": [
"Level 3 subheading"
]
}
],
"StickerArray": [
{
"MediaId": "****9d46c8b4548681030f6e****",
"X": 10,
"Y": 100,
"Width": 300,
"Height": 300,
"Opacity": 0.6
},
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png",
"X": 10,
"Y": 100,
"Width": 300,
"Height": 300
}
],
"BackgroundMusicArray": [
"****b4549d46c88681030f6e****",
"****549d46c88b4681030f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].mp3"
],
"BackgroundImageArray": [
"****6c886b4549d481030f6e****",
"****9d46c8548b4681030f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png"
]
}Penyuntingan potong-lompat
{
"MediaArray": [
"****9d46c8b42f4581030f6e****",
"****9d46c8b4frtf81030f6e****",
"****9d46c8b4asdf81030f6e****",
"****9d46c8b43d3481030f6e****"
],
"HighlightStrategy": {
"IntroConfig": {
"Mode": "Disabled"
},
"ThemeConfig": {
"ThemeType": "JumpHighlight"
},
"EnableActionRecog": true,
"CustomActions": ["fighting","crying"]
},
"OpeningArray": [
{
"MediaId": "****9d46c8b4548681030f6e****",
"In": 0,
"Out": 5
},
{
"MediaId": "****9d46c8b4548661030f6e****",
"In": 0,
"Out": 5
}
],
"EndingArray": [
{
"MediaId": "****9d46c8b4548681030f6e****",
"In": 0,
"Out": 5
},
{
"MediaId": "****9d46c8b4548661030f6e****",
"In": 0,
"Out": 5
}
],
"TitleArray": [
"Hema Fresh in Huilongguan is now open",
"Hema Fresh is now open"
],
"SubHeadingArray": [
{
"Level": 1,
"TitleArray": [
"Subheading 1",
"Subheading 2"
]
},
{
"Level": 3,
"TitleArray": [
"Level 3 subheading"
]
}
],
"StickerArray": [
{
"MediaId": "****9d46c8b4548681030f6e****",
"X": 10,
"Y": 100,
"Width": 300,
"Height": 300,
"Opacity": 0.6
},
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png",
"X": 10,
"Y": 100,
"Width": 300,
"Height": 300
}
],
"BackgroundMusicArray": [
"****b4549d46c88681030f6e****",
"****549d46c88b4681030f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].mp3"
],
"BackgroundImageArray": [
"****6c886b4549d481030f6e****",
"****9d46c8548b4681030f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png"
]
}Parameter EditingConfig
Konfigurasikan EditingConfig untuk menentukan parameter seperti volume, posisi, dan pengaturan produksi lainnya untuk video keluaran.
Parameter | Tipe | Deskripsi | Contoh | Diperlukan |
JSON | Konfigurasi untuk materi video masukan. | Lihat Contoh parameter. | Tidak | |
JSON | Konfigurasi untuk judul. Anda dapat mengonfigurasi parameter teks terjemahan (caption). | Lihat Contoh parameter. | Tidak | |
SubHeadingConfig | JSON | Konfigurasi untuk subjudul multi-level. Anda dapat mengatur parameter teks terjemahan. Deskripsi bidang JSON:
| Lihat Contoh parameter. | Tidak |
JSON | Konfigurasi untuk musik latar. | Lihat Contoh parameter. | Tidak | |
JSON | Konfigurasi untuk citra latar belakang. Jika citra latar belakang sudah dikonfigurasi di InputConfig, bidang ini tidak berlaku. | Lihat Contoh parameter. | Tidak | |
JSON | Konfigurasi untuk pemrosesan montase. | Lihat Contoh parameter. | ||
JSON | Konfigurasi kanvas untuk pratinjau halaman antarmuka depan. | {"Width": 1080,"Height": 1920} | Tidak | |
ProduceConfig | JSON | Konfigurasi untuk penyuntingan dan produksi video standar. Untuk informasi lebih lanjut mengenai bidang-bidangnya, lihat: EditingProduceConfig | {"AutoRegisterInputVodMedia":true,"OutputWebmTransparentChannel":true,"CoverConfig":{"StartTime":3.3},"AudioChannelCopy":"left","PipelineId":"xxxd54a97cff4108b555b01166d4bxxx","MaxBitrate":5000,"KeepOriginMaxBitrate":false,"KeepOriginVideoMaxFps":false} | Tidak |
Parameter ProcessConfig
Parameter | Tipe | Deskripsi | Contoh | Diperlukan |
AllowVfxEffect | Boolean | Menentukan apakah akan mengizinkan efek khusus. | true | Tidak. Nilai default: false. |
VfxEffectProbability | Float | Probabilitas menerapkan efek khusus pada setiap cuplikan video. Rentang nilai: 0.0 hingga 1.0. Mendukung hingga dua tempat desimal. | 0.6 | Tidak. Nilai default: 0.5. |
VfxFirstClipEffectList | List<String> |
| ["slightshow","starfieldshinee"] | Tidak |
VfxNotFirstClipEffectList | List<String> |
| ["zoomslight","zoom"] | Tidak |
AllowTransition | Boolean | Menentukan apakah akan mengizinkan transisi. | true | Tidak. Nilai default: false. |
TransitionDuration | Float | Durasi transisi, dalam detik. Jika durasi transisi lebih besar daripada durasi cuplikan dikurangi 1, efek transisi untuk cuplikan tersebut tidak berlaku. | 0.5 | Tidak. Nilai default: 0.5 detik. |
TransitionList | List<String> | Daftar efek transisi kustom. Ketika AllowTransition bernilai true, efek transisi dipilih secara acak dari daftar ini untuk produksi. Untuk efek transisi yang tersedia, lihat Pustaka efek transisi. Jika parameter ini kosong, transisi dipilih secara acak dari berikut ini: "linearblur", "colordistance", "crosshatch", "dreamyzoom", dan "doomscreentransition_up". | ["directional", "linearblur"] | Tidak |
UseUniformTransition | Boolean | Menentukan apakah menggunakan efek transisi yang sama di seluruh video output tunggal. | true | Tidak. Nilai default: true. |
AllowFilter | Boolean | Menentukan apakah akan mengizinkan filter kustom. | false | Tidak. Nilai default: false. |
FilterList | List<String> | Daftar efek filter kustom. Ketika AllowFilter bernilai true, filter dipilih secara acak dari daftar ini untuk produksi. Untuk efek filter yang tersedia, lihat Contoh efek filter. Jika parameter ini kosong, tidak ada efek filter yang ditambahkan. | ["m1", "m2"] | Tidak |
Contoh parameter
{
"MediaConfig": {
"Volume": 0 // Bisukan materi video sumber secara default.
},
"TitleConfig": {
"Alignment": "TopCenter",
"AdaptMode": "AutoWrap",
"Font": "Alibaba PuHuiTi 2.0 95 ExtraBold",
"SizeRequestType": "Nominal",
"Y": 0.1, // Koordinat Y judul saat video keluaran dalam mode potret.
"Y": 0.05, // Koordinat Y judul saat video keluaran dalam mode lanskap.
"Y": 0.08 // Koordinat Y judul saat video keluaran dalam mode persegi.
},
"SubHeadingConfig": {
"1": {
"Y": 0.3,
"FontSize": 40
},
"3": {
"Y": 0.5,
"FontSize": 30
}
},
"BackgroundMusicConfig": {
"Volume": 0.2, // Atur volume musik latar menjadi 20% secara default.
"Style": null
},
"ProcessConfig": {
"AllowVfxEffect": false, // Menentukan apakah akan menambahkan efek khusus.
"AllowTransition": false, // Menentukan apakah akan menambahkan transisi.
}
}Parameter TemplateConfig
TemplateConfig berisi parameter umum untuk produksi video satu-klik dan digunakan untuk mengonfigurasi templat produksi video. Untuk deskripsi parameter terperinci dan contoh penggunaan, lihat Parameter TemplateConfig.
Parameter OutputConfig
Konfigurasikan OutputConfig untuk menentukan parameter produksi seperti alamat keluaran, aturan penamaan, lebar dan tinggi, serta jumlah video keluaran.
Parameter | Tipe | Deskripsi | Contoh | Diperlukan |
MediaURL | String | Alamat video keluaran. Harus berisi placeholder {index}. | Aturan: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4 Contoh: http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4 | Wajib jika GeneratePreviewOnly bernilai false dan video keluaran dikirimkan ke OSS. |
StorageLocation | String | Menentukan alamat penyimpanan untuk file aset media yang akan dikirimkan ke VOD. | Aturan: [your-vod-bucket].oss-[your-region-id].aliyuncs.com Contoh: outin-****6c886b4549d481030f6e****.oss-cn-shanghai.aliyuncs.com | Wajib jika GeneratePreviewOnly bernilai false dan video keluaran dikirimkan ke VOD. |
FileName | String | Nama file keluaran. Harus berisi placeholder {index}. | Aturan: [your-file-name]__{index}.mp4 Contoh: example_{index}.mp4 | Wajib jika GeneratePreviewOnly bernilai false dan video keluaran dikirimkan ke VOD. |
GeneratePreviewOnly | Boolean |
| false | Tidak. Nilai default: false. |
Count | Integer |
| 1 | Tidak. Nilai default: 1. |
Width | Integer | Lebar video keluaran, dalam px. | 1080 | Ya |
Height | Integer | Tinggi video keluaran, dalam px. | 1920 | Ya |
JSONObject | Konfigurasi untuk aliran video keluaran, seperti Crf dan Codec. | {"Crf": 27} | Tidak |
Contoh parameter
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name]_{index}.mp4",
"Count": 1,
"Width": 1080,
"Height": 1920,
"Video": {"Crf": 27},
"GeneratePreviewOnly":false
}Logika pemrosesan
Konfigurasikan materi penyuntingan menggunakan MediaArray. Materi dianalisis dan diproses sesuai urutan yang diberikan.
Konfigurasikan pembuka dan penutup bagian reel sorotan menggunakan HighlightStrategy.
Konfigurasikan pembuka tetap (pre-roll) sebelum bagian reel sorotan dan penutup tetap (post-roll) setelahnya menggunakan OpeningArray dan EndingArray.
Parameter dalam panggilan API produksi video satu-klik memiliki prioritas lebih tinggi dibandingkan parameter yang diatur dalam templat. Jika Anda mengonfigurasi TemplateConfig, sistem pertama-tama membaca parameter non-kosong dari panggilan API. Untuk parameter yang kosong, sistem membaca nilainya dari templat.