GetTranscodeJob - Intelligent Media Services - Alibaba Cloud Documentation Center

Mengkueri detail satu pekerjaan transkoding.

Deskripsi operasi

Operasi API ini akan segera dihentikan penggunaannya. Panggil GetMediaConvertJob - Mengkueri Pekerjaan transkoding media.

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

ice:GetTranscodeJob

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ParentJobId	string	Yes	ID pekerjaan.	ab4802364a2e49208c99efab82dfa8e8

Elemen respons

Element	Type	Description	Example
	object	Hasil tanggapan.
RequestId	string	ID permintaan.	9EDC30DC-0050-5459-B788-F761B2BE359B
TranscodeParentJob	object	TranscodeParentJobWithSubJobDTO.
TranscodeJobList	array<object>	Daftar pekerjaan anak.
	array<object>	Pekerjaan anak.
CreateTime	string	Pengatur waktu pembuatan pekerjaan. Pengatur waktu dalam format ISO 8601 dan ditampilkan dalam UTC (berakhiran Z).	2022-01-12T08:49:41Z
Name	string	Nama pekerjaan.	transcode-job
ParentJobId	string	ID pekerjaan induk.	8b2198504dd340b7b3c9842a74fc9baa
JobId	string	ID pekerjaan anak.	7d6a7e0d4db2457a8d45ff5d43e1bf0a
JobIndex	integer	Indeks pekerjaan anak dalam seluruh pekerjaan.	0
InputGroup	array<object>	Kelompok input pekerjaan. Satu input menunjukkan pekerjaan transkoding. Beberapa input menunjukkan pekerjaan penggabungan aliran audio dan aliran video.
	object	Input pekerjaan.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika Type adalah OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP. Jika Type adalah Media, nilai berupa ID aset media.	oss://bucket/path/to/video.mp4
