CreateMediaConvertTask -

Membuat tugas transkoding media asinkron untuk memproses file audio dan video. Fitur yang didukung mencakup transkoding media, penggabungan media, tangkapan video, serta konversi video menjadi gambar animasi.

Deskripsi operasi

Sebelum memanggil operasi ini, pahami metode penagihan dan harga Intelligent Media Management (IMM).
Sebelum memanggil operasi ini, pastikan terdapat proyek aktif di wilayah saat ini. Untuk informasi selengkapnya, lihat Kelola proyek.
Penting Waktu eksekusi tugas asinkron tidak dijamin.
Saat menggunakan operasi ini untuk transkoding media, secara default hanya satu aliran video, audio, atau teks yang diproses. Anda dapat mengonfigurasi jumlah aliran video, audio, dan teks yang akan diproses.
Saat menggunakan operasi ini untuk penggabungan media, Anda dapat menggabungkan hingga 11 file media. Parameter yang dikonfigurasi untuk transkoding dan tangkapan berlaku pada data media hasil penggabungan.
Operasi ini bersifat asinkron. Setelah tugas dimulai, informasinya hanya disimpan selama 7 hari. Setelah periode tersebut, informasi tidak dapat diambil kembali. Panggil operasi GetTask atau ListTasks dengan TaskId yang dikembalikan untuk melihat informasi tugas. Anda juga dapat mengatur parameter Notification untuk menerima informasi tugas melalui notifikasi asinkron.

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:CreateMediaConvertTask

create

*Project

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ProjectName	string	Yes	Nama proyek. Untuk informasi selengkapnya tentang cara mendapatkan nama proyek, lihat Buat proyek.	test-project
Sources	array<object>	Yes	Daftar file media. Jika daftar berisi lebih dari satu elemen, fitur penggabungan diaktifkan. File-file tersebut digabung sesuai urutan URI-nya.
	array<object>	No	File media sumber.
URI	string	No	URI Object Storage Service (OSS) file tersebut. Formatnya adalah `oss://${Bucket}/${Object}`. `${Bucket}` adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini. `${Object}` adalah path lengkap file, termasuk ekstensi filenya.	oss://test-bucket/test-object
StartTime	number	No	Waktu mulai transkoding, dalam detik. Nilai yang valid: 0 (default): Transkoding dimulai dari awal file media. Bilangan lebih besar dari 0: Transkoding dimulai dari n detik setelah awal file media.	0
Duration	number	No	Durasi transkoding, dalam detik. Nilai default adalah 0, yang berarti video ditranskode hingga akhir.	0
Subtitles	array<object>	No	Daftar teks yang akan ditambahkan. Secara default kosong.
	object	No	Informasi subtitle.
URI	string	No	URI OSS file tersebut. Formatnya adalah `oss://${Bucket}/${Object}`. `${Bucket}` adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini. `${Object}` adalah path lengkap file, termasuk ekstensi filenya. Format teks yang didukung: srt, vtt, mov_text, ass, dvd_sub, dan pgs.	oss://test-bucket/test-object
TimeOffset	number	No	Tundaan teks, dalam detik. Nilai default adalah 0.	10.5
Language	string	No	Bahasa teks. Untuk informasi selengkapnya, lihat ISO 639-2. Secara default kosong.	eng
Attached	boolean	No	Menentukan apakah file media sumber saat ini ditambahkan ke file media output sebagai aliran audio atau video untuk pemutaran sinkron. Nilai default adalah false. Catatan Parameter `Attached` tidak boleh bernilai `true` untuk file sumber yang ditentukan oleh parameter `AlignmentIndex`.	false
AlignMode	string	No	Kebijakan penyelarasan untuk menambahkan aliran audio dan video. Nilai yang valid: false (default): Tidak ada penyelarasan. loop: Mengulang konten audio atau video agar selaras. pad: Menyelaraskan konten dengan mengisi frame audio diam atau frame video hitam. Catatan Parameter ini hanya berlaku jika parameter `Attached` diatur ke `true`.	false
DisableVideo	boolean	No	Menentukan apakah video dalam file media sumber dinonaktifkan. Nilai yang valid: true: Menonaktifkan video. false (default): Tidak menonaktifkan video.	false
DisableAudio	boolean	No	Menentukan apakah audio dalam file media sumber dinonaktifkan. Nilai yang valid: true: Menonaktifkan audio. false (default): Tidak menonaktifkan audio.	false
Targets	array<object>	Yes	Daftar tugas pemrosesan media. Anda dapat menentukan beberapa tugas.
	array<object>	No	Rincian elemen dalam array Targets.
