All Products
Search
Document Center

:SubmitJobs

Last Updated:May 27, 2026

Mengirimkan pekerjaan transkoding.

Catatan penggunaan

  • 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.
  • Jika ingin menggunakan beberapa akun di MPS, buat Pengguna RAM melalui Akun Alibaba Cloud Anda dan berikan izin MPSfullaccess kepada Pengguna RAM tersebut. Jika Akun Alibaba Cloud yang digunakan untuk mengkueri pekerjaan transkoding berbeda dari akun yang digunakan untuk membuat pekerjaan tersebut, tidak ada data yang dikembalikan. Untuk informasi selengkapnya, lihat Buat peran RAM untuk akun Alibaba Cloud tepercaya dan otorisasi peran RAM untuk mengakses MPS.
  • Satu pekerjaan transkoding dihasilkan untuk setiap output transkoding. Operasi API ini mengembalikan informasi mengenai pekerjaan transkoding yang dihasilkan.
  • Selama transkoding di MPS, sebuah video dikodekan ulang. Bitrate video hasil transkoding mungkin berbeda dari bitrate video sumber. Jika ingin mempertahankan bitrate video selama transkoding, gunakan template konversi format kontainer. Untuk informasi selengkapnya, lihat Detail template preset.
  • Pekerjaan ditambahkan ke antrian MPS tempat pekerjaan dijadwalkan dan dijalankan. Setelah pekerjaan dijalankan, Anda dapat memanggil operasi QueryJobList untuk mengkueri hasilnya atau mengaktifkan notifikasi asinkron agar secara otomatis diberi tahu tentang hasil tersebut.
    Catatan Untuk mengaktifkan notifikasi asinkron, Anda harus mengikat topik Message Service (MNS) ke antrian MPS tempat pekerjaan transkoding dijalankan. Jika pesan asinkron dikembalikan untuk pekerjaan transkoding di antrian MPS, MPS akan meneruskan pesan tersebut ke topik MNS yang ditentukan.
  • Untuk menggunakan template preset cerdas dalam mentranskode video, pertama-tama panggil operasi SubmitAnalysisJob untuk mengirimkan pekerjaan analisis template untuk video tersebut. Setelah pekerjaan analisis selesai, panggil operasi QueryAnalysisJobList untuk mengkueri template preset cerdas yang berlaku untuk video tersebut.
    Catatan Saat mengirimkan pekerjaan transkoding, atur parameter TemplateId ke ID template preset yang berlaku. Jika Anda menentukan template preset yang tidak termasuk dalam daftar template preset yang berlaku, pekerjaan transkoding akan gagal.
  • Jika menggunakan template preset statis untuk mentranskode video, Anda tidak perlu mengirimkan pekerjaan analisis template terlebih dahulu.
  • Ukuran file input dalam pekerjaan transkoding dapat mencapai maksimal 100 GB. Jika melebihi batas ini, pekerjaan transkoding mungkin gagal.

Batas QPS

Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Permintaan yang melebihi batas ini akan dijatuhkan dan menyebabkan gangguan layanan. Kami menyarankan Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter Tipe Wajib Contoh Deskripsi
Action String Ya SubmitJobs

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke SubmitJobs.