InputUrl	string	URL aliran aset media. Tentukan parameter ini hanya saat Anda mentranskode aliran aset media.	oss://bucket/path/to/video.mp4
ProcessConfig	object	Konfigurasi pemrosesan transkoding.
Transcode	object	Konfigurasi transcoding.
TemplateId	string	ID Template.	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	Parameter override. Jika ditentukan, parameter ini akan menggantikan parameter template yang sesuai.
Video	object	Pengaturan video.
Codec	string	Format encoding.	H.264
Profile	string	Profil encoding. Nilai yang didukung: baseline, main, high. baseline: untuk perangkat seluler. main: untuk perangkat resolusi standar. high: untuk perangkat resolusi tinggi. Nilai default: high.	Main
Bitrate	string	Bitrate rata-rata video. Rentang valid: [10, 50000]. Unit: Kbps.	3000
Crf	string	Faktor kontrol kualitas bitrate. Rentang valid: [0, 51]. Nilai default: 23 untuk H.264, 26 untuk H.265. Jika Crf diatur, pengaturan Bitrate akan diabaikan.	23
Width	string	Lebar. Rentang valid: [128, 4096]. Unit: px. Nilai default: lebar video asli.	1920
Height	string	Tinggi. Rentang valid: [128, 4096]. Unit: px. Nilai default: tinggi video asli.	1080
Fps	string	Frame rate. Rentang valid: (0, 60]. Jika frame rate file input melebihi 60, gunakan 60. Nilai default: frame rate file input.	25
Gop	string	Jumlah maksimum frame antara keyframe. Rentang valid: [1, 1080000]. Nilai default: 250.	250
Preset	string	Preset encoder video. Parameter ini hanya didukung untuk H.264. Nilai yang didukung: veryfast, fast, medium, slow, slower. Nilai default: medium.	medium
ScanMode	string	Mode pemindaian. Nilai yang didukung: interlaced, progressive.	progressive
PixFmt	string	Format warna video. Nilai yang valid: yuv420p, yuvj420p, dan format warna standar lainnya.	yuv420p
Remove	string	Apakah akan menghapus video.	false
Crop	string	Pemotongan video. Dua metode didukung: Deteksi dan potong black bar secara otomatis dengan mengatur parameter ini ke "border". Pemotongan kustom dalam format: width:height:left:top.	1280:800:0:140
Pad	string	Menambahkan black bar ke video dalam format: width:height:left:top.	1280:800:0:140
LongShortMode	string	Apakah akan mengaktifkan rotasi otomatis (mode sisi panjang-pendek).	false
Bufsize	string	Ukuran buffer: Rentang valid: [1000, 128000]. Nilai default: 6000. Unit: Kb.	6000
Maxrate	string	Bitrate puncak video: Rentang valid: [10, 50000]. Unit: Kbps.	9000
AbrMax	string	Bitrate ABR maksimum (hanya berlaku untuk narrow-high 1): Rentang valid: [10, 50000]. Unit: Kbps.	6000
Audio	object	Pengaturan audio.
Codec	string	Format codec audio: AAC, MP3, VORBIS, FLAC. Nilai default: AAC.	AAC
Profile	string	Preset encoding audio. Ketika Codec adalah AAC, nilai yang valid adalah aac_low, aac_he, aac_he_v2, aac_ld, aac_eld.	aac_low
Samplerate	string	Sample rate. Nilai yang didukung: 22050, 32000, 44100, 48000, 96000, Unit: Hz	44100
Bitrate	string	Bitrate audio file output. Rentang valid: [8, 1000] Unit: Kbps Nilai default: 128	128
Channels	string	Jumlah saluran suara. Nilai default: 2	2
Remove	string	Apakah akan menghapus stream audio.	false
Volume	object	Kontrol volume.
Method	string	Metode penyesuaian volume.	auto
IntegratedLoudnessTarget	string	Volume target.	-6
TruePeak	string	Volume puncak.	-1
LoudnessRangeTarget	string	Rentang volume.	8
Container	object	Pengaturan format container.
Format	string	Format container.	mp4
MuxConfig	object	Pengaturan muxing.
Segment	object	Pengaturan segmentasi.
Duration	string	Durasi segmen.	10
ForceSegTime	string	Titik waktu segmentasi paksa.	2,3
TransConfig	object	Parameter transcoding bersyarat.
TransMode	string	Mode transcoding video. Nilai yang valid: onepass: umumnya digunakan untuk ABR. Encoding lebih cepat dari twopass. twopass: umumnya digunakan untuk VBR. Encoding lebih lambat dari onepass. CBR: mode bitrate konstan. Nilai default: onepass.	onepass
IsCheckReso	string	Apakah akan memeriksa resolusi video. IsCheckReso dan IsCheckResoFail bersifat saling eksklusif. IsCheckResoFail lebih diutamakan. true: Periksa. Jika resolusi video input (lebar atau tinggi) lebih kecil dari pengaturan output, transcoding menggunakan resolusi video input. false: Jangan periksa. Nilai default: false.	true
IsCheckResoFail	string	Apakah akan memeriksa resolusi video. IsCheckReso dan IsCheckResoFail bersifat saling eksklusif. Parameter ini lebih diutamakan. true: Periksa. Jika resolusi video input (lebar atau tinggi) lebih kecil dari pengaturan output, kembalikan kegagalan transcoding. false: Jangan periksa. Nilai default: false.	true
IsCheckVideoBitrate	string	Apakah akan memeriksa bitrate video. IsCheckVideoBitrate dan IsCheckVideoBitrateFail bersifat saling eksklusif. IsCheckVideoBitrateFail lebih diutamakan. true: Periksa. Jika bitrate video input lebih rendah dari pengaturan output, transcoding menggunakan bitrate video input. false: Jangan periksa. Nilai default: false.	true
IsCheckVideoBitrateFail	string	Apakah akan memeriksa bitrate video. IsCheckVideoBitrate dan IsCheckVideoBitrateFail bersifat saling eksklusif. Parameter ini lebih diutamakan. true: Periksa. Jika bitrate video input lebih rendah dari pengaturan output, kembalikan kegagalan transcoding. false: Jangan periksa. Nilai default: false.	true
IsCheckAudioBitrate	string	Apakah akan memeriksa bitrate audio. IsCheckAudioBitrate dan IsCheckAudioBitrateFail bersifat saling eksklusif. IsCheckAudioBitrateFail lebih diutamakan. true: Periksa. Jika bitrate audio input lebih rendah dari pengaturan output, transcoding menggunakan bitrate audio input. false: Jangan periksa. Nilai default: Jika parameter ini kosong dan codec berbeda dari sumber input: false. Jika parameter ini kosong dan codec sama dengan sumber input: true.	true
IsCheckAudioBitrateFail	string	Apakah akan memeriksa bitrate audio. IsCheckAudioBitrate dan IsCheckAudioBitrateFail bersifat saling eksklusif. Parameter ini lebih diutamakan. true: Periksa. Jika bitrate audio input lebih rendah dari pengaturan output, kembalikan kegagalan transcoding. false: Jangan periksa. Nilai default: false.	true
AdjDarMethod	string	Metode penyesuaian resolusi. Parameter ini hanya berlaku jika Width dan Height keduanya ditentukan. Dapat digunakan bersama dengan LongShortMode. Nilai yang valid: rescale, crop, pad, none. Nilai default: none. Contoh: Lihat cara mengatur resolusi.	none
Tags	object
	string