URI	string	No	URI OSS file output hasil transkoding. Formatnya adalah `oss://${Bucket}/${Object}`. `${Bucket}` adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini. `${Object}` adalah path lengkap file, termasuk ekstensi filenya. Jika URI mencakup ekstensi file, URI OSS file media output adalah nilai URI. Jika beberapa file dihasilkan, file tersebut mungkin ditimpa. Jika URI tidak mencakup ekstensi file, URI OSS file media output ditentukan oleh parameter URI, Container, dan Segment. Misalnya, jika URI adalah `oss://examplebucket/outputVideo`: Jika Container adalah `mp4` dan Segment kosong, URI OSS file media yang dihasilkan adalah `oss://examplebucket/outputVideo.mp4`. Jika Container adalah `ts` dan Format dalam Segment adalah `hls`, sebuah file M3U8 dengan URI OSS `oss://examplebucket/outputVideo.m3u8` dan beberapa file TS dengan awalan `oss://examplebucket/outputVideo` akan dihasilkan.	oss://test-bucket/test-target-object.mp4
Container	string	No	Format kontainer media. Format kontainer yang valid: Kontainer audio dan video: mp4, mkv, mov, asf, avi, mxf, ts, dan flv Kontainer audio: mp3, aac, flac, oga, ac3, dan opus Penting Atur parameter `Container` dan `URI` secara bersamaan. Jika Anda hanya melakukan ekstraksi teks, pembuatan tangkapan video, pembuatan sprite, atau konversi video ke gambar animasi, biarkan kedua parameter `Container` dan `URI` kosong. Dalam kasus ini, parameter `Segment`, `Video`, `Audio`, dan `Speed` tidak berlaku.	mp4
Speed	number	No	Kecepatan pemutaran. Nilainya harus antara 0,5 hingga 1,0. Nilai default adalah 1,0. Catatan Parameter ini menentukan rasio kecepatan pemutaran file hasil transkoding terhadap file sumber. Parameter ini tidak memengaruhi kecepatan proses transkoding.	1.0
Segment	object	No	Pengaturan segmentasi media. Secara default, file media tidak disegmentasi.
Format	string	No	Metode segmentasi media. Nilai yang valid: hls dash	hls
Duration	number	No	Panjang segmen, dalam detik.	30
StartNumber	integer	No	Nomor ordinal awal. Parameter ini hanya didukung untuk HLS. Nilai default adalah 0.	5
Video	TargetVideo	No	Pengaturan parameter pemrosesan video. Penting Jika `Video` kosong, aliran video pertama (jika ada) akan langsung disalin ke file output.
Audio	TargetAudio	No	Pengaturan parameter pemrosesan audio. Penting Jika `Audio` kosong, aliran audio pertama (jika ada) akan langsung disalin ke file output.
Subtitle	TargetSubtitle	No	Pengaturan parameter pemrosesan teks. Penting Jika `Subtitle` kosong, aliran teks pertama (jika ada) akan langsung disalin ke file output.
Image	TargetImage	No	Pengaturan parameter untuk tangkapan video, sprite, dan konversi video ke gambar animasi.
StripMetadata	boolean	No	Menentukan apakah metadata file media, seperti `title` dan `album`, dihapus. Nilai default adalah false.
UserData	string	No	Data pengguna kustom. Data ini dikembalikan dalam notifikasi asinkron untuk membantu Anda mengaitkan notifikasi tersebut dengan sistem internal Anda. Panjang maksimum adalah 2.048 byte.	{"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
Tags	object	No	Tag kustom untuk mencari dan menyaring tugas asinkron.	{"test":"val1"}
CredentialConfig	CredentialConfig	No	Biarkan parameter ini kosong jika Anda tidak memiliki persyaratan khusus. Konfigurasi otorisasi berantai. Untuk informasi selengkapnya, lihat Gunakan otorisasi berantai untuk mengakses sumber daya entitas lain.
Notification	Notification	No	Pengaturan notifikasi pesan. Untuk informasi selengkapnya tentang format notifikasi asinkron, lihat Format pesan notifikasi asinkron.
AlignmentIndex	integer	No	Untuk penggabungan media, parameter ini menentukan indeks file media utama dalam daftar sumber. File utama menyediakan parameter transkoding default, seperti resolusi dan laju frame, untuk `Video` dan `Audio`. Nilai default adalah 0, yang merujuk pada file media pertama dalam daftar.	0

Elemen respons

Element	Type	Description	Example
	object	Struktur respons.
RequestId	string	ID permintaan.	CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6
EventId	string	ID event.	0ED-1Bz8z71k5TtsUejT4UJ16Es****
TaskId	string	ID tugas.	MediaConvert-adb1ee28-c4c9-42a7-9f54-3b8eadcb****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6",
  "EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es****",
  "TaskId": "MediaConvert-adb1ee28-c4c9-42a7-9f54-3b8eadcb****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.