All Products
Search
Document Center

Intelligent Media Services:Montase sorotan

Last Updated:Nov 11, 2025

Topik ini menjelaskan parameter produksi untuk montase sorotan.

Penting
  • 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

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>

  • Materi video untuk acara TV atau film. Hanya video yang didukung. Anda dapat memasukkan daftar ID aset media atau URL OSS. Durasi total video tidak boleh melebihi dua jam, dan jumlah maksimum video adalah 30.

  • Untuk informasi lebih lanjut mengenai format video yang didukung, lihat Format video.

    Penting

    Materi video tanpa teks terjemahan (caption) dan suara manusia tidak didukung.

Lihat Contoh parameter.

Ya

HighlightStrategy

HighlightStrategy

Kebijakan montase sorotan.

Lihat Contoh parameter.

Tidak

OpeningArray

List<Media>

  • Cuplikan pembuka tetap. Satu cuplikan dipilih secara acak untuk setiap produksi. Anda dapat memasukkan daftar ID aset media atau URL OSS. Jumlah maksimum cuplikan adalah 20.

  • Citra dan video didukung. Untuk informasi lebih lanjut mengenai format yang didukung, lihat Format video dan Format citra.

Lihat Contoh parameter.

Tidak

EndingArray

List<Media>

  • Cuplikan penutup tetap. Satu cuplikan dipilih secara acak untuk setiap produksi. Anda dapat memasukkan daftar ID aset media atau URL OSS. Jumlah maksimum cuplikan adalah 20.

  • Citra dan video didukung. Untuk informasi lebih lanjut mengenai format yang didukung, lihat Format video dan Format citra.

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>

  • Array stiker. Satu stiker dipilih secara acak untuk setiap produksi. Maksimal 50 stiker didukung. Anda dapat menentukan ID aset media atau URL OSS.

  • Aturan pengacakan: Misalkan Anda menyediakan 10 stiker dan menetapkan jumlah video keluaran menjadi 20. Pertama, bilangan acak dari 1 hingga 10 dihasilkan, misalnya 3. Kemudian, stiker dipilih secara berurutan: 3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7, dan seterusnya.

  • Untuk informasi lebih lanjut mengenai format yang didukung, lihat Format citra.

Lihat Contoh parameter.

Tidak

BackgroundMusicArray

List<String>

  • Array trek musik latar. Satu trek dipilih secara acak untuk setiap produksi. Maksimal 50 trek didukung. Anda dapat menentukan ID aset media atau URL OSS.

  • Aturan pengacakan: Misalkan Anda menyediakan 10 trek musik latar dan menetapkan jumlah video keluaran menjadi 20. Pertama, bilangan acak dari 1 hingga 10 dihasilkan, misalnya 3. Kemudian, trek dipilih secara berurutan: 3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7, dan seterusnya.

  • Untuk informasi lebih lanjut mengenai format yang didukung, lihat Format audio.

Lihat Contoh parameter.

Tidak

BackgroundImageArray

List<String>

  • Array citra latar belakang. Satu citra dipilih secara acak untuk setiap produksi. Maksimal 50 citra didukung. Anda dapat menentukan ID aset media atau URL OSS.

  • Aturan pengacakan: Misalkan Anda menyediakan 10 citra latar belakang dan menetapkan jumlah video keluaran menjadi 20. Pertama, bilangan acak dari 1 hingga 10 dihasilkan, misalnya 3. Kemudian, citra dipilih secara berurutan: 3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7, dan seterusnya.

  • Untuk informasi lebih lanjut mengenai format yang didukung, lihat Format citra.

Lihat Contoh parameter.

Tidak

Parameter HighlightStrategy

Parameter

Tipe data

Deskripsi

Contoh

Diperlukan

IntroConfig

JSON

Konfigurasi untuk awal bagian sorotan.

  • Mode: Mode pemilihan. Nilai default: Disabled.

    • Auto: Secara otomatis memilih cuplikan paling intens sebagai awal.

    • Disabled: Tidak ada awal tambahan yang ditambahkan.

{"Mode":"Disabled"}

Tidak

TargetDurationConfig

TargetDurationConfig

Konfigurasi untuk durasi video keluaran.

{"TargetDuration": 180, "SpeedRange": [0.95, 1]}

Tidak

PlotPacingType

String

  • Kecepatan alur cerita bagian sorotan. Parameter ini hanya berlaku ketika ThemeConfig.ThemeType diatur ke JumpHighlight.

  • Nilai yang valid:

    • Slow

    • Normal

    • Fast

Lambat

Tidak. Nilai default: Normal.

ThemeConfig

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

FaceInfo

  • Tetapkan informasi wajah untuk membantu mengidentifikasi karakter. Jika Anda ingin menampilkan karakter tertentu lebih banyak dalam sorotan, konfigurasikan parameter ini.

  • Parameter ini hanya berlaku ketika ThemeConfig.ThemeType diatur ke SmoothHighlight.