ImageWatermarks	array<object>	Konfigurasi watermark gambar.
	array<object>	Konfigurasi watermark gambar.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini menimpa parameter yang sesuai di templat.
Width	string	Lebar.	32
Height	string	Tinggi.	32
Dx	string	Koordinat X posisi watermark.	10
Dy	string	Koordinat Y posisi watermark.	10
ReferPos	string	Posisi referensi. Nilai valid: TopLeft, TopRight, BottomLeft, dan BottomRight. Nilai default: TopLeft.	TopLeft
Timeline	object	Pengaturan pengatur waktu tampilan.
Start	string	Pengatur waktu mulai.	00:00:05
Duration	string	Durasi tampilan dalam detik atau ToEND.	ToEND
File	object	File gambar watermark.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika type diatur ke OSS, nilainya adalah URL yang mendukung protokol OSS dan HTTP. Jika type diatur ke Media, nilainya adalah ID aset media.	oss://bucket/path/to/video.mp4
TextWatermarks	array<object>	Konfigurasi watermark teks.
	array<object>	Konfigurasi watermark teks.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini menimpa parameter yang sesuai di templat.
Content	string	Teks watermark. Pengodean Base64 tidak diperlukan. String harus dienkode dalam UTF-8.	test watermark
FontName	string	Font.	SimSun
FontColor	string	Warna.	#006400
FontAlpha	string	Transparansi.	1.0
Top	string	Jarak dari tepi atas untuk posisi watermark.	10
Left	string	Jarak dari tepi kiri untuk posisi watermark.	10
FontSize	integer	Ukuran font.	16
BorderWidth	integer	Lebar border.	0
BorderColor	string	Warna border.	#006400
Adaptive	string	Apakah akan menyesuaikan ukuran font berdasarkan ukuran video keluaran. Nilai valid: true dan false. Nilai default: false.	false
Subtitles	array<object>	Konfigurasi burn-in subtitle.
	array<object>	Konfigurasi burn-in subtitle.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini menimpa parameter yang sesuai di templat.
Format	string	Format file subtitle.	vtt
CharEnc	string	Format encoding file.	UTF-8
File	object	File subtitle.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika tipe adalah OSS, nilai berupa URL. Protokol OSS dan HTTP didukung. Jika tipe adalah Media, nilai berupa ID aset media.	oss://bucket/path/to/video.mp4
Encryption	object	Konfigurasi enkripsi.
EncryptType	string	Tipe enkripsi.	PrivateEncryption
CipherText	string	Ciphertext kunci enkripsi standar.	MTYi00NDU0LTg5O****
DecryptKeyUri	string	URL layanan dekripsi untuk enkripsi standar.	https://sample.com/path?CipherText=MTYi00NDU0LTg5O****
KeyServiceType	string	Tipe layanan kunci. Hanya KMS dan Base64 yang didukung.	KMS
CombineConfigs	array<object>	Konfigurasi pencampuran aliran multi-input.
	object
AudioIndex	string	Indeks aliran audio.	0 or exclude
VideoIndex	string	Indeks aliran video.	0 or exclude
Start	number	Waktu mulai aliran input. Nilai default: 0.	0.0
Duration	number	Durasi aliran input. Nilai default: durasi video.	20.0
IsInheritTags	boolean	Apakah akan mewarisi tag dari aliran input. Parameter ini tidak berlaku jika input bukan aset media. Nilai default: false.	true
Output	object	Konfigurasi media keluaran.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika tipe adalah OSS, nilai berupa URL. Protokol OSS dan HTTP didukung. Jika tipe adalah Media, nilai berupa ID aset media.	oss://bucket/path/to/video.mp4
OutputUrl	string	URL aliran keluaran hasil transkoding. Parameter ini hanya diperlukan ketika keluaran adalah aliran aset media.	oss://bucket/path/to/{MediaId}/{JobId}.mp4
UserData	string	Data pengguna.	user-data
ScheduleConfig	object	Informasi penjadwalan pekerjaan.
PipelineId	string	ID pipeline.	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	Prioritas pekerjaan. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Nilai valid: 1 hingga 10.	5
Status	string	Status pekerjaan transkoding. Nilai valid: Init: Dikirim. Processing: Transkoding. Success: Transkoding berhasil. Fail: Transkoding gagal. Deleted: Dihapus.	Init
OutFileMeta	object	Informasi media video yang dihasilkan.
FileBasicInfo	object	Informasi dasar file.
MediaId	string	ID aset media.	486c2890096871edba6f81848c016303
FileName	string	Nama file.	file.m3u8
FileStatus	string	Status file.	Normal
FileType	string	Tipe file. Nilai valid: source_file dan transcode_file.	source_file
FileSize	string	Ukuran file. Unit: bytes.	31737
FileUrl	string	URL file.	http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8
Region	string	Wilayah tempat file berada.	cn-shanghai
FormatName	string	Nama format video.	hls,applehttp
Duration	string	Durasi video, dalam detik.	403.039999
Bitrate	string	Bitrate video.	888.563
Width	string	Lebar.	848
Height	string	Tinggi.	478
AudioStreamInfoList	array<object>	Informasi aliran audio.
	object	Informasi aliran audio.
