Dokumen ini menjelaskan cara mengirimkan pekerjaan transkoding. Jika pekerjaan transkoding dan alur kerja yang dibuat di konsol ApsaraVideo Media Processing (MPS) tidak memenuhi kebutuhan bisnis Anda, Anda dapat memanggil operasi SubmitJobs untuk mengirimkan pekerjaan transkoding. Saat memanggil operasi ini, tentukan parameter transkoding sesuai kebutuhan.
Deskripsi operasi
SubmitJobs adalah operasi asinkron. Setelah pekerjaan transkoding dikirim, pekerjaan tersebut akan ditambahkan ke antrian MPS untuk dijadwalkan dan dijalankan. Pekerjaan transkoding mungkin belum selesai saat respons dikembalikan. Setelah memanggil operasi ini, Anda dapat menggunakan operasi QueryJobList untuk mengecek status pekerjaan. Anda juga dapat mengaitkan antrian atau topik Message Service (MNS) dengan antrian MPS guna menerima notifikasi terkait pekerjaan tersebut. Untuk informasi selengkapnya, lihat Receive notifications.
Ukuran file input dapat mencapai 100 GB. Jika melebihi batas ini, pekerjaan tersebut berisiko gagal.
Jika Anda menggunakan template preset cerdas untuk mentranskode file input, Anda harus terlebih dahulu memanggil operasi SubmitAnalysisJob guna mengirimkan pekerjaan analisis template preset. Setelah pekerjaan analisis selesai, panggil operasi QueryAnalysisJobList untuk mendapatkan daftar template preset yang tersedia untuk file input tersebut. Saat mengirimkan pekerjaan transkoding, atur TemplateId ke ID template preset yang tersedia. Jika Anda menentukan template preset yang tidak termasuk dalam daftar tersebut, pekerjaan transkoding akan gagal.
Jika Anda menggunakan template preset statis untuk mentranskode file input, Anda tidak perlu mengirimkan pekerjaan analisis template preset.
Jika ingin menggunakan beberapa akun di MPS, Anda dapat membuat pengguna Resource Access Management (RAM) melalui Akun Alibaba Cloud Anda. Untuk informasi selengkapnya, lihat Create a RAM user and grant permissions to the RAM user. Perlu diperhatikan bahwa jika Akun Alibaba Cloud yang digunakan untuk menanyakan status pekerjaan transkoding berbeda dari akun yang digunakan untuk mengirimkan pekerjaan tersebut, tidak ada data yang akan dikembalikan.
Untuk informasi mengenai FAQ transkoding, lihat FAQ about MPS.
Batas QPS
Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Permintaan yang melebihi batas ini akan dibuang dan dapat menyebabkan gangguan layanan. Pastikan Anda memperhatikan batas ini saat memanggil operasi. Untuk informasi selengkapnya, lihat QPS limits.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
mts:SubmitJobs |
create |
*全部资源
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| Input |
string |
Yes |
Informasi tentang file input. Untuk informasi selengkapnya, lihat bagian "Input" pada topik Parameter details. Catatan
|
{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "用户自行在OSS控制台设置的OSS防盗链参数"} |
| Outputs |
string |
Yes |
Konfigurasi output pekerjaan. Untuk informasi selengkapnya, lihat bagian "Output" pada topik Parameter details.
|
[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff****","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47****"}],"UserData":"testid-001"}] |
| OutputBucket |
string |
Yes |
Nama bucket OSS tempat menyimpan file output.
|
exampleBucket |
| OutputLocation |
string |
No |
Wilayah tempat bucket OSS yang menyimpan file output berada.
|
oss-cn-hangzhou |
| PipelineId |
string |
Yes |
ID antrian MPS. Untuk informasi selengkapnya, lihat Terms.
|
dd3dae411e704030b921e52698e5**** |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Parameter respons. |
||
| JobResultList |
object |
||
| JobResult |
array<object> |
Pekerjaan transkoding yang dihasilkan. |
|
|
array<object> |
|||
| Code |
string |
Kode kesalahan yang dikembalikan jika pekerjaan gagal dibuat. Parameter ini tidak dikembalikan jika pekerjaan berhasil dibuat. |
InvalidParameter.NullValue |
| Job |
object |
Detail pekerjaan. Jika pekerjaan gagal dikirimkan, ID pekerjaan tidak dihasilkan. |
|
| Code |
string |
Kode kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
InternalError |
| CreationTime |
string |
Waktu saat pekerjaan dibuat. |
2014-01-10T12:00:00Z |
| FinishTime |
string |
Waktu saat pekerjaan selesai. |
2014-01-10T12:20:00Z |
| Input |
object |
Informasi tentang input pekerjaan. |
|
| Bucket |
string |
Nama bucket OSS tempat input pekerjaan disimpan. |
example-bucket-**** |
| Location |
string |
ID wilayah OSS tempat input pekerjaan disimpan. |
oss-cn-hangzhou |
| Object |
string |
Nama objek OSS yang digunakan sebagai input pekerjaan. |
example.flv |
| JobId |
string |
ID pekerjaan. |
31fa3c9ca8134f9cec2b4b0b0f78**** |
| MNSMessageResult |
object |
Pesan yang dikirim oleh MNS untuk memberi tahu pengguna tentang hasil pekerjaan. |
|
| ErrorCode |
string |
Kode kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
InvalidParameter.ResourceNotFound |
| ErrorMessage |
string |
Pesan kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
The resource operated "%s" cannot be found. |
| MessageId |
string |
ID pesan kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
123 |
| Message |
string |
Pesan kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
The operation has failed due to some unknown error, exception or failure. |
| Output |
object |
Output pekerjaan. |
|
| AmixList |
object |
||
| Amix |
array<object> |
Track audio yang dicampur. |
|
|
object |
|||
| AmixURL |
string |
URL track audio yang dicampur sebagai musik latar.
|
https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3 |
| Duration |
string |
Durasi track audio yang dicampur. Nilainya dalam format angka atau waktu. |
20 |
| Map |
string |
Track audio yang dicampur. Format: 0:a:{audio_index}. Contoh: 0:a:0. |
0:a:0 |
| MixDurMode |
string |
Mode untuk menentukan durasi pencampuran. Nilai valid: first dan long.
|
long |
| Start |
string |
Waktu mulai. Nilainya dalam format angka atau waktu. Contoh: 1:25:36.240 dan 32000.23. |
0 |
| Audio |
object |
Konfigurasi audio. Catatan
Jika parameter ini ditentukan dalam permintaan, konfigurasi yang sesuai dalam template transkoding yang ditentukan akan ditimpa. |
|
| Bitrate |
string |
Bitrate audio file output.
|
128 |
| Channels |
string |
Jumlah saluran suara.
|
6 |
| Codec |
string |
Kodek audio.
|
aac |
| Profile |
string |
Profil codec audio. Catatan
Nilai valid jika nilai Codec adalah aac: aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld. |
aac_low |
| Qscale |
string |
Tingkat kontrol kualitas audio. |
15 |
| Samplerate |
string |
Laju pengambilan sampel.
Catatan
Jika format kontainer video adalah FLV dan kodek audio adalah MP3, nilai parameter ini tidak boleh 32000, 48000, atau 96000. Jika kodek audio adalah MP3, nilai parameter ini tidak boleh 96000. |
32000 |
| Volume |
object |
Konfigurasi volume. |
|
| Level |
string |
Rentang penyesuaian volume.
|
-20 |
| Method |
string |
Metode yang digunakan untuk menyesuaikan volume. Nilai valid:
|
auto |
| AudioStreamMap |
string |
Nomor urut stream audio.
|
0:a:0 |
| Clip |
object |
Informasi tentang klip. |
|
| TimeSpan |
object |
Rentang waktu klip. |
|
| Duration |
string |
Durasi klip.
|
01:00:59.999 |
| Seek |
string |
Waktu mulai.
|
01:59:59.999 |
| Container |
object |
Konfigurasi format kontainer. |
|
| Format |
string |
Format kontainer.
|
flv |
| DeWatermark |
string |
Konfigurasi efek buram watermark. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat bagian DeWatermark pada topik Parameter details. |
{"0": [{"l": 10,"t": 10,"w": 10,"h": 10},{"l": 100,"t": 0.1,"w": 10,"h": 10}],"128000": [],"250000": [{"l": 0.2,"t": 0.1,"w": 0.01,"h": 0.05}]} |
| DigiWaterMark |
object |
Watermark digital. |
|
| Alpha |
string |
Transparansi teks atau gambar.
|
1.0 |
| InputFile |
object |
Detail file input. |
|
| Bucket |
string |
Nama bucket OSS tempat file input disimpan. |
example-bucket-**** |
| Location |
string |
ID wilayah OSS tempat file input disimpan. |
oss-cn-hangzhou |
| Object |
string |
Nama objek OSS yang digunakan sebagai file input. |
example-intput.flv |
| Type |
string |
Jenis watermark. Jika parameter ini ditentukan dalam permintaan, parameter yang sesuai dalam template watermark akan ditimpa. Nilai valid:
|
Image |
| Encryption |
object |
Konfigurasi enkripsi. Hanya output dalam format M3U8 yang didukung. |
|
| Id |
string |
ID enkripsi. |
31fa3c9ca8134f9cec2b4b0b0f78**** |
| Key |
string |
Kunci yang digunakan untuk mengenkripsi video. |
encryptionkey128 |
| KeyType |
string |
Metode enkripsi kunci. Kunci tidak boleh dikirim ke MPS dalam bentuk teks biasa. Kunci harus dienkripsi menggunakan Base64 atau Key Management Service (KMS). Misalnya, jika kuncinya adalah encryptionkey128, Anda dapat mengenkripsi kunci tersebut dengan metode berikut: Base64("encryptionkey128") atau KMS(Base64("encryptionkey128"). |
Base64 |
| KeyUri |
string |
URL yang digunakan untuk meminta kunci. URL tersebut dienkripsi Base64. |
https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/ |
| SkipCnt |
string |
Jumlah frame yang tidak dienkripsi di awal video. Membiarkan frame-frame ini tidak dienkripsi memungkinkan pemutaran video dimulai dengan cepat. |
3 |
| Type |
string |
Jenis enkripsi. Hanya hls-aes-128 yang mungkin dikembalikan. |
hls-aes-128 |
| M3U8NonStandardSupport |
object |
Konfigurasi dukungan non-standar untuk M3U8. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat bagian M3U8NonStandardSupport pada topik Parameter details. |
|
| TS |
object |
Konfigurasi dukungan non-standar untuk file TS. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat bagian TS pada topik Parameter details. |
|
| Md5Support |
boolean |
Menunjukkan apakah output nilai MD5 file TS didukung dalam video M3U8. Nilai valid:
|
true |
| SizeSupport |
boolean |
Menunjukkan apakah ukuran file TS dihasilkan dalam output video M3U8. Nilai valid:
|
true |
| MergeConfigUrl |
string |
URL file konfigurasi penggabungan. Hanya salah satu dari MergeList dan MergeConfigUrl yang berlaku.
|
`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]} |
| MergeList |
object |
||
| Merge |
array<object> |
Konfigurasi untuk menggabungkan klip. |
|
|
object |
|||
| Duration |
string |
Durasi klip.
|
00000.20 |
| MergeURL |
string |
URL OSS klip.
|
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv |
| RoleArn |
string |
Nama Sumber Daya Alibaba Cloud (ARN) dari peran Resource Access Management (RAM) yang digunakan untuk otorisasi delegasi. |
acs:ram:: |
| Start |
string |
Titik waktu mulai klip.
|
00000.50 |
| MuxConfig |
object |
Konfigurasi transmuxing. Jika parameter ini ditentukan dalam permintaan, konfigurasi yang sesuai dalam template transkoding yang ditentukan akan ditimpa. |
|
| Gif |
object |
Konfigurasi transmuxing untuk GIF. |
|
| DitherMode |
string |
Algoritma dithering warna palet. Nilai valid: sierra dan bayer. |
bayer |
| FinalDelay |
string |
Durasi jeda frame terakhir. Unit: sentidetik. |
0 |
| IsCustomPalette |
string |
Menunjukkan apakah palet kustom digunakan. Nilai valid:
|
false |
| Loop |
string |
Jumlah putaran loop. |
0 |
| Segment |
object |
Konfigurasi segmen. Nilainya berupa objek JSON. |
|
| Duration |
string |
Panjang segmen. Nilainya berupa bilangan bulat. Unit: detik.
|
20 |
| Webp |
object |
Konfigurasi transmuxing untuk WebP. |
|
| Loop |
string |
Jumlah putaran loop. |
0 |
| OpeningList |
object |
||
| Opening |
array<object> |
Bagian pembuka. Nilainya berupa objek JSON. |
|
|
object |
|||
| Height |
string |
Tinggi bagian pembuka.
|
1080 |
| Start |
string |
Jumlah waktu setelah bagian pembuka diputar. Nilai dimulai dari 0.
|
1 |
| Width |
string |
Lebar bagian pembuka.
|
1920 |
| openUrl |
string |
URL OSS bagian pembuka. |
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv |
| OutSubtitleList |
object |
||
| OutSubtitle |
array<object> |
Subtitle output. |
|
|
array<object> |
|||
| Map |
string |
Track video. Format: |
0:v:0 |
| Message |
string |
Pesan kesalahan yang dikembalikan jika pekerjaan gagal dibuat. Parameter ini tidak dikembalikan jika pekerjaan berhasil dibuat. |
The specified parameter “%s” cannot be null. |
| OutSubtitleFile |
object |
Detail file output. |
|
| Bucket |
string |
Nama bucket OSS tempat file input disimpan. |
example-bucket-**** |
| Location |
string |
ID wilayah OSS tempat file output disimpan. |
oss-cn-hangzhou |
| Object |
string |
Nama objek OSS yang digunakan sebagai file output. |
example-output.flv |
| RoleArn |
string |
ARN peran RAM yang digunakan untuk otorisasi delegasi. |
acs:ram:: |
| Success |
boolean |
Menunjukkan apakah pekerjaan berhasil dibuat. Nilai valid:
|
true |
| OutputFile |
object |
Detail file output. |
|
| Bucket |
string |
Nama bucket OSS tempat file input disimpan. |
example-bucket-**** |
| Location |
string |
ID wilayah OSS tempat file output disimpan. |
oss-cn-hangzhou |
| Object |
string |
Nama objek OSS yang digunakan sebagai file output. |
example-output.flv |
| RoleArn |
string |
ARN peran RAM yang digunakan untuk otorisasi delegasi. |
acs:ram:: |
| Priority |
string |
Prioritas pekerjaan dalam antrian MPS tempat pekerjaan tersebut ditambahkan.
|
5 |
| Properties |
object |
Properti media. |
|
| Bitrate |
string |
Bitrate video. |
1000 |
| Duration |
string |
Durasi video. |
55 |
| FileFormat |
string |
Format video. |
QuickTime / MOV |
| FileSize |
string |
Ukuran file. |
3509895 |
| Format |
object |
Informasi format. |
|
| Bitrate |
string |
Total bitrate. |
1000 |
| Duration |
string |
Total durasi. |
55 |
| FormatLongName |
string |
Nama lengkap format kontainer. |
QuickTime / MOV |
| FormatName |
string |
Nama singkat format kontainer. Nilai valid: mov, mp4, m4a, 3gp, 3g2, dan mj2. |
mov |
| NumPrograms |
string |
Jumlah total stream program. |
0 |
| NumStreams |
string |
Jumlah total stream media. |
2 |
| Size |
string |
Ukuran file. |
3509895 |
| StartTime |
string |
Waktu mulai. |
0.000000 |
| Fps |
string |
Laju frame video. Nilainya berupa angka. |
25 |
| Height |
string |
Tinggi video. |
720 |
| Streams |
object |
Informasi stream. |
|
| AudioStreamList |
object |
||
| AudioStream |
array<object> |
Stream audio. |
|
|
object |
|||
| Bitrate |
string |
Bitrate stream audio. |
128.806 |
| ChannelLayout |
string |
Tata letak output saluran suara. |
stereo |
| Channels |
string |
Jumlah saluran suara. |
2 |
| CodecLongName |
string |
Nama lengkap kodek. |
AAC (Advanced Audio Coding) |
| CodecName |
string |
Nama singkat kodek. |
aac |
| CodecTag |
string |
Tag kodek. |
0x6134706d |
| CodecTagString |
string |
String tag kodek. |
mp4a |
| CodecTimeBase |
string |
Dasar waktu codec. |
1/44100 |
| Duration |
string |
Durasi stream audio. |
17.159546 |
| Index |
string |
Nomor urut stream audio. Nilai menunjukkan posisi stream audio dalam semua stream audio. |
1 |
| Lang |
string |
Bahasa stream audio. Untuk informasi selengkapnya, lihat dokumentasi FFmpeg dan ISO 639. |
eng |
| NumFrames |
string |
Jumlah total frame. |
25 |
| SampleFmt |
string |
Format pengambilan sampel. |
fltp |
| Samplerate |
string |
Laju pengambilan sampel stream audio. |
44100 |
| StartTime |
string |
Waktu mulai stream audio. |
0.000000 |
| Timebase |
string |
Dasar waktu stream audio. |
1/44100 |
| SubtitleStreamList |
object |
||
| SubtitleStream |
array<object> |
Aliran subtitle. |
|
|
object |
|||
| Index |
string |
Nomor urut stream subtitle. Nilai menunjukkan posisi stream subtitle dalam semua stream subtitle. |
1 |
| Lang |
string |
Bahasa stream subtitle. Untuk informasi selengkapnya, lihat dokumentasi FFmpeg dan ISO 639. |
eng |
| VideoStreamList |
object |
||
| VideoStream |
array<object> |
Stream video. |
|
|
array<object> |
|||
| AvgFPS |
string |
Laju frame rata-rata stream video. |
23.976025 |
| Bitrate |
string |
Bitrate stream video. |
1496.46 |
| CodecLongName |
string |
Nama lengkap kodek. |
H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 |
| CodecName |
string |
Nama singkat kodek. |
h264 |
| CodecTag |
string |
Tag kodek. |
0x31637661 |
| CodecTagString |
string |
String tag kodek. |
avc1 |
| CodecTimeBase |
string |
Dasar waktu codec. |
1001/48000 |
| Dar |
string |
Rasio aspek tampilan (DAR) stream video. |
16:9 |
| Duration |
string |
Durasi stream video. |
17.225542 |
| Fps |
string |
Laju frame stream video. |
23.976025 |
| HasBFrames |
string |
Menunjukkan apakah stream video berisi B-frame. |
2 |
| Height |
string |
Tinggi stream video dalam piksel. |
720 |
| Index |
string |
Nomor urut stream video. Nilai menunjukkan posisi stream video dalam semua stream video. |
0 |
| Lang |
string |
Bahasa stream video. Untuk informasi selengkapnya, lihat dokumentasi FFmpeg dan ISO 639. |
eng |
| Level |
string |
Tingkat kodek. |
51 |
| NetworkCost |
object |
Bandwidth jaringan yang dikonsumsi. |
|
| AvgBitrate |
string |
Bitrate rata-rata stream video. |
100 |
| CostBandwidth |
string |
Bandwidth maksimum yang dikonsumsi. |
10 |
| PreloadTime |
string |
Jumlah waktu yang dikonsumsi untuk preload stream video. |
8 |
| NumFrames |
string |
Jumlah total frame. |
25 |
| PixFmt |
string |
Format piksel stream video. |
yuv420p |
| Profile |
string |
Profil codec. |
high |
| Sar |
string |
Rasio aspek sampel (SAR) stream video. |
1:1 |
| StartTime |
string |
Waktu mulai stream video. |
0.000000 |
| Timebase |
string |
Dasar waktu stream video. |
1/24000 |
| Width |
string |
Lebar stream video dalam piksel. |
1280 |
| Width |
string |
Lebar video. |
1280 |
| Rotate |
string |
Sudut rotasi video, searah jarum jam. |
180 |
| SubtitleConfig |
object |
Konfigurasi subtitle. |
|
| ExtSubtitleList |
object |
||
| ExtSubtitle |
array<object> |
Subtitle eksternal. Nilainya berupa array JSON yang berisi hingga empat objek. |
|
|
array<object> |
|||
| CharEnc |
string |
Set karakter yang digunakan oleh subtitle eksternal.
Catatan
Jika parameter ini diatur ke auto, set karakter yang terdeteksi mungkin bukan set karakter aktual. Kami menyarankan agar Anda mengatur parameter ini ke nilai lain. |
UTF-8 |
| FontName |
string |
Font subtitle hardcoded yang dikonversi dari subtitle eksternal. Nilai default: SimSun. Untuk informasi selengkapnya, lihat Fonts. |
"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun" |
| Input |
object |
Objek OSS yang digunakan sebagai subtitle eksternal. Nilainya berupa objek JSON. File dalam format SRT atau ASS didukung. |
|
| Bucket |
string |
Nama bucket OSS tempat file input disimpan. |
example-bucket-**** |
| Location |
string |
ID wilayah OSS tempat file input disimpan. |
oss-cn-hangzhou |
| Object |
string |
Nama objek OSS yang digunakan sebagai file input. |
example-output.flv |
| SubtitleList |
object |
||
| Subtitle |
array<object> |
Subtitle. |
|
|
object |
|||
| Map |
string |
Track audio. Format: |
0:a:0 |
| SuperReso |
object |
Konfigurasi untuk menggunakan resolusi video sumber. |
|
| IsHalfSample |
string |
Menunjukkan apakah parameter terkait laju pengambilan sampel diperoleh. Nilai valid:
|
true |
| TailSlateList |
object |
||
| TailSlate |
array<object> |
Bagian akhir. Nilainya berupa objek JSON. |
|
|
object |
|||
| BgColor |
string |
Warna bilah yang ditambahkan ke bagian akhir jika ukuran bagian akhir lebih kecil daripada bagian utama. Nilai default: White. Untuk informasi selengkapnya, lihat Background colors. |
White |
| BlendDuration |
string |
Durasi transisi antara bagian utama dan bagian akhir. Digunakan transisi fade: frame terakhir bagian utama memudar, dan frame pertama bagian akhir muncul perlahan. Unit: detik. Nilai default: 0. |
2 |
| Height |
string |
Tinggi bagian akhir.
|
1080 |
| IsMergeAudio |
boolean |
Menunjukkan apakah konten audio bagian akhir digabungkan. Nilai valid:
|
false |
| Start |
string |
Waktu mulai. |
1 |
| TailUrl |
string |
URL OSS bagian akhir. |
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv |
| Width |
string |
Lebar bagian akhir.
|
1920 |
| TemplateId |
string |
ID template transkoding. |
S00000000-000010 |
| TransConfig |
object |
Konfigurasi transkoding umum. Catatan
Jika parameter ini ditentukan dalam permintaan, parameter yang sesuai dalam template transkoding yang ditentukan akan ditimpa. |
|
| AdjDarMethod |
string |
Metode penyesuaian resolusi. Nilai default: none. Nilai valid:
|
crop |
| IsCheckAudioBitrate |
string |
Menunjukkan apakah bitrate audio diperiksa. Jika bitrate output audio lebih tinggi daripada bitrate input audio, bitrate input dipertahankan dan bitrate audio yang ditentukan tidak berlaku. Parameter ini memiliki prioritas lebih rendah daripada IsCheckAudioBitrateFail. Nilai valid:
|
false |
| IsCheckAudioBitrateFail |
string |
Menunjukkan apakah bitrate audio diperiksa. Parameter ini memiliki prioritas lebih tinggi daripada IsCheckAudioBitrate. Jika bitrate output audio lebih tinggi daripada bitrate input audio, kegagalan transkoding dikembalikan tanpa mentranskode audio. Nilai valid:
|
true |
| IsCheckReso |
string |
Menunjukkan apakah resolusi diperiksa. Jika resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, resolusi input dipertahankan. Nilai valid:
|
false |
| IsCheckResoFail |
string |
Menunjukkan apakah resolusi diperiksa. Parameter ini memiliki prioritas lebih tinggi daripada IsCheckReso. Jika resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, kegagalan transkoding dikembalikan tanpa mentranskode video. Nilai valid:
|
false |
| IsCheckVideoBitrate |
string |
Menunjukkan apakah bitrate video diperiksa. Jika bitrate output video lebih tinggi daripada bitrate input video, bitrate input dipertahankan. Nilai valid:
|
false |
| IsCheckVideoBitrateFail |
string |
Menunjukkan apakah bitrate video diperiksa. Jika bitrate output video lebih tinggi daripada bitrate input video, kegagalan transkoding dikembalikan tanpa mentranskode video. Parameter ini memiliki prioritas lebih tinggi daripadaIsCheckVideoBitrate. Nilai valid:
|
true |
| TransMode |
string |
Mode transkoding. Nilai valid:
|
onepass |
| UserData |
string |
Data kustom. |
example data |
| Video |
object |
Konfigurasi video. Catatan
Jika parameter ini ditentukan, AliyunVideoCodec dalam template yang ditentukan oleh TemplateId akan ditimpa. |
|
| Bitrate |
string |
Bitrate video output. Unit: Kbit/s. |
10 |
| BitrateBnd |
object |
Rentang bitrate rata-rata video. |
|
| Max |
string |
Batas atas total bitrate. Unit: Kbit/s. |
20 |
| Min |
string |
Batas bawah total bitrate. Unit: Kbit/s. |
10 |
| Bufsize |
string |
Ukuran buffer.
|
1000 |
| Codec |
string |
Kodek video.
|
H.264 |
| Crf |
string |
Faktor laju konstan.
|
22 |
| Crop |
string |
Metode pemotongan video. Nilai valid:
|
1280:800:0:140 |
| Degrain |
string |
Kekuatan algoritma pengurangan noise independen. |
5 |
| Fps |
string |
Laju frame.
|
60 |
| Gop |
string |
Interval maksimum antara keyframe atau jumlah maksimum frame dalam grup frame. Unit: detik.
|
1 |
| Height |
string |
Tinggi video.
|
1280 |
| MaxFps |
string |
Laju frame maksimum. |
15 |
| Maxrate |
string |
Bitrate maksimum video. Unit: Kbit/s. |
10 |
| Pad |
string |
Batas hitam yang ditambahkan ke video.
|
1280:800:0:140 |
| PixFmt |
string |
Format piksel video.
|
yuvj420p |
| Preset |
string |
Algoritma video preset. Nilai default: medium. Nilai valid:
|
veryfast |
| Profile |
string |
Profil pengkodean. Parameter ini hanya dikembalikan untuk kodek H.264. Nilai default: high. Nilai valid: Catatan
Jika melibatkan beberapa definisi, kami menyarankan Anda menggunakan baseline untuk definisi terendah guna memastikan pemutaran normal pada perangkat definisi rendah, dan menggunakan main atau high untuk definisi lainnya.
|
baseline |
| Qscale |
string |
Tingkat kontrol kualitas video. |
15 |
| ResoPriority |
string |
Prioritas sumber daya. |
1 |
| ScanMode |
string |
Mode pemindaian. Nilai valid:
Praktik terbaik: Pemindaian interlaced mengonsumsi bandwidth lebih sedikit daripada pemindaian progresif, tetapi kualitas gambarnya buruk. Oleh karena itu, produksi video utama menggunakan pemindaian progresif.
|
interlaced |
| Width |
string |
Lebar video.
|
1080 |
| VideoStreamMap |
string |
Nomor urut stream video.
|
0:a:0 |
| WaterMarkConfigUrl |
string |
URL file konfigurasi watermark. |
http://example.com/configure |
| WaterMarkList |
object |
||
| WaterMark |
array<object> |
Watermark. Catatan
Jika watermark terpotong atau gagal dihasilkan, periksa apakah watermark teks yang Anda tambahkan mengandung karakter khusus. Jika watermark teks mengandung karakter khusus, Anda harus melakukan escape karakter khusus tersebut sebelum menambahkan watermark. Atau, Anda dapat mengajukan tiket untuk menghubungi layanan pelanggan Alibaba Cloud guna pemrosesan kompatibilitas. |
|
|
array<object> |
|||
| Dx |
string |
Offset horizontal gambar watermark relatif terhadap video output. Jika parameter ini ditentukan dalam permintaan, parameter yang sesuai dalam template watermark akan ditimpa. Nilai default: 0. Nilainya dapat berupa bilangan bulat atau desimal.
|
1 |
| Dy |
string |
Offset vertikal gambar watermark relatif terhadap video output. Jika parameter ini ditentukan dalam permintaan, parameter yang sesuai dalam template watermark akan ditimpa. Nilainya dapat berupa bilangan bulat atau desimal.
|
1 |
| Height |
string |
Tinggi watermark. Jika parameter ini ditentukan dalam permintaan, parameter yang sesuai dalam template watermark akan ditimpa. Nilainya dapat berupa bilangan bulat atau desimal.
|
1280 |
| InputFile |
object |
File input watermark. Gambar PNG dan file MOV didukung. |
|
| Bucket |
string |
Nama bucket OSS tempat file input disimpan. |
example-bucket |
| Location |
string |
ID wilayah OSS tempat file input disimpan. |
oss-cn-hangzhou |
| Object |
string |
Nama objek OSS yang digunakan sebagai file input. |
example-logo-****.png |
| ReferPos |
string |
Posisi watermark. Jika parameter ini ditentukan dalam permintaan, parameter yang sesuai dalam template watermark akan ditimpa. Nilai valid:
|
TopRight |
| Type |
string |
Jenis watermark. Jika parameter ini ditentukan dalam permintaan, parameter yang sesuai dalam template watermark akan ditimpa. Untuk informasi selengkapnya, lihat Parameter details. Nilai valid:
|
Image |
| WaterMarkTemplateId |
string |
ID template watermark. |
88c6ca184c0e47098a5b665e2a12**** |
| Width |
string |
Lebar gambar watermark. Jika parameter ini ditentukan dalam permintaan, parameter yang sesuai dalam template watermark akan ditimpa. Nilainya dapat berupa bilangan bulat atau desimal.
|
1080 |
| Percent |
integer |
Kemajuan transkoding. |
100 |
| PipelineId |
string |
ID antrian MPS. |
88c6ca184c0e47098a5b665e2a126797 |
| State |
string |
Status pekerjaan. Nilai valid:
|
Submitted |
| Message |
string |
Pesan kesalahan yang dikembalikan jika pekerjaan gagal dibuat. Parameter ini tidak dikembalikan jika pekerjaan berhasil dibuat. |
The specified parameter "%s" cannot be null. |
| Success |
boolean |
Menunjukkan apakah pekerjaan berhasil. Nilai valid:
|
true |
| RequestId |
string |
ID permintaan. |
25818875-5F78-4A45S71F6-D73936451234 |
Contoh
Respons sukses
JSONformat
{
"JobResultList": {
"JobResult": [
{
"Code": "InvalidParameter.NullValue",
"Job": {
"Code": "InternalError",
"CreationTime": "2014-01-10T12:00:00Z",
"FinishTime": "2014-01-10T12:20:00Z",
"Input": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example.flv"
},
"JobId": "31fa3c9ca8134f9cec2b4b0b0f78****",
"MNSMessageResult": {
"ErrorCode": "InvalidParameter.ResourceNotFound",
"ErrorMessage": "The resource operated \"%s\" cannot be found.",
"MessageId": "123"
},
"Message": "The operation has failed due to some unknown error, exception or failure.",
"Output": {
"AmixList": {
"Amix": [
{
"AmixURL": "https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3",
"Duration": "20",
"Map": "0:a:0",
"MixDurMode": "long",
"Start": "0"
}
]
},
"Audio": {
"Bitrate": "128",
"Channels": "6",
"Codec": "aac",
"Profile": "aac_low",
"Qscale": "15",
"Samplerate": "32000",
"Volume": {
"Level": "-20",
"Method": "auto"
}
},
"AudioStreamMap": "0:a:0",
"Clip": {
"TimeSpan": {
"Duration": "01:00:59.999",
"Seek": "01:59:59.999"
}
},
"Container": {
"Format": "flv"
},
"DeWatermark": "{\"0\": [{\"l\": 10,\"t\": 10,\"w\": 10,\"h\": 10},{\"l\": 100,\"t\": 0.1,\"w\": 10,\"h\": 10}],\"128000\": [],\"250000\": [{\"l\": 0.2,\"t\": 0.1,\"w\": 0.01,\"h\": 0.05}]}",
"DigiWaterMark": {
"Alpha": "1.0",
"InputFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-intput.flv"
},
"Type": "Image"
},
"Encryption": {
"Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
"Key": "encryptionkey128",
"KeyType": "Base64",
"KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
"SkipCnt": "3",
"Type": "hls-aes-128"
},
"M3U8NonStandardSupport": {
"TS": {
"Md5Support": true,
"SizeSupport": true
}
},
"MergeConfigUrl": "`{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}",
"MergeList": {
"Merge": [
{
"Duration": "00000.20",
"MergeURL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv",
"RoleArn": "acs:ram:::role/",
"Start": "00000.50"
}
]
},
"MuxConfig": {
"Gif": {
"DitherMode": "bayer",
"FinalDelay": "0",
"IsCustomPalette": "false",
"Loop": "0"
},
"Segment": {
"Duration": "20"
},
"Webp": {
"Loop": "0"
}
},
"OpeningList": {
"Opening": [
{
"Height": "1080",
"Start": "1",
"Width": "1920",
"openUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
}
]
},
"OutSubtitleList": {
"OutSubtitle": [
{
"Map": "0:v:0",
"Message": "The specified parameter “%s” cannot be null.",
"OutSubtitleFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv",
"RoleArn": "acs:ram:::role/"
},
"Success": true
}
]
},
"OutputFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv",
"RoleArn": "acs:ram:::role/"
},
"Priority": "5",
"Properties": {
"Bitrate": "1000",
"Duration": "55",
"FileFormat": "QuickTime / MOV",
"FileSize": "3509895",
"Format": {
"Bitrate": "1000",
"Duration": "55",
"FormatLongName": "QuickTime / MOV",
"FormatName": "mov",
"NumPrograms": "0",
"NumStreams": "2",
"Size": "3509895",
"StartTime": "0.000000"
},
"Fps": "25",
"Height": "720",
"Streams": {
"AudioStreamList": {
"AudioStream": [
{
"Bitrate": "128.806",
"ChannelLayout": "stereo",
"Channels": "2",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecName": "aac",
"CodecTag": "0x6134706d",
"CodecTagString": "mp4a",
"CodecTimeBase": "1/44100",
"Duration": "17.159546",
"Index": "1",
"Lang": "eng",
"NumFrames": "25",
"SampleFmt": "fltp",
"Samplerate": "44100",
"StartTime": "0.000000",
"Timebase": "1/44100"
}
]
},
"SubtitleStreamList": {
"SubtitleStream": [
{
"Index": "1",
"Lang": "eng"
}
]
},
"VideoStreamList": {
"VideoStream": [
{
"AvgFPS": "23.976025",
"Bitrate": "1496.46",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"CodecName": "h264",
"CodecTag": "0x31637661",
"CodecTagString": "avc1",
"CodecTimeBase": "1001/48000",
"Dar": "16:9",
"Duration": "17.225542",
"Fps": "23.976025",
"HasBFrames": "2",
"Height": "720",
"Index": "0",
"Lang": "eng",
"Level": "51",
"NetworkCost": {
"AvgBitrate": "100",
"CostBandwidth": "10",
"PreloadTime": "8"
},
"NumFrames": "25",
"PixFmt": "yuv420p",
"Profile": "high",
"Sar": "1:1",
"StartTime": "0.000000",
"Timebase": "1/24000",
"Width": "1280"
}
]
}
},
"Width": "1280"
},
"Rotate": "180",
"SubtitleConfig": {
"ExtSubtitleList": {
"ExtSubtitle": [
{
"CharEnc": "UTF-8",
"FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
"Input": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv"
}
}
]
},
"SubtitleList": {
"Subtitle": [
{
"Map": "0:a:0"
}
]
}
},
"SuperReso": {
"IsHalfSample": "true"
},
"TailSlateList": {
"TailSlate": [
{
"BgColor": "White",
"BlendDuration": "2",
"Height": "1080",
"IsMergeAudio": false,
"Start": "1",
"TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
"Width": "1920"
}
]
},
"TemplateId": "S00000000-000010",
"TransConfig": {
"AdjDarMethod": "crop",
"IsCheckAudioBitrate": "false",
"IsCheckAudioBitrateFail": "true",
"IsCheckReso": "false",
"IsCheckResoFail": "false",
"IsCheckVideoBitrate": "false",
"IsCheckVideoBitrateFail": "true",
"TransMode": "onepass"
},
"UserData": "example data",
"Video": {
"Bitrate": "10",
"BitrateBnd": {
"Max": "20",
"Min": "10"
},
"Bufsize": "1000",
"Codec": "H.264",
"Crf": "22",
"Crop": "1280:800:0:140",
"Degrain": "5",
"Fps": "60",
"Gop": "1",
"Height": "1280",
"MaxFps": "15",
"Maxrate": "10",
"Pad": "1280:800:0:140",
"PixFmt": "yuvj420p",
"Preset": "veryfast",
"Profile": "baseline",
"Qscale": "15",
"ResoPriority": "1",
"ScanMode": "interlaced",
"Width": "1080"
},
"VideoStreamMap": "0:a:0",
"WaterMarkConfigUrl": "http://example.com/configure",
"WaterMarkList": {
"WaterMark": [
{
"Dx": "1",
"Dy": "1",
"Height": "1280",
"InputFile": {
"Bucket": "example-bucket",
"Location": "oss-cn-hangzhou",
"Object": "example-logo-****.png"
},
"ReferPos": "TopRight",
"Type": "Image",
"WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
"Width": "1080"
}
]
}
},
"Percent": 100,
"PipelineId": "88c6ca184c0e47098a5b665e2a126797",
"State": "Submitted"
},
"Message": "The specified parameter \"%s\" cannot be null.",
"Success": true
}
]
},
"RequestId": "25818875-5F78-4A45S71F6-D73936451234"
}
Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.