{"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

  • JumpHighlight: Penyuntingan potong-lompat. Memilih beberapa cuplikan sorotan dan menggabungkannya secara berurutan berdasarkan kronologi. Video hasilnya mungkin memiliki lompatan alur cerita dan cocok untuk membuat reel sorotan murni. Satu tugas hanya dapat menghasilkan satu video sekaligus.

  • SmoothHighlight: Penyuntingan potong-halus. Memilih beberapa cuplikan sorotan sebagai pembuka, lalu mulai dari setiap pembuka tersebut, memotong segmen video asli dengan panjang TargetDuration. Sistem secara otomatis menghapus cuplikan duplikat dan memangkas awal serta akhir. Video hasilnya memiliki alur cerita yang lebih koheren, dan beberapa video dapat dihasilkan sekaligus.

SmoothHighlight

Tidak. Nilai default: JumpHighlight.

Parameter TargetDurationConfig

Parameter

Tipe Data

Deskripsi

Contoh

Diperlukan

TargetDuration

Float

  • Durasi total yang diinginkan untuk bagian sorotan (tidak termasuk pembuka tetap, penutup tetap, dan awal bagian sorotan), dalam detik. Durasi aktual mungkin sedikit berbeda. Jika Anda tidak mengatur parameter ini, durasi akan disesuaikan secara otomatis berdasarkan alur cerita.

  • Nilai harus lebih besar dari atau sama dengan 5 detik dan kurang dari atau sama dengan durasi total materi sumber.

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:

  • Asumsikan TargetDuration adalah 10 dan SpeedRange adalah [0.95, 1]. Kisaran durasi yang dapat diterima yang dihitung dari SpeedRange adalah [10, 10.526] detik. Logika untuk menghitung durasi video keluaran aktual adalah sebagai berikut:

    • Jika durasi cuplikan aktual adalah 10.5 detik, yang berada dalam kisaran yang dapat diterima [10, 10.526], kecepatan disesuaikan menjadi sekitar 0.9524x (10 / 10.5). Durasi video akhir adalah 10 detik.

    • Jika durasi cuplikan aktual adalah 11 detik, kecepatan disesuaikan berdasarkan batas bawah SpeedRange, yaitu 0.95x. Durasi video akhir adalah 11 detik dikalikan 0.95, menghasilkan durasi 10.45 detik.

[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

MediaConfig

JSON

Konfigurasi untuk materi video masukan.

Lihat Contoh parameter.

Tidak

TitleConfig

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

BackgroundMusicConfig

JSON

Konfigurasi untuk musik latar.

Lihat Contoh parameter.

Tidak

BackgroundImageConfig

JSON

Konfigurasi untuk citra latar belakang. Jika citra latar belakang sudah dikonfigurasi di InputConfig, bidang ini tidak berlaku.

Lihat Contoh parameter.

Tidak

ProcessConfig

JSON

Konfigurasi untuk pemrosesan montase.

Lihat Contoh parameter.

FECanvas

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>

  • Jika VfxFirstClipEffectList tidak kosong, efek khusus untuk cuplikan pertama video keluaran dipilih dari daftar ini.

  • Jika VfxFirstClipEffectList kosong, efek khusus untuk cuplikan pertama dipilih secara acak dari berikut ini: "slightshow", "starfieldshinee", "starfieldshinee2", "starsparkle", "colorfulripples", dan "starfield".

  • Untuk contoh efek khusus, lihat: Contoh efek khusus.

["slightshow","starfieldshinee"]

Tidak

VfxNotFirstClipEffectList

List<String>

  • Jika VfxNotFirstClipEffectList tidak kosong, efek khusus untuk cuplikan selain yang pertama dipilih dari daftar ini.

  • Jika VfxNotFirstClipEffectList kosong, efek khusus untuk cuplikan selain yang pertama dipilih dari berikut ini: "zoomslight", "zoom", "zoominout", dan "slightshake".

  • Untuk contoh efek khusus, lihat: Contoh efek khusus.

["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

  • Jika GeneratePreviewOnly diatur ke true, tugas saat ini hanya menghasilkan timeline untuk pratinjau dan tidak benar-benar memproduksi video. Anda tidak perlu menentukan alamat video keluaran.

  • Setelah tugas produksi video satu-klik selesai, kueri hasil tugas menggunakan GetBatchMediaProducingJob. Daftar sub-tugas yang dikembalikan akan berisi ID proyek penyuntingan (projectId). Anda kemudian dapat memanggil GetEditingProject untuk mendapatkan timeline pratinjau.

false

Tidak. Nilai default: false.

Count

Integer

  • Jumlah video keluaran.

  • Ketika ThemeConfig.ThemeType bernilai JumpHighlight, Count hanya dapat bernilai 1.

  • Ketika ThemeConfig.ThemeType bernilai SmoothHighlight, jumlah video yang dihasilkan kurang dari atau sama dengan Count. Jumlah video aktual bergantung pada jumlah cuplikan sorotan. Nilai Count berkisar dari 1 hingga 100.

1

Tidak. Nilai default: 1.

Width

Integer

Lebar video keluaran, dalam px.

1080

Ya

Height

Integer

Tinggi video keluaran, dalam px.

1920

Ya

Video

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.

Referensi