Index	string	Indeks aliran.	1
CodecName	string	Format encoding.	aac
CodecLongName	string	Nama panjang Kodek.	AAC (Advanced Audio Coding)
CodecTimeBase	string	Basis waktu Kodek.	1/44100
CodecTagString	string	String tag Kodek.	[15][0][0][0]
CodecTag	string	Tag Kodek.	0x000f
SampleFmt	string	Format sampel.	fltp
SampleRate	string	Laju sampel, dalam Hz.	44100
Channels	string	Jumlah saluran audio.	2
ChannelLayout	string	Tata letak saluran.	stereo
Timebase	string	Basis waktu.	1/90000
StartTime	string	Waktu mulai, dalam detik.	1.473556
Duration	string	Durasi, dalam detik.	403.039989
Bitrate	string	Bitrate.	0.f
Lang	string	Bahasa.	cn
VideoStreamInfoList	array<object>	Informasi aliran video.
	object	Informasi aliran video.
Index	string	Indeks aliran.	0
Codec_name	string	Format encoding.	h264
Codec_long_name	string	Nama panjang Kodek.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	Profil penyandi.	High
Codec_time_base	string	Basis waktu Kodek.	1/50
Codec_tag_string	string	String tag format Kodek.	[27][0][0][0]
Codec_tag	string	Tag format Kodek.	0x001b
Width	string	Lebar.	848
Height	string	Tinggi.	478
Has_b_frames	string	Apakah B-frame ada. Nilai valid: 0: Tidak ada B-frame. 1: Satu B-frame. 2: Beberapa B-frame berurutan.	2
Sar	string	Rasio aspek sampel.	478:477
Dar	string	Rasio aspek tampilan.	16:9
PixFmt	string	Format piksel.	yuv420p
Level	string	Level pengkodean.	31
Fps	string	Laju frame.	25.0
Avg_fps	string	Laju frame rata-rata.	25.0
Time_base	string	Basis pengatur waktu.	1/90000
Start_time	string	Pengatur waktu mulai, dalam detik.	1.473556
Duration	string	Durasi, dalam detik.	403.039989
Bit_rate	string	Bitrate.	888.563
NumFrames	string	Jumlah total frame.	10040
Lang	string	Bahasa.	cn
Rotate	string	Sudut rotasi video. Nilai valid: 0, 90, 180, dan 270. Nilai default: 0.	0
SubmitResultJson	object	Hasil pengiriman pekerjaan.	{}
SubmitTime	string	Pengatur waktu pengiriman pekerjaan. Pengatur waktu dalam format ISO 8601 dan menggunakan UTC (berakhiran Z).	2022-01-12T08:49:41Z
FinishTime	string	Pengatur waktu penyelesaian pekerjaan. Pengatur waktu dalam format ISO 8601 dan menggunakan UTC (berakhiran Z).	2022-01-12T08:49:41Z
RequestId	string	ID permintaan untuk pengiriman pekerjaan.	31E30781-9495-5E2D-A84D-759B0A01E262
CreateTime	string	Pengatur waktu pembuatan pekerjaan. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-01-12T08:49:41Z
Name	string	Nama pekerjaan.	transcode-job
RequestId	string	ID permintaan untuk pengiriman pekerjaan.	31E30781-9495-5E2D-A84D-759B0A01E262
ParentJobId	string	ID pekerjaan induk.	8b2198504dd340b7b3c9842a74fc9baa
JobCount	integer	Jumlah pekerjaan turunan.	1
Status	string	Status pekerjaan. Nilai valid: Success: Pekerjaan berhasil jika setidaknya satu pekerjaan turunan berhasil setelah semua pekerjaan turunan selesai. Fail: Semua pekerjaan turunan gagal.	Success
TriggerSource	string	Sumber pekerjaan. Nilai valid: API: API. WorkFlow: Workflow. Console: Console.	API
Percent	integer	Persentase penyelesaian pekerjaan.	0
SubmitTime	string	Pengatur waktu pengiriman pekerjaan. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-01-12T08:49:41Z
FinishTime	string	Pengatur waktu penyelesaian pekerjaan. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-01-12T08:49:41Z
InputGroup	array<object>	Kelompok input pekerjaan. Satu input menunjukkan pekerjaan transkoding. Beberapa input menunjukkan pekerjaan penggabungan aliran audio dan aliran video.
	object	Input pekerjaan.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika tipe adalah OSS, nilai berupa URL. Protokol OSS dan HTTP didukung. Jika tipe adalah Media, nilai berupa ID aset media.	oss://bucket/path/to/video.mp4
