CreateHighlightTask - Intelligent Media Management - Alibaba Cloud Documentation Center

Membuat tugas sorotan video. Fitur ini berada dalam pratinjau undangan.

Deskripsi operasi

Sebelum menggunakan operasi ini, pastikan Anda sepenuhnya memahami penagihan Produk Intelligent Media Management (IMM). Untuk informasi lebih lanjut, lihat Ikhtisar penagihan. Operasi ini mengenakan biaya untuk ekstraksi sorotan dan pemrosesan media.
Sebelum memanggil operasi ini, pastikan proyek sudah ada di wilayah saat ini. Untuk informasi lebih lanjut, lihat Referensi Manajemen Proyek.
Penting Tugas asinkron tidak menjamin ketepatan waktu.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

imm:CreateHighlightTask

create

*Proyek.

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

None

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
ProjectName	string	Yes	Nama proyek.	immtest
Sources	array<object>	Yes	Daftar Sumber daya media yang akan diproses. Maksimal 10 video didukung.
	object	No	Sumber daya media yang akan diproses.
URI	string	Yes	URI Sumber daya media (URI OSS). Hanya video yang didukung.	oss://test-bucket/test-object
StartTime	number	No	Waktu mulai Sumber daya media. Nilai valid: [0, durasi video]. Unit: detik. Parameter ini hanya berlaku jika Type diatur ke Concat.	0
Duration	number	No	Durasi segmen media. Unit: detik. Nilai default: 0, yang menunjukkan akhir video. Parameter ini hanya berlaku jika Type diatur ke Concat.	0
Mode	string	No	Mode pengenalan sorotan. Nilai valid: Scene: pengenalan adegan dan bingkai. Average (default): pengenalan potongan rata-rata.	Average
Type	string	Yes	Jenis pemrosesan. Nilai valid: Retrieval: ekstraksi sorotan. Concat: pencampuran aliran video. Compose: produksi video satu klik.	Retrieval
Highlight	object	No	Konfigurasi sorotan.
Content	string	Yes	Konten sorotan. Nilai valid: 宠物人物运动会议 Nilai tidak boleh melebihi 100 karakter.	character
Edit	object	No	Konfigurasi pengeditan.
Mode	string	Yes	Mode pengeditan. Nilai valid: Sequential: mode berurutan.	Sequential
BackgroundMusicMode	string	No	Mode musik latar. Nilai default: Closed. Nilai valid: Random: musik latar kustom, dipilih secara acak berdasarkan bobot. Sequential: musik latar kustom, diterapkan sesuai urutan. Closed: tanpa musik latar.	Closed
BackgroundMusics	array<object>	No	Daftar musik latar. Parameter ini hanya berlaku jika BackgroundMusicMode diatur ke Random atau Sequential. Jumlah maksimum adalah 1.
	object	No	Musik latar.
URI	string	Yes	URI musik latar (URI OSS). Hanya file audio yang didukung.	oss://test-bucket/test-object/test.mp3
Volume	number	No	Intensitas volume musik latar. Nilai valid: [0, 10]. Nilai default: 0.2. Nilai 1 menunjukkan volume asli.	0.2
TransitionMode	string	No	Mode transisi. Nilai default: Closed. Nilai valid: Auto: transisi otomatis. Random: transisi kustom, dipilih secara acak berdasarkan bobot. Sequential: transisi kustom, diterapkan sesuai urutan. Closed: tanpa transisi.	Closed
Transitions	array<object>	No	Efek transisi. Parameter ini hanya berlaku jika TransitionMode diatur ke Random atau Sequential. Maksimal 10 transisi didukung.
	object	No
Transition	string	Yes	Efek transisi. Untuk informasi lebih lanjut, lihat Referensi Efek transisi.	fade
Duration	number	No	Durasi transisi. Unit: detik. Jika durasi transisi lebih besar dari durasi segmen dikurangi 1, efek transisi pada segmen tersebut tidak berlaku. Nilai valid: [0, 5].	0
Weight	integer	No	Bobot transisi. Nilai valid: [1, 100]. Nilai default: 50. Parameter ini hanya berlaku jika TransitionMode diatur ke Random.	50
VfxEffectMode	string	No	Mode efek. Nilai default: Closed. Nilai valid: Auto: efek otomatis. Random: efek kustom, dipilih secara acak berdasarkan bobot. Sequential: efek kustom, diterapkan sesuai urutan. Closed: tanpa efek.	Closed
VfxEffects	array<object>	No	Efek visual. Parameter ini hanya berlaku jika VfxEffectMode diatur ke Random atau Sequential. Maksimal 10 efek didukung.
	object	No
VfxEffect	string	Yes	Efek visual. Untuk informasi lebih lanjut, lihat Referensi Efek.	letterboxed
Weight	integer	No	Bobot efek. Nilai valid: [1, 100]. Nilai default: 50. Parameter ini hanya berlaku jika VfxEffectMode diatur ke Random.	50
Output	object	Yes	Konfigurasi output.
URI	string	Yes	URI file output.	oss://test-bucket/test-target-object.mp4
Container	string	No	Tipe kontainer media. Parameter ini wajib diisi jika Type diatur ke Concat atau Compose. Nilai valid: Kontainer audio dan video: mp4, mkv, mov, asf, avi, mxf, ts, flv. Penting Kontainer dan URI harus ditentukan bersama.	mp4
Speed	number	No	Kecepatan pemutaran media. Nilai valid: [0.5, 1.0]. Nilai default: 1.0. Catatan Nilai ini adalah rasio kecepatan pemutaran file media yang ditranskode terhadap kecepatan pemutaran default file media sumber. Ini bukan transkoding dengan penyesuaian kecepatan.	1.0
Segment	object	No	Pengaturan segmentasi media. Secara default, tidak ada segmentasi yang dilakukan.
Format	string	No	Format segmentasi media. Nilai valid: hls dash	hls
Duration	number	No	Panjang segmen. Unit: detik.	1
StartNumber	integer	No	Nomor awal. Hanya hls yang didukung. Nilai default: 0.	0
Video	TargetVideo	No	Pengaturan parameter pemrosesan video. Penting Jika Video kosong, aliran video pertama (jika ada) langsung disalin ke file output.
Audio	TargetAudio	No	Pengaturan parameter pemrosesan audio. Penting Jika Audio kosong, aliran audio pertama (jika ada) langsung disalin ke file output.
MaxDuration	number	No	Durasi maksimum video yang dipotong. Unit: detik.	10.0
UserData	string	No	Informasi kustom, yang dikembalikan dalam notifikasi Paket asinkron.	{"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
Tags	object	No	Tag kustom yang digunakan untuk mencari dan memfilter tugas asinkron.	{"test":"val1"}
CredentialConfig	CredentialConfig	No	Konfigurasi otorisasi China. Biarkan parameter ini kosong kecuali Anda memiliki persyaratan khusus.
Notification	Notification	No	Konfigurasi notifikasi paket. Untuk informasi lebih lanjut, klik Notifikasi. Untuk format pesan notifikasi asinkron, lihat Referensi Format pesan notifikasi asinkron.

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan.	CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6
EventId	string	ID event.	0ED-1Bz8z71k5TtsUejT4UJ16Es****
TaskId	string	ID tugas.	Highlight-4d51241b-04d4-4343-aa25-****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6",
  "EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es****",
  "TaskId": "Highlight-4d51241b-04d4-4343-aa25-****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.