Topik ini menjelaskan parameter untuk konfigurasi templat produksi video cerdas satu klik.
Catatan: Di antarmuka ini, wilayah dalam semua URL OSS media harus konsisten dengan wilayah dalam titik akhir OpenAPI.
Wilayah yang didukung: Tiongkok (Shanghai), Tiongkok (Beijing), Tiongkok (Hangzhou), Tiongkok (Shenzhen), AS (Barat), Singapura.
Saat menggunakan fitur ini, ganti semua contoh parameter dalam dokumen seperti [your-bucket], [your-region-id], [your-file-name], [your-file-path], dan ID media (misalnya, "****9d46c8b4548681030f6e****") dengan nilai aktual Anda.
Instruksi penggunaan
Anda dapat membuat templat produksi video satu klik kustom melalui AddTemplate - Create a template. Untuk detail parameter API, lihat Deskripsi parameter AddTemplate di bawah ini.
Anda dapat memperoleh informasi satu templat produksi video satu klik melalui GetTemplate - Get template information.
Anda dapat mengambil daftar templat produksi video satu klik melalui ListTemplates - List templates that meet the conditions.
Deskripsi parameter AddTemplate
Parameter | Tipe | Deskripsi | Nilai contoh | Wajib |
Name | String | Nama templat | batch-editing-template-1 | Tidak |
Type | String | Jenis templat. Untuk produksi video satu klik, nilai ini harus BatchEditing | BatchEditing | Ya |
JSON | Parameter konfigurasi templat | Lihat Config di Contoh parameter | Ya |
Deskripsi parameter Config
Parameter | Tipe | Deskripsi | Nilai contoh | Wajib |
JSON | Digunakan untuk mengonfigurasi parameter seperti Watermark stiker, musik latar, dan citra latar. | Lihat InputTemplateConfig di Contoh parameter | Tidak | |
JSON | Digunakan untuk mengonfigurasi parameter penyuntingan seperti judul, narasi suara, musik latar, dan citra latar. | Lihat EditingTemplateConfig di Contoh parameter | Tidak | |
JSON | Digunakan untuk mengonfigurasi parameter sintesis terkait resolusi, aliran video keluaran, dll. | Lihat OutputTemplateConfig di Contoh parameter | Ya |
Deskripsi parameter InputTemplateConfig
Parameter | Tipe | Deskripsi | Nilai contoh | Wajib |
StickerArray | List<Sticker> |
| [{"MediaId":"****9d46c8b4548681030f6e****","X":10,"Y":100,"Width":300,"Height":300,"Opacity":0.6}] | Tidak |
BackgroundMusicArray | List<String> |
| ["****b4549d46c88681030f6e****","****549d46c88b4681030f6e****"] | Tidak |
BackgroundImageArray | List<String> |
| ["****b4549d46c88681030f6e****","****549d46c88b4681030f6e****"] | Tidak |
Deskripsi parameter EditingTemplateConfig
Parameter | Tipe | Deskripsi | Nilai contoh | Wajib |
JSON | Konfigurasi terkait judul. Mendukung konfigurasi parameter keterangan. | Lihat Nilai contoh TitleConfig | Tidak | |
SubHeadingConfig | JSON | Konfigurasi subjudul multi-level. Mendukung pengaturan parameter keterangan. Deskripsi bidang JSON:
| {"1":{"Y":0.3,"FontSize":40},"3":{"Y":0.5,"FontSize":30}} | Tidak |
JSON | Konfigurasi skrip narasi suara. Penting Templat tidak mendukung konfigurasi parameter SpecialWordsConfig | Tidak | ||
JSON | Konfigurasi musik latar. | Tidak | ||
JSON | Konfigurasi citra latar. Jika citra latar telah dikonfigurasi di InputTemplateConfig, bidang ini tidak berlaku. | Tidak | ||
JSON | Konfigurasi kanvas untuk pratinjau halaman antarmuka depan. | {"Width": 1080,"Height": 1920} | Tidak |
Deskripsi parameter FECanvas
Jika Anda ingin memigrasikan gaya templat reguler dari Konsol - Templat reguler ke templat produksi video satu klik, untuk memastikan ukuran keterangan pratinjau sesuai dengan ukuran sintesis aktual, Anda perlu menyalin parameter FECanvas dan konfigurasi gaya judul dan keterangan dari templat reguler tersebut, lalu menetapkannya ke TitleConfig, SpeechConfig.AsrConfig, dan FECanvas dalam templat produksi video satu klik.
Parameter | Tipe | Deskripsi | Nilai contoh | Wajib |
Width | Integer | Lebar kanvas, satuan: piksel | 450 | Ya |
Height | Integer | Tinggi kanvas, satuan: piksel | 800 | Ya |
Deskripsi parameter OutputTemplateConfig
Parameter | Tipe | Deskripsi | Nilai contoh | Wajib |
Width | Integer | Lebar keluaran, px | 1920 | Ya |
Height | Integer | Tinggi keluaran, px | 1080 | Ya |
JSONObject | Konfigurasi aliran video keluaran, seperti Crf, Codec, dll. | {"Crf": 27} | Tidak |
Contoh parameter
{
"Name": "batch-editing-template-1",
"Type": "BatchEditing",
"Config": {
"InputTemplateConfig": {
"BackgroundImageArray": [
"https://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].png"
],
"BackgroundMusicArray": [
"icepublic-0c4475c3936f3a8743850f2da942ceee"
],
"StickerArray": [
{
"MediaURL": "https://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].jpeg",
"X": 0.1,
"Y": 0.1,
"Width": 0.1,
"Height": 0.1
}
]
},
"EditingTemplateConfig": {
"TitleConfig": {
"Y": 0.7
},
"SpeechConfig": {
"Voice": "zhifei",
"AsrConfig": {
"Y": 0.9
}
}
},
"OutputTemplateConfig": {
"Width": 1080,
"Height": 1920
}
}
}