OutputGroup	array<object>	Kelompok output pekerjaan.
	array<object>	Output pekerjaan.
Output	object	Konfigurasi media keluaran.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika tipe adalah OSS, nilai berupa URL. Protokol OSS dan HTTP didukung. Jika tipe adalah Media, nilai berupa ID aset media.	oss://bucket/path/to/video.mp4
OutputUrl	string	URL aliran output.	oss://bucket/path/to/video.mp4
ProcessConfig	object	Konfigurasi pemrosesan pekerjaan.
Transcode	object	Konfigurasi transkoding.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini menimpa parameter yang sesuai di templat.
Video	object	Pengaturan video.
Codec	string	Format encoding.	H.264
Profile	string	Profil pengkodean. Nilai valid: garis dasar: Untuk perangkat shift. main: Untuk perangkat resolusi standar. high: Untuk perangkat resolusi tinggi. Nilai default: high.	Main
Bitrate	string	Bitrate video rata-rata. Nilai valid: 10 hingga 50000. Unit: Kbps.	3000
Crf	string	Faktor laju konstan (CRF) untuk kontrol kualitas-bitrate. Nilai valid: 0 hingga 51. Nilai default: 23 untuk H264, dan 26 untuk H265. Jika Crf ditentukan, pengaturan Bitrate menjadi tidak valid.	23
Width	string	Lebar. Nilai valid: 128 hingga 4096. Unit: piksel. Nilai default: Lebar asli video.	1920
Height	string	Tinggi. Nilai valid: 128 hingga 4096. Unit: piksel. Nilai default: Tinggi asli video.	1080
Fps	string	Laju frame. Nilai valid: (0, 60]. Jika laju frame file input melebihi 60, nilai diatur menjadi 60. Nilai default: laju frame file input.	25
Gop	string	Jumlah maksimum frame antar keyframe. Nilai valid: 1 hingga 1080000. Nilai default: 250.	250
Preset	string	Preset untuk algoritma video. Parameter ini hanya didukung oleh H264. Nilai valid: veryfast, fast, Menengah, slow, dan slower. Nilai default: Menengah.	medium
ScanMode	string	Mode pemindaian. Nilai valid: interlaced dan progressive.	progressive
PixFmt	string	Format warna video. Nilai valid: format warna standar seperti yuv420p dan yuvj420p.	yuv420p
Remove	string	Apakah akan menghapus video.	false
Crop	string	Pengaturan pemangkasan video. Dua metode didukung: Deteksi dan pemangkasan border hitam secara otomatis. Atur nilai menjadi border. Pemangkasan kustom. Format parameter: width:height:left:top. Contoh: 1280:800:0:140.	1280:800:0:140
Pad	string	Parameter padding video untuk border hitam. Format: width:height:left:top. Contoh: 1280:800:0:140.	1280:800:0:140
LongShortMode	string	Apakah akan mengaktifkan mode lanskap dan potret adaptif (mode sisi panjang-pendek).	false
Bufsize	string	Ukuran buffer. Nilai valid: 1000 hingga 128000. Nilai default: 6000. Unit: Kb.	6000
Maxrate	string	bitrate video puncak. Nilai valid: 10 hingga 50000. Unit: Kbps.	9000
AbrMax	string	bitrate ABR maksimum. Parameter ini hanya valid untuk Narrowband HD 1.0. Nilai valid: 10 hingga 50000. Unit: Kbps.	6000
Audio	object	Pengaturan audio.
Codec	string	Format kodek audio. Nilai valid: AAC, MP3, VORBIS, dan FLAC. Nilai default: AAC.	AAC
Profile	string	Preset pengkodean audio. Ketika Codec diatur ke AAC, nilai valid adalah aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld.	aac_low
Samplerate	string	Laju pengambilan sampel. Nilai default: 44100. Nilai valid: 22050, 32000, 44100, 48000, dan 96000. Unit: Hz.	44100
Bitrate	string	bitrate audio file output. Nilai valid: 8 hingga 1000. Unit: Kbit/s. Nilai default: 128.	128
Channels	string	Jumlah saluran audio. Nilai default: 2.	2
Remove	string	Apakah akan menghapus aliran audio.	false
Volume	object	Pengaturan kontrol volume.
Method	string	Metode penyesuaian volume.	auto
IntegratedLoudnessTarget	string	Target volume.	-6
TruePeak	string	Volume puncak.	-1
LoudnessRangeTarget	string	Rentang kenyaringan.	8
Container	object	Pengaturan format kontainer.
Format	string	Format kontainer.	mp4
MuxConfig	object	Pengaturan muxing.
Segment	object	Pengaturan segmentasi.
Duration	string	Durasi segmen.	10
ForceSegTime	string	Pengatur waktu segmentasi paksa.	2,3
TransConfig	object	Parameter transkoding bersyarat.
TransMode	string	Mode transkoding video. Nilai valid: onepass: Biasanya digunakan untuk ABR. Kecepatan pengkodean lebih cepat daripada twopass. twopass: Biasanya digunakan untuk VBR. Kecepatan pengkodean lebih lambat daripada onepass. CBR: Mode bitrate konstan. Nilai default: onepass.	onepass
IsCheckReso	string	Apakah akan memeriksa resolusi video. Anda hanya dapat menentukan salah satu dari IsCheckReso dan IsCheckResoFail. IsCheckResoFail memiliki prioritas lebih tinggi. Nilai valid: true: Periksa. Jika lebar atau tinggi resolusi video input lebih kecil dari pengaturan keluaran, resolusi video input digunakan untuk transkoding. false: Jangan periksa. Nilai default: false.	true
IsCheckResoFail	string	Apakah akan memeriksa resolusi video. Anda hanya dapat menentukan salah satu dari IsCheckReso dan IsCheckResoFail. Parameter ini memiliki prioritas lebih tinggi. Nilai valid: true: Periksa. Jika lebar atau tinggi resolusi video input lebih kecil dari pengaturan keluaran, kegagalan transkoding dikembalikan. false: Jangan periksa. Nilai default: false.	true
IsCheckVideoBitrate	string	Apakah akan memeriksa laju bit video. Anda hanya dapat menentukan salah satu dari IsCheckVideoBitrate dan IsCheckVideoBitrateFail. IsCheckVideoBitrateFail memiliki prioritas lebih tinggi. Nilai valid: true: Periksa. Jika laju bit video input lebih rendah dari pengaturan output, laju bit video input digunakan untuk transkoding. false: Jangan periksa. Nilai default: false.	true
IsCheckVideoBitrateFail	string	Apakah akan memeriksa laju bit video. Anda hanya dapat menentukan salah satu dari IsCheckVideoBitrate dan IsCheckVideoBitrateFail. Parameter ini memiliki prioritas lebih tinggi. Nilai valid: true: Periksa. Jika laju bit video input lebih rendah dari pengaturan output, kegagalan transkoding dikembalikan. false: Jangan periksa. Nilai default: false.	true
IsCheckAudioBitrate	string	Apakah akan memeriksa laju bit audio. Anda hanya dapat menentukan salah satu dari IsCheckAudioBitrate dan IsCheckAudioBitrateFail. IsCheckAudioBitrateFail memiliki prioritas lebih tinggi. Nilai valid: true: Periksa. Jika laju bit audio input lebih rendah dari pengaturan output, laju bit audio input digunakan untuk transkoding. false: Jangan periksa. Nilai default: Jika parameter kosong dan Kodek berbeda dari sumber input: false. Jika parameter kosong dan Kodek sama dengan sumber input: true.	true
IsCheckAudioBitrateFail	string	Apakah akan memeriksa laju bit audio. Anda hanya dapat menentukan salah satu dari IsCheckAudioBitrate dan IsCheckAudioBitrateFail. Parameter ini memiliki prioritas lebih tinggi. Nilai valid: true: Periksa. Jika laju bit audio input lebih rendah dari pengaturan output, kegagalan transkoding dikembalikan. false: Jangan periksa. Nilai default: false.	true
AdjDarMethod	string	Metode penyesuaian resolusi. Parameter ini hanya berlaku jika Width dan Height ditentukan. Dapat digunakan bersama dengan LongShortMode. Nilai valid: rescale, crop, pad, dan none. Nilai default: none.	none
ImageWatermarks	array<object>	Konfigurasi watermark gambar.
	array<object>	Konfigurasi watermark gambar.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini menimpa parameter yang sesuai di templat.
