Gunakan CreateMediaConvertTask untuk membuat tugas pemrosesan media asinkron - Intelligent Media Management

Membuat pekerjaan transkoding media asinkron yang mendukung transkoding media, penggabungan media, penangkapan frame video, dan pembuatan gambar animasi.

Deskripsi operasi

Sebelum menggunakan API ini, pastikan Anda memahami model penetapan harga dan harga untuk Intelligent Media Management.
Pastikan tersedia Proyek di wilayah saat ini sebelum memanggil API ini. Untuk informasi selengkapnya, lihat Manajemen Proyek.
Penting Waktu penyelesaian tugas asinkron tidak dijamin.
Secara default, API ini hanya memproses satu aliran video, audio, atau subtitle untuk transkoding media. Anda dapat mengonfigurasi jumlah aliran tersebut.
Untuk penggabungan media, API ini mendukung hingga 11 file media. Parameter yang dikonfigurasi untuk transkoding media, penangkapan frame, dan operasi lainnya berlaku untuk media yang digabungkan.
API ini bersifat asinkron. Informasi tugas hanya disimpan selama 7 hari sejak tugas dimulai dan tidak dapat diambil setelah periode tersebut. Gunakan TaskId yang dikembalikan oleh GetTask atau ListTasks untuk melihat informasi tugas. Alternatifnya, Anda dapat mengatur parameter Notification untuk menerima notifikasi tugas.

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 mendapatkan nama proyek, lihat Buat proyek.	test-project
Sources	array<object>	Yes	Daftar file media sumber. Jika Anda memberikan lebih dari satu file, file-file tersebut akan digabungkan sesuai urutan URI-nya.
	array<object>	No	File media sumber.
URI	string	No	URI OSS dari file sumber. URI harus dalam format `oss://${Bucket}/${Object}`, dengan `${Bucket}` adalah nama bucket OSS di wilayah yang sama dengan proyek, dan `${Object}` adalah path lengkap objek, termasuk ekstensi file.	oss://test-bucket/test-object
StartTime	number	No	Waktu mulai untuk transkoding, dalam detik. Nilai yang valid: `0` (default): Memulai transkoding dari awal file media. `n` (nilai lebih besar dari 0): Memulai transkoding pada detik ke-`n` dari file media.	0
Duration	number	No	Durasi media yang akan ditranskode, dalam detik. Nilai `0` (default) berarti transkoding berlangsung hingga akhir file.	0
Subtitles	array<object>	No	Daftar subtitle yang akan ditambahkan. Parameter ini kosong secara default.
	object	No	Informasi subtitle.
URI	string	No	URI OSS dari file subtitle. URI harus dalam format `oss://${Bucket}/${Object}`, dengan `${Bucket}` adalah nama bucket OSS di wilayah yang sama dengan proyek, dan `${Object}` adalah path lengkap objek, termasuk ekstensi file. Format subtitle yang didukung meliputi `srt`, `vtt`, `mov_text`, `ass`, `dvd_sub`, dan `pgs`.	oss://test-bucket/test-object
TimeOffset	number	No	Offset waktu subtitle, dalam detik. Nilai default: `0`.	10.5
Language	string	No	Bahasa subtitle, ditentukan sebagai kode bahasa ISO 639-2. Parameter ini kosong secara default.	eng
Attached	boolean	No	Jika `true`, file media sumber ini ditambahkan ke output sebagai aliran audio atau video yang disinkronkan. Default: `false`. Catatan Anda tidak dapat mengatur `Attached` ke `true` untuk file sumber yang digunakan sebagai referensi penyelarasan (ditentukan oleh `AlignmentIndex`).	false
AlignMode	string	No	Kebijakan penyelarasan untuk aliran audio dan video yang ditambahkan. Nilai yang valid: `false` (default): Tidak ada penyelarasan. `loop`: Mengulang konten audio atau video agar durasinya selaras. `pad`: Menambahkan jeda diam (untuk audio) atau frame hitam (untuk video) agar durasinya cocok. Catatan Parameter ini hanya berlaku ketika `Attached` diatur ke `true`.	false
DisableVideo	boolean	No	Jika `true`, menonaktifkan aliran video dari sumber ini. Default: `false`. true: Dinonaktifkan. false (default): Diaktifkan.	false
DisableAudio	boolean	No	Jika `true`, menonaktifkan aliran audio dari sumber ini. Default: `false`. true: Dinonaktifkan. false (default): Diaktifkan.	false
Targets	array<object>	Yes	Daftar pekerjaan pemrosesan media. Anda dapat mengonfigurasi beberapa pekerjaan.
	array<object>	No	Menentukan satu pekerjaan pemrosesan media beserta output-nya.