Input String Ya {"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "Parameter yang Anda atur di Konsol Object Storage Service (OSS) untuk mengaktifkan fitur Perlindungan hotlink"}

Input pekerjaan. Tentukan nilainya dalam objek JSON. Parameter Referer bersifat opsional. Jika Anda perlu menetapkan daftar putih referer dalam pekerjaan transkoding, Anda harus menentukan parameter Referer dalam input. Untuk informasi selengkapnya tentang parameter dalam parameter Input, lihat bagian Input pada topik "Detail parameter".

Catatan Anda dapat menentukan variabel {ObjectPrefix}, {FileName}, dan {ExtName} dalam URL OSS. MPS dapat mengganti variabel tersebut secara dinamis dengan nilai aktual. Misalnya, Anda menentukan a/b/c/test.flv sebagai objek yang digunakan sebagai file input dan {ObjectPrefix}{FileName}-cn.srt sebagai objek yang digunakan sebagai file subtitle eksternal. Setelah pengkodean URL, URL OSS yang ditentukan untuk file subtitle eksternal adalah %7bObjectPrefix%7d%7bFileName%7d-cn.srt. Kemudian, MPS mengganti variabel tersebut untuk mendapatkan a/b/c/test-cn.srt sebagai URL OSS file subtitle eksternal.
Outputs String Ya [{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff****","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47****"}],"UserData":"testid-001"}]

Output pekerjaan.

  • Tentukan nilainya dalam larik JSON objek Output. Anda dapat menentukan hingga 30 objek Output.
  • Untuk informasi selengkapnya tentang output pekerjaan, lihat Istilah.
  • Untuk informasi selengkapnya tentang parameter dalam setiap objek Output, lihat bagian Output pada topik "Detail parameter".
Catatan Jika Anda perlu menggabungkan gambar dalam pekerjaan transkoding, atur lebar dan tinggi setiap gambar yang akan diproses menjadi angka genap. Jika tidak, pekerjaan tersebut mungkin gagal.
OutputBucket String Ya exampleBucket

Nama bucket output. Untuk mendapatkan nama bucket output, Anda dapat login ke Konsol MPS, pilih Workflows > Media Buckets di panel navigasi sebelah kiri, lalu klik tab Output Buckets.

OutputLocation String Tidak oss-cn-hangzhou

Wilayah tempat bucket output berada.

PipelineId String Ya dd3dae411e704030b921e52698e5****

ID Antrian MPS. Untuk mendapatkan ID Antrian MPS, Anda dapat login ke Konsol MPS dan pilih Global Settings > Pipelines di panel navigasi sebelah kiri.

  • Untuk informasi selengkapnya tentang Antrian MPS, lihat Istilah.
  • Jika Anda ingin menggunakan notifikasi asinkron, pastikan topik MNS telah diikat ke Antrian MPS yang akan digunakan. Untuk informasi selengkapnya tentang cara mengikat topik MNS ke Antrian MPS, lihat Aktifkan fitur notifikasi untuk pekerjaan atau alur kerja.

Parameter respons

Parameter Tipe Contoh Deskripsi
JobResultList Larik JobResult

Pekerjaan transkoding yang dihasilkan.

JobResult
Job Objek

Detail pekerjaan. Jika pekerjaan gagal dikirimkan, tidak ada ID pekerjaan yang dihasilkan.

CreationTime String 2014-01-10T12:00:00Z

Waktu saat pekerjaan dibuat.

Percent Long 100

Kemajuan transkoding.

FinishTime String 2014-01-10T12:20:00Z

Waktu saat pekerjaan selesai.

State String Submitted

Status pekerjaan. Nilai yang valid:

  • Submitted: Pekerjaan telah dikirimkan.
  • TranscodeFail: Pekerjaan gagal.
JobId String 31fa3c9ca8134f9cec2b4b0b0f78****

ID pekerjaan.

Code String InternalError

Kode kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.

Message String The operation has failed due to some unknown error, exception or failure.

Pesan kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.

Output Objek

Output pekerjaan.

Video Objek

Konfigurasi video.

Catatan Jika parameter ini ditentukan dalam permintaan, pengaturan parameter AliyunVideoCodec dalam template yang ditentukan oleh parameter TemplateId akan ditimpa oleh pengaturan parameter ini.
Bufsize String 1000

Ukuran buffer.

  • Unit: KB.
  • Nilai default: 6000.
Degrain String 5

Tingkat algoritma denoising independen.

BitrateBnd Objek

Rentang bitrate rata-rata video.

Max String 20

Batas atas total bitrate. Unit: Kbit/s.

Min String 10

Batas bawah total bitrate. Unit: Kbit/s.

PixFmt String yuvj420p

Format piksel untuk pengkodean warna video.

  • Format piksel default dapat berupa yuv420p atau format piksel asli.
  • Nilai yang valid: format piksel standar seperti yuv420p dan yuvj420p.
    Catatan Jika format piksel non-standar seperti yuvj420p(pc, bt470bg/bt470bg/smpte170m) digunakan, kompatibilitas dengan format piksel tersebut harus dikonfigurasi. Jika tidak, transkoding akan gagal. )
Pad String 1280:800:0:140

Bilah hitam yang akan ditambahkan ke video.

  • Format: lebar:tinggi:kiri:atas.
  • Unit: piksel.
Codec String H.264

Kodek video.

  • Nilai yang valid: H.264, H.265, GIF, dan WEBP.
  • Nilai default: H.264.
Height String 1280

Tinggi video.

  • Unit: piksel.
  • Nilai default: tinggi video asli.
Qscale String 15

Tingkat kontrol kualitas video.

Crop String 1280:800:0:140

Metode pemotongan video. Nilai yang valid:

  • border: Bilah hitam dideteksi dan dihapus secara otomatis.
  • Nilai dalam format lebar:tinggi:kiri:atas: Video dipotong berdasarkan pengaturan kustom.
Bitrate String 10

Bitrate video output. Unit: Kbit/s.

Maxrate String 10

Bitrate maksimum video. Unit: Kbit/s.

MaxFps String 15

Laju frame maksimum.

Profile String baseline

Profil pengkodean. Parameter ini hanya dikembalikan untuk kodek H.264. Nilai default: high. Nilai yang valid:

Catatan Jika melibatkan beberapa definisi, kami menyarankan Anda menggunakan baseline untuk definisi terendah guna memastikan pemutaran normal pada perangkat low-end, dan menggunakan main atau high untuk definisi lainnya.
  • baseline: berlaku untuk perangkat seluler.
  • main: berlaku untuk perangkat definisi standar.
  • high: berlaku untuk perangkat definisi tinggi.
Crf String 22

Faktor laju konstan (Constant Rate Factor).

  • Jika parameter Crf dikembalikan, pengaturan parameter Bitrate menjadi tidak berlaku.
  • Nilai default saat nilai parameter Codec adalah H.264: 23. Nilai default saat nilai parameter Codec adalah H.265: 26.
Gop String 1

Ukuran Group of Pictures (GOP). Ukuran GOP dapat berupa interval maksimum keyframe atau jumlah maksimum frame dalam grup frame. Unit: detik.

  • Nilai default: 10 detik.
  • Jika nilai menunjukkan jumlah maksimum frame, nilai tersebut tidak mengandung unit.
Width String 1080

Lebar video.

  • Unit: piksel.
  • Nilai default: lebar video asli.
Fps String 60

Laju frame video.

  • Unit: frame per detik.
  • Nilai yang valid: 0 hingga 60. Nilainya 60 jika laju frame file input melebihi 60.
  • Nilai default: laju frame file input.
Preset String veryfast

Algoritma video preset. Nilai default: medium. Nilai yang valid:

  • veryfast
  • fast
  • medium
  • slow
  • slower
ScanMode String interlaced

Mode pemindaian. Nilai yang valid:

  • interlaced: Dilakukan pemindaian interlaced.
  • progressive: Dilakukan pemindaian progresif.
  • auto: Pemindaian dilakukan berdasarkan sumber video.
ResoPriority String 1

Prioritas sumber daya.

TransConfig Objek

Konfigurasi transkoding umum.

Catatan Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template transkoding yang ditentukan.
IsCheckAudioBitrate String false

Menunjukkan apakah bitrate audio diperiksa. Jika bitrate audio output lebih tinggi daripada bitrate audio input, sistem menganggap bahwa bitrate output sama dengan bitrate input dan bitrate audio yang ditentukan tidak berlaku. Parameter IsCheckAudioBitrateFail memiliki prioritas lebih tinggi daripada parameter ini. Nilai yang valid:

  • true: Bitrate audio diperiksa.
  • false: Bitrate audio tidak diperiksa.
  • Nilai default:
    • Nilai default saat parameter Bitrate kosong dan kodek file output berbeda dari kodek file input: false.
    • Nilai default saat parameter Bitrate kosong dan kodek file output sama dengan kodek file input: true.
TransMode String onepass

Mode transkoding. Nilai yang valid:

  • onepass: transkoding berdasarkan algoritma satu-pass, yang memiliki akurasi lebih tinggi.
  • twopass: transkoding berdasarkan algoritma dua-pass, yang memiliki akurasi lebih rendah.
  • CBR: transkoding berdasarkan bitrate tetap.
IsCheckReso String false

Menunjukkan apakah resolusi diperiksa. Jika resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, sistem menganggap bahwa resolusi output sama dengan resolusi input. Nilai yang valid:

  • true: Resolusi diperiksa.
  • false: Resolusi tidak diperiksa.
  • Nilai default: false.
IsCheckVideoBitrateFail String true

Menunjukkan apakah bitrate video diperiksa. Jika bitrate video output lebih tinggi daripada bitrate video input, kegagalan transkoding dikembalikan tanpa melakukan transkoding video. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckVideoBitrate. Nilai yang valid:

  • true: Bitrate video diperiksa.
  • false: Bitrate video tidak diperiksa.
  • Nilai default: false.
AdjDarMethod String crop

Metode penyesuaian resolusi. Nilai default: none. Nilai yang valid:

  • rescale: Gambar video diubah ukurannya.
  • crop: Gambar video dipotong.
  • pad: Gambar video diskalakan keluar untuk mengisi tampilan.
  • none: Resolusi tidak disesuaikan.
IsCheckVideoBitrate String false

Menunjukkan apakah bitrate video diperiksa. Jika bitrate video output lebih tinggi daripada bitrate video input, sistem menganggap bahwa bitrate output sama dengan bitrate input. Nilai yang valid:

  • true: Bitrate video diperiksa.
  • false: Bitrate video tidak diperiksa.
  • Nilai default: false.
IsCheckResoFail String false

Menunjukkan apakah resolusi diperiksa. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckReso. Jika resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, kegagalan transkoding dikembalikan tanpa melakukan transkoding video. Nilai yang valid:

  • true: Resolusi diperiksa.
  • false: Resolusi tidak diperiksa.
  • Nilai default: false.
IsCheckAudioBitrateFail String true

Menunjukkan apakah bitrate audio diperiksa. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckAudioBitrate. Jika bitrate audio output lebih tinggi daripada bitrate audio input, kegagalan transkoding dikembalikan tanpa melakukan transkoding video. Nilai yang valid:

  • false: Bitrate audio diperiksa.
  • true: Bitrate audio tidak diperiksa.
Encryption Objek

Konfigurasi enkripsi. Hanya output dalam format M3U8 yang didukung.

Type String hls-aes-128

Jenis enkripsi. Nilainya adalah hls-aes-128.

Key String encryptionkey128

Kunci yang digunakan untuk mengenkripsi video.

KeyType String Base64

Metode enkripsi kunci. Kunci tidak boleh dikirimkan 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").

Id String 31fa3c9ca8134f9cec2b4b0b0f78****

ID enkripsi.

KeyUri String https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/

URL yang digunakan untuk meminta kunci. URL tersebut dikodekan Base64.

SkipCnt String 3

Jumlah frame yang tidak dienkripsi di awal video. Membiarkan frame-frame ini tidak dienkripsi memungkinkan pemutaran video dimulai dengan cepat.

WaterMarkList Larik WaterMark

Daftar watermark.

Catatan Jika watermark terpotong atau gagal ditambahkan ke video, periksa apakah watermark teks yang Anda tambahkan mengandung karakter khusus. Jika watermark teks mengandung karakter khusus, Anda harus melakukan escape terhadap karakter tersebut. Atau, submit a ticket untuk dukungan teknis.
WaterMark
Type String Image

Jenis watermark. Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template watermark yang ditentukan. Untuk informasi selengkapnya, lihat Detail parameter. Nilai yang valid:

  • Image: watermark gambar.
  • Text: watermark teks.
ReferPos String TopRight

Posisi watermark. Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template watermark yang ditentukan. Nilai yang valid:

  • TopRight: pojok kanan atas.
  • TopLeft: pojok kiri atas.
  • BottomRight: pojok kanan bawah.
  • BottomLeft: pojok kiri bawah.
Dx String 1

Offset horizontal watermark relatif terhadap video output. Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template watermark yang ditentukan. Nilai default: 0. Nilainya dapat berupa bilangan bulat atau desimal.

  • Bilangan bulat menunjukkan nilai piksel offset horizontal.
    • Nilai yang valid: [8,4096].
    • Unit: piksel.
  • Bilangan desimal menunjukkan rasio offset horizontal terhadap lebar dalam resolusi video output.
    • Nilai yang valid: (0,1).
    • Bilangan desimal dapat akurat hingga empat tempat desimal, seperti 0.9999. Digit berlebih akan dihapus secara otomatis.
Width String 1080

Lebar watermark. Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template watermark yang ditentukan. Nilainya dapat berupa bilangan bulat atau desimal.

  • Bilangan bulat menunjukkan nilai piksel lebar watermark.
    • Nilai yang valid: [8,4096].
    • Unit: piksel.
  • Bilangan desimal menunjukkan rasio lebar watermark terhadap lebar dalam resolusi video output.
    • Nilai yang valid: (0,1).
    • Bilangan desimal dapat akurat hingga empat tempat desimal, seperti 0.9999. Digit berlebih akan dihapus secara otomatis.
Height String 1280

Tinggi watermark. Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template watermark yang ditentukan. Nilainya dapat berupa bilangan bulat atau desimal.

  • Bilangan bulat menunjukkan nilai piksel tinggi watermark.
    • Nilai yang valid: [8,4096].
    • Unit: piksel.
  • Bilangan desimal menunjukkan rasio tinggi watermark terhadap tinggi dalam resolusi video output.
    • Nilai yang valid: (0,1).
    • Bilangan desimal dapat akurat hingga empat tempat desimal, seperti 0.9999. Digit berlebih akan dihapus secara otomatis.
InputFile Objek

File input watermark. Anda dapat menggunakan gambar dalam format PNG atau file dalam format MOV sebagai input watermark.

Object String example-logo-****.png

Nama objek OSS yang digunakan sebagai file input.

Location String oss-cn-hangzhou

ID wilayah OSS tempat file input berada.

Bucket String example-bucket

Nama bucket OSS tempat file input disimpan.

WaterMarkTemplateId String 88c6ca184c0e47098a5b665e2a12****

ID template watermark.

Dy String 1

Offset vertikal gambar watermark relatif terhadap video output. Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template watermark yang ditentukan. Nilainya dapat berupa bilangan bulat atau desimal.

  • Bilangan bulat menunjukkan nilai piksel offset vertikal.
    • Nilai yang valid: [8,4096].
    • Unit: piksel.
  • Bilangan desimal menunjukkan rasio offset vertikal terhadap tinggi dalam resolusi video output.
    • Nilai yang valid: (0,1).
    • Bilangan desimal dapat akurat hingga empat tempat desimal, seperti 0.9999. Digit berlebih akan dihapus secara otomatis.
WaterMarkConfigUrl String http://example.com/configure

URL file konfigurasi watermark.

DeWatermark String {"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}]}

Konfigurasi efek buram watermark. Nilainya adalah objek JSON. Untuk informasi selengkapnya, lihat bagian DeWatermark pada topik Detail parameter.

M3U8NonStandardSupport Objek

Konfigurasi dukungan non-standar untuk M3U8. Nilainya adalah objek JSON. Untuk informasi selengkapnya, lihat bagian M3U8NonStandardSupport pada topik Detail parameter.

TS Objek

Konfigurasi dukungan non-standar untuk file TS. Nilainya adalah objek JSON. Untuk informasi selengkapnya, lihat bagian TS pada topik Detail parameter.

SizeSupport Boolean true

Menunjukkan apakah ukuran file TS dihasilkan dalam video M3U8 output. Nilai yang valid:

  • true: didukung.
  • false: tidak didukung.
Md5Support Boolean true

Menunjukkan apakah nilai MD5 file TS dihasilkan dalam video M3U8 output. Nilai yang valid:

  • true: didukung.
  • false: tidak didukung.
Priority String 5

Prioritas pekerjaan dalam Antrian MPS tempat pekerjaan tersebut ditambahkan.

  • Nilai 10 menunjukkan prioritas tertinggi.
  • Nilai default: 6.
Audio Objek

Konfigurasi audio.

Catatan Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template transkoding yang ditentukan.
Profile String aac_low

Profil kodek audio.

Catatan Nilai yang valid saat nilai parameter Codec adalah aac: aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld.
Codec String aac

Kodek audio.

  • Nilai yang valid: aac, mp3, vorbis, dan flac.
  • Nilai default: aac.
Samplerate String 32000

Laju pengambilan sampel.

  • Nilai yang valid: 22050, 32000, 44100, 48000, dan 96000.
  • Unit: Hz.
  • Nilai default: 44100.
Catatan Jika format kontainer video adalah FLV dan kodek audio adalah MP3, laju pengambilan sampel tidak boleh 32000, 48000, atau 96000. Jika kodek audio adalah MP3, laju pengambilan sampel tidak boleh 96000.
Qscale String 15

Tingkat kontrol kualitas audio.

Channels String 6

Jumlah saluran suara.

  • Jika nilai parameter Codec adalah mp3, nilai parameter ini hanya dapat 1 atau 2.
  • Jika nilai parameter Codec adalah aac, nilai parameter ini hanya dapat 1, 2, 4, 5, 6, atau 8.
  • Nilai default: 2.
Volume Objek

Konfigurasi volume.

Method String auto

Metode penyesuaian volume. Nilai yang valid:

  • auto: Volume disesuaikan secara otomatis.
  • dynamic: Volume disesuaikan secara dinamis.
  • linear: Volume disesuaikan secara linear.
Level String -20

Rentang penyesuaian volume.

  • Unit: dB.
  • Nilai default: -20db.
Bitrate String 128

Bitrate audio file output.

  • Unit: Kbit/s.
  • Nilai default: 128.
AudioStreamMap String 0:a:0

Nomor urut aliran audio.

  • Format: 0:a:{Nomor urut}. Contoh: 0:a:0.
  • Nomor urut adalah indeks aliran audio dalam daftar dan dimulai dari 0.
  • Jika nomor urut tidak ditentukan, aliran audio default digunakan.
MergeList Larik Merge

Konfigurasi untuk menggabungkan klip.

Merge
Start String 00000.50

Titik awal waktu klip.

  • Format: hh:mm:ss[.SSS] atau sssss[.SSS].
  • Contoh: 01:59:59.999 dan 32000.23.
RoleArn String acs:ram::<your uid>:role/<your role name>

Nama Sumber Daya Alibaba Cloud (ARN) dari peran yang digunakan untuk otorisasi delegasi.

MergeURL String http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv

URL OSS klip.

  • Contoh: http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv.
  • URL OSS objek harus dikodekan URL menggunakan standar UTF-8.
Duration String 00000.20

Durasi klip.

  • Format: hh:mm:ss[.SSS] atau sssss[.SSS].
  • Contoh: 01:59:59.999 dan 32000.23.
SuperReso Objek

Konfigurasi untuk menggunakan resolusi video sumber.

IsHalfSample String true

Menunjukkan apakah parameter yang terkait dengan laju pengambilan sampel diperoleh. Nilai yang valid:

  • true: Parameter diperoleh.
  • false: Parameter tidak diperoleh.
UserData String example data

Data kustom.

OutSubtitleList Larik OutSubtitle

Daftar subtitle output.

OutSubtitle
Map String 0:v:0

Aliran video. Format: 0:{Stream}:{Nomor urut aliran}, yaitu 0:v:{video_index}. Nilai Stream adalah v, yang menunjukkan aliran video. Nomor urut adalah indeks aliran video dalam daftar dan dimulai dari 0.

OutSubtitleFile Objek

Detail file output.

RoleArn String acs:ram::<your uid>:role/<your role name>

ARN peran yang digunakan untuk otorisasi delegasi.

Object String example-output.flv

Nama objek OSS yang digunakan sebagai file output.

Location String oss-cn-hangzhou

ID wilayah OSS tempat file output berada.

Bucket String example-bucket-****

Nama bucket OSS tempat file output disimpan.

Success Boolean true

Menunjukkan apakah pekerjaan dibuat. Nilai yang valid:

  • true: Pekerjaan dibuat.
  • false: Pekerjaan gagal dibuat.
Message String The specified parameter "%s" cannot be null.

Pesan kesalahan yang dikembalikan jika pekerjaan gagal dibuat. Parameter ini tidak dikembalikan jika pekerjaan berhasil dibuat.

DigiWaterMark Objek

Watermark digital.

Type String Image

Jenis watermark. Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template watermark yang ditentukan. Nilai yang valid:

  • Image: watermark gambar. Ini adalah nilai default.
  • Text: watermark teks.
Alpha String 1.0

Transparansi teks atau gambar.

  • Nilai yang valid: (0,1].
  • Nilai default: 1.0.
InputFile Objek

Detail file input.

Object String example-intput.flv

Nama objek OSS yang digunakan sebagai file input.

Location String oss-cn-hangzhou

ID wilayah OSS tempat file input berada.

Bucket String example-bucket-****

Nama bucket OSS tempat file input disimpan.

VideoStreamMap String 0:a:0

Nomor urut aliran video.

  • Format: 0:a:{Nomor urut}. Contoh: 0:a:0.
  • Nomor urut adalah indeks aliran video dalam daftar dan dimulai dari 0.
  • Jika nomor urut tidak ditentukan, aliran video default digunakan.
OutputFile Objek

Detail file output.

RoleArn String acs:ram::<your uid>:role/<your role name>

ARN peran yang digunakan untuk otorisasi delegasi.

Object String example-output.flv

Nama objek OSS yang digunakan sebagai file output.

Location String oss-cn-hangzhou

ID wilayah OSS tempat file output berada.

Bucket String example-bucket-****

Nama bucket OSS tempat file output disimpan.

AmixList Larik Amix

Daftar track audio yang akan dicampur.

Amix
Map String 0:a:0

Track audio yang akan dicampur. Format: 0:a:{audio_index}. Contoh: 0:a:0.

Start String 0

Titik awal waktu track audio. Nilainya dalam format angka atau waktu. Contoh: 1:25:36.240 dan 32000.23.

AmixURL String https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3

URL track audio yang akan dicampur sebagai musik latar.

  • URL dapat berupa URL OSS atau nilai parameter Input dalam bentuk string.
  • Nilai parameter Input dalam bentuk string menunjukkan bahwa dua track audio akan dicampur dalam video.
Duration String 20

Durasi track audio. Nilainya dalam format angka atau waktu.

MixDurMode String long

Mode untuk menentukan durasi pencampuran. Nilai yang valid: first dan long.

  • first: Panjang media output sama dengan panjang media input.
  • long: Panjang media output sama dengan panjang media output atau panjang media input, mana yang lebih panjang.
  • Nilai default: long.
Rotate String 180

Sudut rotasi video, searah jarum jam.

Container Objek

Konfigurasi kontainer.

Format String flv

Format kontainer.

  • Nilai default: mp4.
  • Format video meliputi FLV, MP4, HLS (M3U8 + TS), dan MPEG-DASH (MPD + fMP4).
  • Format audio meliputi MP3, MP4, Ogg, FLAC, dan M4A.
  • Format gambar meliputi GIF dan WebP.
  • Jika format kontainer adalah GIF, kodek video harus GIF.
  • Jika format kontainer adalah WebP, kodek video harus WebP.
  • Jika format kontainer adalah FLV, kodek video tidak boleh H.265.
Clip Objek

Informasi tentang klip.

TimeSpan Objek

Rentang waktu klip.

Seek String 01:59:59.999

Waktu saat klip dimulai.

  • Format: hh:mm:ss[.SSS] atau sssss[.SSS].
  • Nilai yang valid: [00:00:00.000,23:59:59.999] atau [0.000,86399.999].
Duration String 01:00:59.999

Durasi klip.

  • Format: hh:mm:ss[.SSS] atau sssss[.SSS].
  • Nilai yang valid: [00:00:00.000,23:59:59.999] atau [0.000,86399.999].
MergeConfigUrl String `{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}

Hanya salah satu dari parameter MergeList dan MergeConfigUrl yang berlaku.

  • File konfigurasi yang ditentukan oleh parameter MergeConfigUrl dapat berisi hingga 50 klip yang akan digabungkan.
  • Parameter MergeConfigUrl menunjukkan URL file konfigurasi untuk menggabungkan klip.
  • Pastikan file konfigurasi disimpan sebagai objek di OSS dan MPS dapat mengakses objek OSS tersebut. Untuk informasi tentang isi file, lihat detail parameter penggabungan.
  • Contoh isi file mergeConfigfile: {"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}.
OpeningList Larik Opening

Daftar bagian pembuka. Nilainya adalah objek JSON.

Opening
openUrl String http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv

URL OSS bagian pembuka video.

Start String 1

Jumlah waktu setelah bagian pembuka diputar. Nilainya dimulai dari 0.

  • Unit: detik.
  • Nilai default: 0.
Width String 1920

Lebar bagian pembuka.

  • Nilai yang valid: 0 hingga 4096, -1, dan full.
  • Nilai default: -1.
  • Nilai -1 menunjukkan bahwa lebar sumber bagian pembuka dipertahankan.
  • Nilai full menunjukkan bahwa lebar bagian utama digunakan untuk bagian pembuka.
Height String 1080

Tinggi bagian pembuka.

  • Nilai yang valid: 0 hingga 4096, -1, dan full.
  • Nilai default: -1.
  • Nilai -1 menunjukkan bahwa tinggi sumber bagian pembuka dipertahankan.
  • Nilai full menunjukkan bahwa tinggi bagian utama digunakan untuk bagian pembuka.
MuxConfig Objek

Konfigurasi transmuxing. Jika parameter ini ditentukan dalam permintaan, nilainya akan menimpa nilai parameter yang sesuai dalam template transkoding yang ditentukan.

Webp Objek

Konfigurasi transmuxing untuk WebP.

Loop String 0

Jumlah loop.

Gif Objek

Konfigurasi transmuxing untuk GIF.

FinalDelay String 0

Durasi jeda frame terakhir. Unit: centidetik.

DitherMode String bayer

Algoritma dithering warna palet. Nilai yang valid: sierra dan bayer.

Loop String 0

Jumlah loop.

IsCustomPalette String false

Menunjukkan apakah palet kustom digunakan. Nilai yang valid:

  • true: Palet kustom digunakan.
  • false: Palet kustom tidak digunakan.
Segment Objek

Konfigurasi segmen. Nilainya adalah objek JSON.

Duration String 20

Panjang segmen. Nilainya adalah bilangan bulat. Unit: detik.

  • Nilai yang valid: [1,10].
  • Nilai default: 10.
TailSlateList Larik TailSlate

Daftar bagian penutup. Nilainya adalah objek JSON.

TailSlate
Start String 1

Waktu mulai.

BgColor String White

Warna bilah yang ditambahkan ke bagian penutup jika ukuran bagian penutup lebih kecil daripada bagian utama. Nilai default: White. Untuk informasi selengkapnya, lihat Warna latar belakang.

IsMergeAudio Boolean false

Menunjukkan apakah konten audio bagian penutup digabungkan. Nilai yang valid:

  • true: Konten audio bagian penutup digabungkan.
  • false: Konten audio bagian penutup tidak digabungkan.
Width String 1920

Lebar bagian penutup.

  • Nilai yang valid: 0 hingga 4096, -1, dan full.
  • Nilai -1 menunjukkan bahwa lebar sumber bagian penutup dipertahankan. Nilai full menunjukkan bahwa lebar bagian utama digunakan untuk bagian penutup.
  • Nilai default: -1.
Height String 1080

Tinggi bagian penutup.

  • Nilai yang valid: 0 hingga 4096, -1, dan full.
  • Nilai -1 menunjukkan bahwa tinggi sumber bagian penutup dipertahankan. Nilai full menunjukkan bahwa tinggi bagian utama digunakan untuk bagian penutup.
  • Nilai default: -1.
BlendDuration String 2

Jumlah waktu antara akhir bagian utama dan awal bagian penutup. Selama transisi, frame terakhir bagian utama memudar, dan frame pertama bagian penutup muncul perlahan. Unit: detik. Nilai default: 0.

TailUrl String http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv

URL OSS bagian penutup.

TemplateId String S00000000-000010

ID template transkoding.

SubtitleConfig Objek

Konfigurasi subtitle.

ExtSubtitleList Larik ExtSubtitle

Daftar subtitle eksternal. Nilainya adalah larik JSON yang berisi hingga empat objek.

ExtSubtitle
CharEnc String UTF-8

Set karakter yang digunakan oleh subtitle eksternal.

  • Nilai yang valid: UTF-8, GBK, BIG5, dan auto.
  • Nilai default: auto.
Catatan Jika nilai parameter ini adalah auto, set karakter yang terdeteksi mungkin bukan set karakter aktual. Kami menyarankan Anda menggunakan set karakter tertentu.
FontName String "WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"

Font subtitle hard yang dikonversi dari subtitle eksternal. Nilai default: SimSun. Untuk informasi selengkapnya, lihat Font.

Input Objek

Objek OSS yang digunakan sebagai subtitle eksternal. Nilainya adalah objek JSON. File dalam format SRT atau ASS didukung.

Object String example-output.flv

Nama objek OSS yang digunakan sebagai file input.

Location String oss-cn-hangzhou

ID wilayah OSS tempat file input berada.

Bucket String example-bucket-****

Nama bucket OSS tempat file input disimpan.

SubtitleList Larik Subtitle

Daftar subtitle.

Subtitle
Map String 0:a:0

Track audio. Format: 0:{Stream}:{Nomor urut aliran}, yaitu 0:a:{audio_index}. Nilai Stream adalah a, yang menunjukkan aliran audio. Nomor urut adalah indeks aliran audio dalam daftar dan dimulai dari 0.

Properties Objek

Properti media.

Width String 1280

Lebar video.

Height String 720

Panjang video.

Duration String 55

Durasi video.

Fps String 25

Laju frame video. Nilainya adalah angka.

Bitrate String 1000

Bitrate video.

FileFormat String QuickTime / MOV

Format video.

Streams Objek

Informasi aliran.

VideoStreamList Larik VideoStream

Daftar aliran video.

VideoStream
Index String 0

Nomor urut aliran video. Nilai ini menunjukkan posisi aliran video di antara semua aliran video.

Timebase String 1/24000

Basis waktu aliran video.

AvgFPS String 23.976025

Laju frame rata-rata aliran video.

PixFmt String yuv420p

Format piksel aliran video.

Sar String 1:1

Rasio aspek sampel (SAR) aliran video.

Lang String eng

Bahasa aliran video. Untuk informasi selengkapnya, lihat Dokumentasi FFmpeg dan ISO 639.

CodecLongName String H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10

Nama lengkap format encoding.

Height String 720

Tinggi aliran video dalam piksel.

NumFrames String 25

Jumlah total frame.

Bitrate String 1496.46

Bitrate aliran video.

CodecTagString String avc1

String tag format encoding.

HasBFrames String 2

Menunjukkan apakah aliran video berisi frame bidirectional (B-frame).

Profile String high

Profil kodek.

StartTime String 0.000000

Titik awal waktu aliran video.

NetworkCost Objek

Bandwidth jaringan yang dikonsumsi.

PreloadTime String 8

Jumlah waktu preload.

AvgBitrate String 100

Bitrate rata-rata aliran video.

CostBandwidth String 10

Bandwidth maksimum yang dikonsumsi.

Dar String 16:9

Rasio aspek tampilan (DAR) aliran video.

CodecName String h264

Nama singkat format encoding.

Width String 1280

Lebar aliran video dalam piksel.

Duration String 17.225542

Durasi aliran video.

Fps String 23.976025

Laju frame aliran video.

CodecTag String 0x31637661

Tag format encoding.

CodecTimeBase String 1001/48000

Basis waktu codec.

Level String 51

Tingkat codec.

AudioStreamList Larik AudioStream

Daftar aliran audio.

AudioStream
Timebase String 1/44100

Basis waktu aliran audio.

Index String 1

Nomor urut aliran audio. Nilai ini menunjukkan posisi aliran audio di antara semua aliran audio.

SampleFmt String fltp

Format pengambilan sampel aliran audio.

ChannelLayout String stereo

Tata letak output saluran suara.

Lang String eng

Bahasa aliran audio. Untuk informasi selengkapnya, lihat Dokumentasi FFmpeg dan ISO 639.

Samplerate String 44100

Laju pengambilan sampel aliran audio.

CodecLongName String AAC (Advanced Audio Coding)

Nama lengkap format encoding.

Channels String 2

Jumlah saluran suara.

NumFrames String 25

Jumlah total frame.

Bitrate String 128.806

Bitrate aliran audio.

CodecTagString String mp4a

String tag dari format encoding.

StartTime String 0.000000

Titik awal waktu aliran audio.

CodecName String aac

Nama singkat format encoding.

Duration String 17.159546

Durasi aliran audio.

CodecTag String 0x6134706d

Tag format encoding.

CodecTimeBase String 1/44100

Basis waktu codec.

SubtitleStreamList Larik SubtitleStream

Daftar aliran subtitle.

SubtitleStream
Index String 1

Nomor urut aliran subtitle. Nilai ini menunjukkan posisi aliran subtitle di antara semua aliran subtitle.

Lang String eng

Bahasa aliran subtitle. Untuk informasi selengkapnya, lihat Dokumentasi FFmpeg dan ISO 639.

Format Objek

Informasi format.

StartTime String 0.000000

Waktu mulai.

NumPrograms String 0

Jumlah total aliran program.

Size String 3509895

Ukuran file.

NumStreams String 2

Jumlah total aliran media.

FormatLongName String QuickTime / MOV

Nama lengkap format kontainer.

Duration String 55

Durasi total.

Bitrate String 1000

Bitrate total.

FormatName String mov

Nama singkat format kontainer. Nilai yang valid: mov, mp4, m4a, 3gp, 3g2, dan mj2.

FileSize String 3509895

Ukuran file.

PipelineId String 88c6ca184c0e47098a5b665e2a126797

ID Antrian MPS.

Input Objek

Informasi tentang input pekerjaan.

Object String example.flv

Nama objek OSS yang digunakan sebagai input pekerjaan.

Location String oss-cn-hangzhou

ID wilayah OSS tempat input pekerjaan berada.

Bucket String example-bucket-****

Nama bucket OSS tempat input pekerjaan disimpan.

MNSMessageResult Objek

Pesan yang dikirim oleh MNS untuk memberi tahu Anda tentang hasil pekerjaan.

MessageId String 123

ID pesan kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.

ErrorMessage String The resource operated "%s" cannot be found.

Pesan kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.

ErrorCode String InvalidParameter.ResourceNotFound

Kode kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.

Success Boolean true

Menunjukkan apakah pekerjaan dibuat. Nilai yang valid:

  • true: Pekerjaan dibuat.
  • false: Pekerjaan gagal dibuat.
Code String InvalidParameter.NullValue

Kode kesalahan yang dikembalikan jika pekerjaan gagal dibuat. Parameter ini tidak dikembalikan jika pekerjaan berhasil dibuat.

Message String The specified parameter "%s" cannot be null.

Pesan kesalahan yang dikembalikan jika pekerjaan gagal dibuat. Parameter ini tidak dikembalikan jika pekerjaan berhasil dibuat.

RequestId String 25818875-5F78-4A45S71F6-D73936451234

ID permintaan.

Contoh

Permintaan contoh

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitJobs
&Input={"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "Parameter yang Anda atur di Konsol OSS untuk mengaktifkan fitur Perlindungan hotlink"}
&Outputs=[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff****","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47****"}],"UserData":"testid-001"}]
&OutputBucket=exampleBucket
&OutputLocation=oss-cn-hangzhou
&PipelineId=dd3dae411e704030b921e52698e5****
&<Common request parameters>

Respons keberhasilan contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<SubmitJobsResponse>
    <JobResultList>
        <Job>
            <CreationTime>2014-01-10T12:00:00Z</CreationTime>
            <Percent>100</Percent>
            <FinishTime>2014-01-10T12:20:00Z</FinishTime>
            <State>Submitted</State>
            <JobId>31fa3c9ca8134f9cec2b4b0b0f78****</JobId>
            <Code>InternalError</Code>
            <Message>The operation has failed due to some unknown error, exception or failure.</Message>
            <Output>
                <Video>
                    <Bufsize>1000</Bufsize>
                    <Degrain>5</Degrain>
                    <BitrateBnd>
                        <Max>20</Max>
                        <Min>10</Min>
                    </BitrateBnd>
                    <PixFmt>yuvj420p</PixFmt>
                    <Pad>1280:800:0:140</Pad>
                    <Codec>H.264</Codec>
                    <Height>1280</Height>
                    <Qscale>15</Qscale>
                    <Crop>1280:800:0:140</Crop>
                    <Bitrate>10</Bitrate>
                    <Maxrate>10</Maxrate>
                    <MaxFps>15</MaxFps>
                    <Profile>baseline</Profile>
                    <Crf>22</Crf>
                    <Gop>1</Gop>
                    <Width>1080</Width>
                    <Fps>60</Fps>
                    <Preset>veryfast</Preset>
                    <ScanMode>interlaced</ScanMode>
                    <ResoPriority>1</ResoPriority>
                </Video>
                <TransConfig>
                    <IsCheckAudioBitrate>false</IsCheckAudioBitrate>
                    <TransMode>onepass</TransMode>
                    <IsCheckReso>false</IsCheckReso>
                    <IsCheckVideoBitrateFail>true</IsCheckVideoBitrateFail>
                    <AdjDarMethod>crop</AdjDarMethod>
                    <IsCheckVideoBitrate>false</IsCheckVideoBitrate>
                    <IsCheckResoFail>false</IsCheckResoFail>
                    <IsCheckAudioBitrateFail>true</IsCheckAudioBitrateFail>
                </TransConfig>
                <Encryption>
                    <Type>hls-aes-128</Type>
                    <Key>encryptionkey128</Key>
                    <KeyType>Base64</KeyType>
                    <Id>31fa3c9ca8134f9cec2b4b0b0f78****</Id>
                    <KeyUri>https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/</KeyUri>
                    <SkipCnt>3</SkipCnt>
                </Encryption>
                <WaterMarkList>
                    <Type>Image</Type>
                    <ReferPos>TopRight</ReferPos>
                    <Dx>1</Dx>
                    <Width>1080</Width>
                    <Height>1280</Height>
                    <InputFile>
                        <Object>example-logo-****.png</Object>
                        <Location>oss-cn-hangzhou</Location>
                        <Bucket>example-bucket</Bucket>
                    </InputFile>
                    <WaterMarkTemplateId>88c6ca184c0e47098a5b665e2a12****</WaterMarkTemplateId>
                    <Dy>1</Dy>
                </WaterMarkList>
                <WaterMarkConfigUrl>http://example.com/configure</WaterMarkConfigUrl>
                <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}]}</DeWatermark>
                <M3U8NonStandardSupport>
                    <TS>
                        <SizeSupport>true</SizeSupport>
                        <Md5Support>true</Md5Support>
                    </TS>
                </M3U8NonStandardSupport>
                <Priority>5</Priority>
                <Audio>
                    <Profile>aac_low</Profile>
                    <Codec>aac</Codec>
                    <Samplerate>32000</Samplerate>
                    <Qscale>15</Qscale>
                    <Channels>6</Channels>
                    <Volume>
                        <Method>auto</Method>
                        <Level>-20</Level>
                    </Volume>
                    <Bitrate>128</Bitrate>
                </Audio>
                <AudioStreamMap>0:a:0</AudioStreamMap>
                <MergeList>
                    <Start>00000.50</Start>
                    <RoleArn>acs:ram::&lt;your uid&gt;:role/&lt;your role name&gt;</RoleArn>
                    <MergeURL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv</MergeURL>
                    <Duration>00000.20</Duration>
                </MergeList>
                <SuperReso>
                    <IsHalfSample>true</IsHalfSample>
                </SuperReso>
                <UserData>example data</UserData>
                <OutSubtitleList>
                    <Map>0:v:0</Map>
                    <OutSubtitleFile>
                        <RoleArn>acs:ram::&lt;your uid&gt;:role/&lt;your role name&gt;</RoleArn>
                        <Object>example-output.flv</Object>
                        <Location>oss-cn-hangzhou</Location>
                        <Bucket>example-bucket-****</Bucket>
                    </OutSubtitleFile>
                    <Success>true</Success>
                    <Message>The specified parameter "%s" cannot be null.</Message>
                </OutSubtitleList>
                <DigiWaterMark>
                    <Type>Image</Type>
                    <Alpha>1.0</Alpha>
                    <InputFile>
                        <Object>example-intput.flv</Object>
                        <Location>oss-cn-hangzhou</Location>
                        <Bucket>example-bucket-****</Bucket>
                    </InputFile>
                </DigiWaterMark>
                <VideoStreamMap>0:a:0</VideoStreamMap>
                <OutputFile>
                    <RoleArn>acs:ram::&lt;your uid&gt;:role/&lt;your role name&gt;</RoleArn>
                    <Object>example-output.flv</Object>
                    <Location>oss-cn-hangzhou</Location>
                    <Bucket>example-bucket-****</Bucket>
                </OutputFile>
                <AmixList>
                    <Map>0:a:0</Map>
                    <Start>0</Start>
                    <AmixURL>https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3</AmixURL>
                    <Duration>20</Duration>
                    <MixDurMode>long</MixDurMode>
                </AmixList>
                <Rotate>180</Rotate>
                <Container>
                    <Format>flv</Format>
                </Container>
                <Clip>
                    <TimeSpan>
                        <Seek>01:59:59.999</Seek>
                        <Duration>01:00:59.999</Duration>
                    </TimeSpan>
                </Clip>
                <MergeConfigUrl>`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}</MergeConfigUrl>
                <OpeningList>
                    <openUrl>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv</openUrl>
                    <Start>1</Start>
                    <Width>1920</Width>
                    <Height>1080</Height>
                </OpeningList>
                <MuxConfig>
                    <Webp>
                        <Loop>0</Loop>
                    </Webp>
                    <Gif>
                        <FinalDelay>0</FinalDelay>
                        <DitherMode>bayer</DitherMode>
                        <Loop>0</Loop>
                        <IsCustomPalette>false</IsCustomPalette>
                    </Gif>
                    <Segment>
                        <Duration>20</Duration>
                    </Segment>
                </MuxConfig>
                <TailSlateList>
                    <Start>1</Start>
                    <BgColor>White</BgColor>
                    <IsMergeAudio>false</IsMergeAudio>
                    <Width>1920</Width>
                    <Height>1080</Height>
                    <BlendDuration>2</BlendDuration>
                    <TailUrl>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv</TailUrl>
                </TailSlateList>
                <TemplateId>S00000000-000010</TemplateId>
                <SubtitleConfig>
                    <ExtSubtitleList>
                        <CharEnc>UTF-8</CharEnc>
                        <FontName>"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"</FontName>
                        <Input>
                            <Object>example-output.flv</Object>
                            <Location>oss-cn-hangzhou</Location>
                            <Bucket>example-bucket-****</Bucket>
                        </Input>
                    </ExtSubtitleList>
                    <SubtitleList>
                        <Map>0:a:0</Map>
                    </SubtitleList>
                </SubtitleConfig>
                <Properties>
                    <Width>1280</Width>
                    <Height>720</Height>
                    <Duration>55</Duration>
                    <Fps>25</Fps>
                    <Bitrate>1000</Bitrate>
                    <FileFormat>QuickTime / MOV</FileFormat>
                    <Streams>
                        <VideoStreamList>
                            <Index>0</Index>
                            <Timebase>1/24000</Timebase>
                            <AvgFPS>23.976025</AvgFPS>
                            <PixFmt>yuv420p</PixFmt>
                            <Sar>1:1</Sar>
                            <Lang>eng</Lang>
                            <CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
                            <Height>720</Height>
                            <NumFrames>25</NumFrames>
                            <Bitrate>1496.46</Bitrate>
                            <CodecTagString>avc1</CodecTagString>
                            <HasBFrames>2</HasBFrames>
                            <Profile>high</Profile>
                            <StartTime>0.000000</StartTime>
                            <NetworkCost>
                                <PreloadTime>8</PreloadTime>
                                <AvgBitrate>100</AvgBitrate>
                                <CostBandwidth>10</CostBandwidth>
                            </NetworkCost>
                            <Dar>16:9</Dar>
                            <CodecName>h264</CodecName>
                            <Width>1280</Width>
                            <Duration>17.225542</Duration>
                            <Fps>23.976025</Fps>
                            <CodecTag>0x31637661</CodecTag>
                            <CodecTimeBase>1001/48000</CodecTimeBase>
                            <Level>51</Level>
                        </VideoStreamList>
                        <AudioStreamList>
                            <Timebase>1/44100</Timebase>
                            <Index>1</Index>
                            <SampleFmt>fltp</SampleFmt>
                            <ChannelLayout>stereo</ChannelLayout>
                            <Lang>eng</Lang>
                            <Samplerate>44100</Samplerate>
                            <CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
                            <Channels>2</Channels>
                            <NumFrames>25</NumFrames>
                            <Bitrate>128.806</Bitrate>
                            <CodecTagString>mp4a</CodecTagString>
                            <StartTime>0.000000</StartTime>
                            <CodecName>aac</CodecName>
                            <Duration>17.159546</Duration>
                            <CodecTag>0x6134706d</CodecTag>
                            <CodecTimeBase>1/44100</CodecTimeBase>
                        </AudioStreamList>
                        <SubtitleStreamList>
                            <Index>1</Index>
                            <Lang>eng</Lang>
                        </SubtitleStreamList>
                    </Streams>
                    <Format>
                        <StartTime>0.000000</StartTime>
                        <NumPrograms>0</NumPrograms>
                        <Size>3509895</Size>
                        <NumStreams>2</NumStreams>
                        <FormatLongName>QuickTime / MOV</FormatLongName>
                        <Duration>55</Duration>
                        <Bitrate>1000</Bitrate>
                        <FormatName>mov</FormatName>
                    </Format>
                    <FileSize>3509895</FileSize>
                </Properties>
            </Output>
            <PipelineId>88c6ca184c0e47098a5b665e2a126797</PipelineId>
            <Input>
                <Object>example.flv</Object>
                <Location>oss-cn-hangzhou</Location>
                <Bucket>example-bucket-****</Bucket>
            </Input>
            <MNSMessageResult>
                <MessageId>123</MessageId>
                <ErrorMessage>The resource operated "%s" cannot be found.</ErrorMessage>
                <ErrorCode>InvalidParameter.ResourceNotFound</ErrorCode>
            </MNSMessageResult>
        </Job>
        <Success>true</Success>
        <Code>InvalidParameter.NullValue</Code>
        <Message>The specified parameter "%s" cannot be null.</Message>
    </JobResultList>
    <RequestId>25818875-5F78-4A45S71F6-D73936451234</RequestId>
</SubmitJobsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "JobResultList" : [ {
    "Job" : {
      "CreationTime" : "2014-01-10T12:00:00Z",
      "Percent" : 100,
      "FinishTime" : "2014-01-10T12:20:00Z",
      "State" : "Submitted",
      "JobId" : "31fa3c9ca8134f9cec2b4b0b0f78****",
      "Code" : "InternalError",
      "Message" : "Operasi gagal karena beberapa kesalahan, pengecualian, atau kegagalan yang tidak diketahui.",
      "Output" : {
        "Video" : {
          "Bufsize" : "1000",
          "Degrain" : "5",
          "BitrateBnd" : {
            "Max" : "20",
            "Min" : "10"
          },
          "PixFmt" : "yuvj420p",
          "Pad" : "1280:800:0:140",
          "Codec" : "H.264",
          "Height" : "1280",
          "Qscale" : "15",
          "Crop" : "1280:800:0:140",
          "Bitrate" : "10",
          "Maxrate" : "10",
          "MaxFps" : "15",
          "Profile" : "baseline",
          "Crf" : "22",
          "Gop" : "1",
          "Width" : "1080",
          "Fps" : "60",
          "Preset" : "veryfast",
          "ScanMode" : "interlaced",
          "ResoPriority" : "1"
        },
        "TransConfig" : {
          "IsCheckAudioBitrate" : "false",
          "TransMode" : "onepass",
          "IsCheckReso" : "false",
          "IsCheckVideoBitrateFail" : "true",
          "AdjDarMethod" : "crop",
          "IsCheckVideoBitrate" : "false",
          "IsCheckResoFail" : "false",
          "IsCheckAudioBitrateFail" : "true"
        },
        "Encryption" : {
          "Type" : "hls-aes-128",
          "Key" : "encryptionkey128",
          "KeyType" : "Base64",
          "Id" : "31fa3c9ca8134f9cec2b4b0b0f78****",
          "KeyUri" : "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
          "SkipCnt" : "3"
        },
        "WaterMarkList" : [ {
          "Type" : "Image",
          "ReferPos" : "TopRight",
          "Dx" : "1",
          "Width" : "1080",
          "Height" : "1280",
          "InputFile" : {
            "Object" : "example-logo-****.png",
            "Location" : "oss-cn-hangzhou",
            "Bucket" : "example-bucket"
          },
          "WaterMarkTemplateId" : "88c6ca184c0e47098a5b665e2a12****",
          "Dy" : "1"
        } ],
        "WaterMarkConfigUrl" : "http://example.com/configure",
        "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}]}",
        "M3U8NonStandardSupport" : {
          "TS" : {
            "SizeSupport" : true,
            "Md5Support" : true
          }
        },
        "Priority" : "5",
        "Audio" : {
          "Profile" : "aac_low",
          "Codec" : "aac",
          "Samplerate" : "32000",
          "Qscale" : "15",
          "Channels" : "6",
          "Volume" : {
            "Method" : "auto",
            "Level" : "-20"
          },
          "Bitrate" : "128"
        },
        "AudioStreamMap" : "0:a:0",
        "MergeList" : [ {
          "Start" : "00000.50",
          "RoleArn" : "acs:ram::<your uid>:role/<your role name>",
          "MergeURL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv",
          "Duration" : "00000.20"
        } ],
        "SuperReso" : {
          "IsHalfSample" : "true"
        },
        "UserData" : "example data",
        "OutSubtitleList" : [ {
          "Map" : "0:v:0",
          "OutSubtitleFile" : {
            "RoleArn" : "acs:ram::<your uid>:role/<your role name>",
            "Object" : "example-output.flv",
            "Location" : "oss-cn-hangzhou",
            "Bucket" : "example-bucket-****"
          },
          "Success" : true,
          "Message" : "Parameter yang ditentukan \"%s\" tidak boleh null."
        } ],
        "DigiWaterMark" : {
          "Type" : "Image",
          "Alpha" : "1.0",
          "InputFile" : {
            "Object" : "example-intput.flv",
            "Location" : "oss-cn-hangzhou",
            "Bucket" : "example-bucket-****"
          }
        },
        "VideoStreamMap" : "0:a:0",
        "OutputFile" : {
          "RoleArn" : "acs:ram::<your uid>:role/<your role name>",
          "Object" : "example-output.flv",
          "Location" : "oss-cn-hangzhou",
          "Bucket" : "example-bucket-****"
        },
        "AmixList" : [ {
          "Map" : "0:a:0",
          "Start" : "0",
          "AmixURL" : "https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3",
          "Duration" : "20",
          "MixDurMode" : "long"
        } ],
        "Rotate" : "180",
        "Container" : {
          "Format" : "flv"
        },
        "Clip" : {
          "TimeSpan" : {
            "Seek" : "01:59:59.999",
            "Duration" : "01:00:59.999"
          }
        },
        "MergeConfigUrl" : "`{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}",
        "OpeningList" : [ {
          "openUrl" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
          "Start" : "1",
          "Width" : "1920",
          "Height" : "1080"
        } ],
        "MuxConfig" : {
          "Webp" : {
            "Loop" : "0"
          },
          "Gif" : {
            "FinalDelay" : "0",
            "DitherMode" : "bayer",
            "Loop" : "0",
            "IsCustomPalette" : "false"
          },
          "Segment" : {
            "Duration" : "20"
          }
        },
        "TailSlateList" : [ {
          "Start" : "1",
          "BgColor" : "White",
          "IsMergeAudio" : false,
          "Width" : "1920",
          "Height" : "1080",
          "BlendDuration" : "2",
          "TailUrl" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
        } ],
        "TemplateId" : "S00000000-000010",
        "SubtitleConfig" : {
          "ExtSubtitleList" : [ {
            "CharEnc" : "UTF-8",
            "FontName" : "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
            "Input" : {
              "Object" : "example-output.flv",
              "Location" : "oss-cn-hangzhou",
              "Bucket" : "example-bucket-****"
            }
          } ],
          "SubtitleList" : [ {
            "Map" : "0:a:0"
          } ]
        },
        "Properties" : {
          "Width" : "1280",
          "Height" : "720",
          "Duration" : "55",
          "Fps" : "25",
          "Bitrate" : "1000",
          "FileFormat" : "QuickTime / MOV",
          "Streams" : {
            "VideoStreamList" : [ {
              "Index" : "0",
              "Timebase" : "1/24000",
              "AvgFPS" : "23.976025",
              "PixFmt" : "yuv420p",
              "Sar" : "1:1",
              "Lang" : "eng",
              "CodecLongName" : "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
              "Height" : "720",
              "NumFrames" : "25",
              "Bitrate" : "1496.46",
              "CodecTagString" : "avc1",
              "HasBFrames" : "2",
              "Profile" : "high",
              "StartTime" : "0.000000",
              "NetworkCost" : {
                "PreloadTime" : "8",
                "AvgBitrate" : "100",
                "CostBandwidth" : "10"
              },
              "Dar" : "16:9",
              "CodecName" : "h264",
              "Width" : "1280",
              "Duration" : "17.225542",
              "Fps" : "23.976025",
              "CodecTag" : "0x31637661",
              "CodecTimeBase" : "1001/48000",
              "Level" : "51"
            } ],
            "AudioStreamList" : [ {
              "Timebase" : "1/44100",
              "Index" : "1",
              "SampleFmt" : "fltp",
              "ChannelLayout" : "stereo",
              "Lang" : "eng",
              "Samplerate" : "44100",
              "CodecLongName" : "AAC (Advanced Audio Coding)",
              "Channels" : "2",
              "NumFrames" : "25",
              "Bitrate" : "128.806",
              "CodecTagString" : "mp4a",
              "StartTime" : "0.000000",
              "CodecName" : "aac",
              "Duration" : "17.159546",
              "CodecTag" : "0x6134706d",
              "CodecTimeBase" : "1/44100"
            } ],
            "SubtitleStreamList" : [ {
              "Index" : "1",
              "Lang" : "eng"
            } ]
          },
          "Format" : {
            "StartTime" : "0.000000",
            "NumPrograms" : "0",
            "Size" : "3509895",
            "NumStreams" : "2",
            "FormatLongName" : "QuickTime / MOV",
            "Duration" : "55",
            "Bitrate" : "1000",
            "FormatName" : "mov"
          },
          "FileSize" : "3509895"
        }
      },
      "PipelineId" : "88c6ca184c0e47098a5b665e2a126797",
      "Input" : {
        "Object" : "example.flv",
        "Location" : "oss-cn-hangzhou",
        "Bucket" : "example-bucket-****"
      },
      "MNSMessageResult" : {
        "MessageId" : "123",
        "ErrorMessage" : "Sumber daya yang dioperasikan \"%s\" tidak dapat ditemukan.",
        "ErrorCode" : "InvalidParameter.ResourceNotFound"
      }
    },
    "Success" : true,
    "Code" : "InvalidParameter.NullValue",
    "Message" : "Parameter yang ditentukan \"%s\" tidak boleh null."
  } ],
  "RequestId" : "25818875-5F78-4A45S71F6-D73936451234"
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.