Width	string	Lebar.	32
Height	string	Tinggi.	32
Dx	string	Koordinat X posisi watermark.	10
Dy	string	Koordinat Y posisi watermark.	10
ReferPos	string	Posisi referensi. Nilai valid: TopLeft, TopRight, BottomLeft, dan BottomRight. Nilai default: TopLeft.	TopLeft
Timeline	object	Pengaturan pengatur waktu tampilan.
Start	string	Pengatur waktu mulai.	00:00:05
Duration	string	Durasi tampilan dalam detik atau ToEND.	ToEND
File	object	File gambar watermark.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika tipe adalah OSS, nilainya adalah URL yang mendukung protokol OSS dan HTTP. Jika tipe adalah Media, nilainya adalah ID aset media.	oss://bucket/path/to/video.mp4
TextWatermarks	array<object>	Konfigurasi watermark teks.
	array<object>	Konfigurasi watermark teks.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini menimpa parameter yang sesuai di templat.
Content	string	Teks watermark. Pengodean Base64 tidak diperlukan. String harus dienkode dalam UTF-8.	test watermark
FontName	string	Font.	SimSun
FontColor	string	Warna.	#006400
FontAlpha	string	Transparansi.	1.0
Top	string	Jarak dari tepi atas untuk posisi watermark.	10
Left	string	Jarak dari tepi kiri untuk posisi watermark.	10
FontSize	integer	Ukuran font.	16
BorderWidth	integer	Lebar border.	0
BorderColor	string	Warna border.	#006400
Adaptive	string	Apakah akan menyesuaikan ukuran font berdasarkan ukuran video keluaran. Nilai valid: true dan false. Nilai default: false.	false
Subtitles	array<object>	Konfigurasi burn-in subtitle.
	array<object>	Konfigurasi burn-in subtitle.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18d410
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini menimpa parameter yang sesuai di templat.
Format	string	Format file subtitle.	vtt
CharEnc	string	Format encoding file.	UTF-8
File	object	File subtitle.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika tipe adalah OSS, nilainya adalah URL yang mendukung protokol OSS dan HTTP. Jika tipe adalah Media, nilainya adalah ID aset media.	oss://bucket/path/to/video.mp4
Encryption	object	Konfigurasi enkripsi.
EncryptType	string	Tipe enkripsi.	PrivateEncryption
CipherText	string	Ciphertext kunci enkripsi standar.	MTYi00NDU0LTg5O****
DecryptKeyUri	string	URL layanan dekripsi untuk enkripsi standar.	https://sample.com/path?CipherText=MTYi00NDU0LTg5O****
KeyServiceType	string	Tipe layanan kunci. Hanya KMS dan Base64 yang didukung.	KMS
CombineConfigs	array<object>	Konfigurasi pencampuran aliran multi-input.
	object	Konfigurasi pencampuran aliran multi-input.