URI	string	No	URI OSS dari file output hasil transkoding. URI harus dalam format `oss://${Bucket}/${Object}`, dengan `${Bucket}` adalah nama bucket OSS di wilayah yang sama dengan proyek, dan `${Object}` adalah path lengkap objek. Jika URI mencakup ekstensi file, semua file media output akan disimpan ke URI ini. Jika beberapa file dihasilkan, file-file tersebut akan saling menimpa. Jika URI tidak mencakup ekstensi file, URI output ditentukan oleh parameter URI, Container, dan Segment. Misalnya, jika URI adalah `oss://examplebucket/outputVideo`: Jika Container adalah `mp4` dan Segment tidak diatur, file output disimpan ke `oss://examplebucket/outputVideo.mp4`. Jika Container adalah `ts` dan `Format` dalam Segment adalah `hls`, file M3U8 dihasilkan di `oss://examplebucket/outputVideo.m3u8`, bersama beberapa file TS yang memiliki awalan `oss://examplebucket/outputVideo`.	oss://test-bucket/test-target-object.mp4
Container	string	No	Kontainer media untuk file output. Kontainer yang didukung meliputi: Kontainer audio/video: `mp4`, `mkv`, `mov`, `asf`, `avi`, `mxf`, `ts`, `flv` Kontainer audio saja: `mp3`, `aac`, `flac`, `oga`, `ac3`, `opus` Penting `Container` dan `URI` harus ditentukan bersamaan. Untuk melakukan tugas seperti ekstraksi subtitle, penangkapan frame, atau pembuatan gambar animasi, abaikan kedua parameter `Container` dan `URI`. Saat parameter ini diabaikan, tidak ada kontainer media yang dibuat, dan parameter `Segment`, `Video`, `Audio`, serta `Speed` diabaikan.	mp4
Speed	number	No	Pengaturan kecepatan pemutaran untuk media output. Nilai yang valid: [0.5, 1.0]. Nilai default: `1.0`. Catatan Parameter ini menetapkan flag metadata untuk kecepatan pemutaran; tidak melakukan re-encode media ke kecepatan berbeda (proses yang dikenal sebagai speed transcoding).	1.0
Segment	object	No	Pengaturan untuk segmentasi media. Secara default, segmentasi media dinonaktifkan.
Format	string	No	Metode segmentasi media. Nilai yang valid: `hls` `dash`	hls
Duration	number	No	Durasi tiap segmen, dalam detik.	30
StartNumber	integer	No	Nomor urut awal untuk segmen. Parameter ini hanya berlaku untuk HLS. Nilai default: `0`.	5
Video	TargetVideo	No	Parameter pemrosesan video. Penting Jika parameter ini diabaikan, aliran video pertama diteruskan ke output tanpa transkoding.
Audio	TargetAudio	No	Parameter pemrosesan audio. Penting Jika parameter ini diabaikan, aliran audio pertama diteruskan ke output tanpa transkoding.
Subtitle	TargetSubtitle	No	Parameter pemrosesan subtitle. Penting Jika parameter ini diabaikan, aliran subtitle pertama diteruskan ke output.
Image	TargetImage	No	Konfigurasi untuk penangkapan frame, penangkapan sprite sheet, dan pembuatan gambar animasi.
StripMetadata	boolean	No	Jika `true`, menghapus metadata (seperti `title` dan `album`) dari file output. Default: `false`.
Data	object	No
Stream	array	No
	integer	No
AttachedPicture	object	No
Stream	array	No
	integer	No
UserData	string	No	Data kustom yang dikembalikan dalam notifikasi asinkron. Anda dapat menggunakannya untuk mengaitkan notifikasi dengan logika bisnis Anda. Panjang maksimum: 2.048 byte.	{"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
Tags	object	No	Tag kustom yang dapat digunakan untuk mencari dan memfilter pekerjaan asinkron.	{"test":"val1"}
CredentialConfig	CredentialConfig	No	Parameter ini opsional dan hanya diperlukan untuk skenario kontrol akses lanjutan. Konfigurasi untuk role chaining. Untuk informasi selengkapnya, lihat Gunakan role chaining untuk mengakses sumber daya entitas lain.
Notification	Notification	No	Konfigurasi untuk notifikasi asinkron. Untuk informasi selengkapnya tentang objek ini, lihat tipe data Notification. Untuk format pesan notifikasi asinkron, lihat Format pesan notifikasi asinkron.
AlignmentIndex	integer	No	Saat menggabungkan file media, parameter ini menentukan indeks file media utama dalam daftar. File utama menyediakan parameter transkoding default (seperti resolusi dan laju frame) dari aliran `Video` dan `Audio`-nya. Nilai default adalah `0`, yang merujuk ke file media pertama dalam daftar `Sources`.	0

Elemen respons

Element	Type	Description	Example
	object	Objek 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.