AudioIndex	string	Indeks aliran audio.	0 or exclude
VideoIndex	string	Indeks aliran video.	0 or exclude
Start	number	Pengatur waktu mulai aliran input. Nilai default: 0.	0.0
Duration	number	Durasi aliran input. Nilai default: durasi video.	20.0
UserData	string	Data pengguna.	user-data
ScheduleConfig	object	Konfigurasi penjadwalan pekerjaan.
PipelineId	string	ID pipeline.	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	Prioritas pekerjaan. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Nilai valid: 1 hingga 10.	5

Contoh

Respons sukses

JSONformat

{
  "RequestId": "9EDC30DC-0050-5459-B788-F761B2BE359B",
  "TranscodeParentJob": {
    "TranscodeJobList": [
      {
        "CreateTime": "2022-01-12T08:49:41Z",
        "Name": "transcode-job",
        "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
        "JobId": "7d6a7e0d4db2457a8d45ff5d43e1bf0a",
        "JobIndex": 0,
        "InputGroup": [
          {
            "Type": "OSS",
            "Media": "oss://bucket/path/to/video.mp4",
            "InputUrl": "oss://bucket/path/to/video.mp4"
          }
        ],
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              },
              "TransConfig": {
                "TransMode": "onepass",
                "IsCheckReso": "true",
                "IsCheckResoFail": "true",
                "IsCheckVideoBitrate": "true",
                "IsCheckVideoBitrateFail": "true",
                "IsCheckAudioBitrate": "true",
                "IsCheckAudioBitrateFail": "true",
                "AdjDarMethod": "none"
              },
              "Tags": {
                "key": ""
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "test watermark",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "Encryption": {
            "EncryptType": "PrivateEncryption",
            "CipherText": "MTYi00NDU0LTg5O****",
            "DecryptKeyUri": "https://sample.com/path?CipherText=MTYi00NDU0LTg5O****",
            "KeyServiceType": "KMS"
          },
          "CombineConfigs": [
            {
              "AudioIndex": "0 or exclude",
              "VideoIndex": "0 or exclude",
              "Start": 0,
              "Duration": 20
            }
          ],
          "IsInheritTags": true
        },
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4",
          "OutputUrl": "oss://bucket/path/to/{MediaId}/{JobId}.mp4\n"
        },
        "UserData": "user-data",
        "ScheduleConfig": {
          "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
          "Priority": 5
        },
        "Status": "Init",
        "OutFileMeta": {
          "FileBasicInfo": {
            "MediaId": "486c2890096871edba6f81848c016303",
            "FileName": "file.m3u8",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "31737",
            "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
            "Region": "cn-shanghai",
            "FormatName": "hls,applehttp",
            "Duration": "403.039999",
            "Bitrate": "888.563",
            "Width": "848",
            "Height": "478"
          },
          "AudioStreamInfoList": [
            {
              "Index": "1",
              "CodecName": "aac",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "CodecTimeBase": "1/44100",
              "CodecTagString": "[15][0][0][0]",
              "CodecTag": "0x000f",
              "SampleFmt": "fltp",
              "SampleRate": "44100",
              "Channels": "2",
              "ChannelLayout": "stereo",
              "Timebase": "1/90000",
              "StartTime": "1.473556",
              "Duration": "403.039989",
              "Bitrate": "0.f",
              "Lang": "cn"
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "0",
              "Codec_name": "h264",
              "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
              "Profile": "High",
              "Codec_time_base": "1/50",
              "Codec_tag_string": "[27][0][0][0]",
              "Codec_tag": "0x001b",
              "Width": "848",
              "Height": "478",
              "Has_b_frames": "2",
              "Sar": "478:477",
              "Dar": "16:9",
              "PixFmt": "yuv420p",
              "Level": "31",
              "Fps": "25.0",
              "Avg_fps": "25.0",
              "Time_base": "1/90000",
              "Start_time": "1.473556",
              "Duration": "403.039989",
              "Bit_rate": "888.563",
              "NumFrames": "10040",
              "Lang": "cn",
              "Rotate": "0"
            }
          ]
        },
        "SubmitResultJson": {},
        "SubmitTime": "2022-01-12T08:49:41Z",
        "FinishTime": "2022-01-12T08:49:41Z",
        "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262"
      }
    ],
    "CreateTime": "2022-01-12T08:49:41Z",
    "Name": "transcode-job",
    "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
    "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
    "JobCount": 1,
    "Status": "Success",
    "TriggerSource": "API",
    "Percent": 0,
    "SubmitTime": "2022-01-12T08:49:41Z",
    "FinishTime": "2022-01-12T08:49:41Z",
    "InputGroup": [
      {
        "Type": "OSS",
        "Media": "oss://bucket/path/to/video.mp4"
      }
    ],
    "OutputGroup": [
      {
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4",
          "OutputUrl": "oss://bucket/path/to/video.mp4\n"
        },
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              },
              "TransConfig": {
                "TransMode": "onepass",
                "IsCheckReso": "true",
                "IsCheckResoFail": "true",
                "IsCheckVideoBitrate": "true",
                "IsCheckVideoBitrateFail": "true",
                "IsCheckAudioBitrate": "true",
                "IsCheckAudioBitrateFail": "true",
                "AdjDarMethod": "none"
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "test watermark",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "Encryption": {
            "EncryptType": "PrivateEncryption",
            "CipherText": "MTYi00NDU0LTg5O****",
            "DecryptKeyUri": "https://sample.com/path?CipherText=MTYi00NDU0LTg5O****",
            "KeyServiceType": "KMS"
          },
          "CombineConfigs": [
            {
              "AudioIndex": "0 or exclude",
              "VideoIndex": "0 or exclude",
              "Start": 0,
              "Duration": 20
            }
          ]
        }
      }
    ],
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    }
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.