All Products
Search
Document Center

Intelligent Media Services:SubmitTranscodeJob

Last Updated:Oct 12, 2026

Mengirimkan pekerjaan transkoding video atau audio ke Intelligent Media Services (IMS) dengan menentukan file sumber yang akan ditranskoding, format keluaran, dan parameter terkait.

Deskripsi operasi

  • Operasi ini akan dihentikan pada 31 Desember 2025. Panggil SubmitMediaConvertJob - Submit a media transcoding job sebagai gantinya.

  • Ini adalah operasi asinkron. Setelah Anda mengirimkan pekerjaan, ID pekerjaan akan dikembalikan. Pekerjaan belum selesai pada pengatur waktu ini dan masuk ke antrian latar belakang untuk eksekusi asinkron. Hasil akhir akan diberi tahu melalui callback. Anda juga dapat memanggil Query a transcoding job untuk secara aktif mengkueri status pekerjaan transkoding.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ice:SubmitTranscodeJob

*Semua sumber daya.

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Name

string

No

Nama pekerjaan.

job-name

InputGroup

array<object>

Yes

Kelompok masukan pekerjaan. Satu masukan menunjukkan pekerjaan transkoding. Beberapa masukan menunjukkan pekerjaan penggabungan aliran audio dan video.

job-name

object

Yes

Masukan pekerjaan.

Type

string

Yes

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Yes

Nilai media.

  • Jika Type diatur ke OSS, parameter ini menentukan URL. Protokol OSS dan HTTP didukung.

Catatan

Bucket OSS dalam URL harus ditambahkan ke modul Storage Management IMS sebelum digunakan.

  • Jika Type diatur ke Media, parameter ini menentukan ID aset media.

oss://bucket/path/to/video.mp4

InputUrl

string

No

Jalur aliran masukan.

  • Parameter ini hanya berlaku ketika Type diatur ke Media. Parameter ini memungkinkan Anda memilih file tertentu di bawah aset media sebagai masukan.

  • Sistem memeriksa apakah InputUrl ada di bawah aset media.

oss://bucket/path/to/video.mp4

OutputGroup

array<object>

Yes

Kelompok output tugas.

user-data

array<object>

Yes

Output tugas.

Output

object

Yes

Konfigurasi media output.

Type

string

Yes

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Yes

Nilai media.

  • Jika Type diatur ke OSS, parameter ini menentukan URL. Protokol OSS dan HTTP didukung.

Catatan

Bucket OSS dalam URL harus ditambahkan ke modul Storage Management IMS sebelum digunakan.

  • Jika Type diatur ke Media, parameter ini menentukan ID aset media.

oss://bucket/path/to/video.mp4

OutputUrl

string

No

Jalur aliran output. Parameter ini hanya berlaku ketika Type diatur ke Media, memungkinkan Anda memilih file tertentu di bawah aset media sebagai output. Placeholder yang didukung:

  • {MediaId}: ID aset media.

  • {JobId}: ID subtugas transkoding.

  • {MediaBucket}: Bucket tempat ID aset media berada.

  • {ExtName}: Ekstensi nama file, yang merupakan format output template transkoding.

  • {DestMd5}: Nilai hash MD5 dari file output transkoding.

Catatan
  1. Parameter ini harus berisi placeholder {MediaId} dan {JobId}.

  2. Bucket output harus sama dengan bucket tempat ID aset media berada.

oss://bucket/path/to/{MediaId}/{JobId}.mp4

ProcessConfig

object

Yes

Konfigurasi pemrosesan tugas.

Transcode

object

Yes

Konfigurasi transkoding.

TemplateId

string

Yes

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

No

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Video

object

No

Pengaturan video.

Codec

string

No

Kodek.

H.264

Profile

string

No

Profil pengkodean. Nilai valid:

  • garis dasar: Untuk perangkat seluler.

  • main: Untuk perangkat resolusi standar.

  • high: Untuk perangkat resolusi tinggi.

Nilai default: high.

Main

Bitrate

string

No

bitrate video rata-rata. Nilai valid: 10 hingga 50000. Unit: Kbit/s.

3000

Crf

string

No

Faktor laju konstan (CRF). Nilai valid: 0 hingga 51. Nilai default: 23 untuk H.264 dan 26 untuk H.265.

Catatan

Jika CRF ditentukan, pengaturan Bitrate menjadi tidak valid.

23

Width

string

No

Lebar. Nilai valid: 128 hingga 4096. Unit: piksel. Nilai default: lebar asli video.

1920

Height

string

No

Tinggi. Nilai valid: 128 hingga 4096. Unit: piksel. Nilai default: tinggi asli video.

1080

Fps

string

No

Laju frame. Nilai valid: (0,60]. Nilai default: laju frame file input.

Catatan

Jika laju frame file input melebihi 60, nilai 60 akan digunakan.

25

Gop

string

No

Jumlah frame maksimum antar keyframe. Nilai valid: 1 hingga 1080000. Nilai default: 250.

250

Preset

string

No

Preset algoritma video. Parameter ini hanya didukung untuk H.264. Nilai valid: veryfast, fast, Menengah, slow, dan slower. Nilai default: Menengah.

medium

ScanMode

string

No

Mode pemindaian. Nilai valid: interlaced dan progressive.

progressive

PixFmt

string

No

Format piksel video. Nilai valid: format warna standar seperti yuv420p dan yuvj420p.

yuv420p

Remove

string

No

Apakah akan menghapus aliran video.

false

Crop

string

No

Pengaturan pemangkasan video. Dua metode didukung:

  • Mendeteksi dan memangkas batas hitam secara otomatis. Atur parameter ini ke border.

  • Pemangkasan kustom. Format parameter: width:height:left:top. Contoh: 1280:800:0:140.

1280:800:0:140

Pad

string

No

Pengaturan padding video. Format parameter: width:height:left:top. Contoh: 1280:800:0:140.

1280:800:0:140

LongShortMode

string

No

Apakah akan mengaktifkan mode lanskap dan potret adaptif, yang menyesuaikan output berdasarkan sisi panjang dan pendek video.

false

Bufsize

string

No

Ukuran buffer. Nilai valid: 1000 hingga 128000. Nilai default: 6000. Unit: Kbit.

6000

Maxrate

string

No

bitrate video maksimum. Nilai valid: 10 hingga 50000. Unit: Kbit/s.

9000

AbrMax

string

No

bitrate adaptif (ABR) maksimum. Parameter ini hanya valid ketika Narrowband HD 1.0 diaktifkan. Nilai valid: 10 hingga 50000. Unit: Kbit/s.

6000

Audio

object

No

Pengaturan audio.

Codec

string

No

Kodek audio. Nilai valid: AAC, MP3, VORBIS, dan FLAC. Nilai default: AAC.

AAC

Profile

string

No

Profil pengkodean audio. Ketika Codec diatur ke AAC, nilai valid adalah aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld.

aac_low

Samplerate

string

No

Laju sampel. Nilai default: 44100. Nilai valid: 22050, 32000, 44100, 48000, dan 96000. Unit: Hz.

44100

Bitrate

string

No

bitrate audio file output. Nilai valid: 8 hingga 1000. Unit: Kbit/s. Nilai default: 128.

128

Channels

string

No

Jumlah saluran audio. Nilai default: 2.

2

Remove

string

No

Apakah akan menghapus aliran audio.

false

Volume

object

No

Pengaturan kontrol volume.

Method

string

No

Metode penyesuaian volume.

auto

IntegratedLoudnessTarget

string

No

Volume target.

-6

TruePeak

string

No

Volume puncak.

-1

LoudnessRangeTarget

string

No

Rentang kenyaringan.

8

Container

object

No

Pengaturan format kontainer.

Format

string

No

Format kontainer.

mp4

MuxConfig

object

No

Pengaturan multiplexing.

Segment

object

No

Pengaturan segmen.

Duration

string

No

Durasi segmen.

10

ForceSegTime

string

No

Titik pengatur waktu segmentasi paksa.

2,3

TransConfig

object

No

Parameter transkoding bersyarat.

TransMode

string

No

Mode transkoding video. Nilai valid:

  • onepass: Biasanya digunakan untuk ABR. Kecepatan pengkodean lebih cepat daripada twopass.

  • twopass: Biasanya digunakan untuk VBR. Kecepatan pengkodean lebih lambat daripada onepass.

  • CBR: Mode bitrate konstan. Nilai default: onepass.

onepass

IsCheckReso

string

No

Apakah akan memeriksa resolusi video. Anda hanya dapat menentukan salah satu dari IsCheckReso dan IsCheckResoFail. IsCheckResoFail memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa resolusi. Jika lebar atau tinggi resolusi video input lebih kecil dari pengaturan output, resolusi video input digunakan untuk transkoding.

  • false: Tidak memeriksa resolusi. Nilai default: false.

true

IsCheckResoFail

string

No

Apakah akan memeriksa resolusi video. Anda hanya dapat menentukan salah satu dari IsCheckReso dan IsCheckResoFail. Parameter ini memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa resolusi. Jika lebar atau tinggi resolusi video input lebih kecil dari pengaturan output, kegagalan transkoding akan dikembalikan.

  • false: Tidak memeriksa resolusi. Nilai default: false.

true

IsCheckVideoBitrate

string

No

Apakah akan memeriksa bitrate video. Anda hanya dapat menentukan salah satu dari IsCheckVideoBitrate dan IsCheckVideoBitrateFail. IsCheckVideoBitrateFail memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa bitrate. Jika bitrate video input lebih rendah dari pengaturan output, bitrate video input digunakan untuk transkoding.

  • false: Tidak memeriksa bitrate. Nilai default: false.

true

IsCheckVideoBitrateFail

string

No

Apakah akan memeriksa bitrate video. Anda hanya dapat menentukan salah satu dari IsCheckVideoBitrate dan IsCheckVideoBitrateFail. Parameter ini memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa bitrate. Jika bitrate video input lebih rendah dari pengaturan output, kegagalan transkoding akan dikembalikan.

  • false: Tidak memeriksa bitrate. Nilai default: false.

true

IsCheckAudioBitrate

string

No

Apakah akan memeriksa bitrate audio. Anda hanya dapat menentukan salah satu dari IsCheckAudioBitrate dan IsCheckAudioBitrateFail. IsCheckAudioBitrateFail memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa bitrate. Jika bitrate audio input lebih rendah dari pengaturan output, bitrate audio input digunakan untuk transkoding.

  • false: Tidak memeriksa bitrate. Nilai default:

  • false jika parameter kosong dan Kodek berbeda dari sumber input.

  • true jika parameter kosong dan Kodek sama dengan sumber input.

true

IsCheckAudioBitrateFail

string

No

Apakah akan memeriksa bitrate audio. Anda hanya dapat menentukan salah satu dari IsCheckAudioBitrate dan IsCheckAudioBitrateFail. Parameter ini memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa bitrate. Jika bitrate audio input lebih rendah dari pengaturan output, kegagalan transkoding akan dikembalikan.

  • false: Tidak memeriksa bitrate. Nilai default: false.

true

AdjDarMethod

string

No

Metode penyesuaian resolusi. Parameter ini hanya berlaku jika Width dan Height ditentukan. Dapat digunakan bersama dengan LongShortMode. Nilai valid: rescale, crop, pad, dan none. Nilai default: none.

none

ImageWatermarks

array<object>

No

Pengaturan watermark gambar.

array<object>

No

Pengaturan watermark gambar.

TemplateId

string

Yes

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

No

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Width

string

No

Lebar gambar watermark pada video output. Nilai dapat dalam salah satu format berikut:

  • Integer: Nilai piksel lebar gambar watermark.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio lebar gambar watermark terhadap lebar resolusi video output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

32

Height

string

No

Tinggi gambar watermark pada video output. Nilai dapat dalam salah satu format berikut:

  • Integer: Nilai piksel tinggi gambar watermark.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio tinggi gambar watermark terhadap tinggi resolusi video output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

32

Dx

string

No

Offset horizontal gambar watermark relatif terhadap video output. Nilai default: 0. Nilai dapat dalam salah satu format berikut:

  • Integer: Offset dalam piksel.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio offset horizontal terhadap lebar resolusi output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

10

Dy

string

No

Offset vertikal gambar watermark relatif terhadap video output. Nilai default: 0. Nilai dapat dalam salah satu format berikut:

  • Integer: Offset dalam piksel.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio offset vertikal terhadap tinggi resolusi output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

10

ReferPos

string

No

Posisi watermark.

  • Nilai valid: TopRight (kanan atas), TopLeft (kiri atas), BottomRight (kanan bawah), dan BottomLeft (kiri bawah).

  • Nilai default: TopRight.

TopLeft

Timeline

object

No

Pengaturan pengatur waktu tampilan untuk watermark dinamis.

Start

string

No

Pengatur waktu ketika watermark mulai muncul.

  • Unit: detik.

  • Nilai valid: nilai numerik.

  • Nilai default: 0.

00:00:05

Duration

string

No

Durasi watermark.

  • Nilai valid: [nilai numerik, ToEND].

  • Nilai default: ToEND.

ToEND

File

object

No

File gambar watermark.

Type

string

No

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

No

Nilai media.

  • Jika Type diatur ke OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP.

  • Jika Type diatur ke Media, nilai berupa ID aset media.

oss://bucket/path/to/video.mp4

TextWatermarks

array<object>

No

Pengaturan watermark teks.

array<object>

No

Pengaturan watermark teks.

TemplateId

string

Yes

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

No

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Content

string

No

Teks watermark. Pengkodean Base64 tidak diperlukan. String harus dikodekan dalam UTF-8.

Test watermark

FontName

string

No

Font. Nilai default: SimSun.

SimSun

FontColor

string

No

Warna.

#006400

FontAlpha

string

No

Transparansi font.

  • Nilai valid: (0, 1].

  • Nilai default: 1.0.

1.0

Top

string

No

Margin atas teks.

  • Nilai default: 0.

  • Nilai valid: 0 hingga 4096.

10

Left

string

No

Margin kiri teks.

  • Nilai default: 0.

  • Nilai valid: 0 hingga 4096.

10

FontSize

integer

No

Ukuran font.

  • Nilai default: 16.

  • Nilai valid: 5 hingga 119.

16

BorderWidth

integer

No

Lebar garis tepi.

  • Nilai default: 0.

  • Nilai valid: 1 hingga 4096.

0

BorderColor

string

No

Warna garis tepi. Nilai default: Black. Untuk nilai valid lainnya, lihat BorderColor.

#006400

Adaptive

string

No

Apakah akan menyesuaikan ukuran font berdasarkan ukuran video output. Nilai valid: true dan false. Nilai default: false.

false

Subtitles

array<object>

No

Konfigurasi burn-in subtitle.

array<object>

No

Konfigurasi burn-in subtitle.

TemplateId

string

Yes

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

No

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Format

string

No

Format file subtitle.

vtt

CharEnc

string

No

Format encoding file.

UTF-8

File

object

No

File subtitle.

Type

string

No

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

No

Nilai media.

  • Jika Type diatur ke OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP.

  • Jika Type diatur ke Media, nilai berupa ID aset media.

oss://bucket/path/to/video.mp4

Encryption

object

No

Konfigurasi enkripsi.

EncryptType

string

No

Tipe enkripsi. Nilai valid:

  • PrivateEncryption: Enkripsi khusus Alibaba Cloud.

  • HLSEncryption: Enkripsi standar HLS.

PrivateEncryption

CipherText

string

No

Ciphertext kunci enkripsi standar.

MTYi00NDU0LTg5O****

DecryptKeyUri

string

No

URL layanan dekripsi untuk enkripsi standar.

https://sample.com/path?CipherText=MTYi00NDU0LTg5O****

KeyServiceType

string

No

Tipe layanan kunci untuk enkripsi standar. Nilai valid:

  • KMS

  • Base64

KMS

CombineConfigs

array<object>

No

Konfigurasi pencampuran aliran multi-input.

object

No

Konfigurasi pencampuran aliran.

AudioIndex

string

Yes

Indeks aliran audio.

0 or exclude

VideoIndex

string

Yes

Indeks aliran video.

0 or exclude

Start

number

No

Pengatur waktu mulai aliran input. Nilai default: 0.

0.0

Duration

number

No

Durasi aliran input. Nilai default: durasi video.

20.0

UserData

string

No

Pengaturan kustom dalam format JSON. Panjang maksimum adalah 512 byte. Konfigurasi URL callback kustom didukung.

user-data

ScheduleConfig

object

No

Informasi penjadwalan tugas.

job-name

PipelineId

string

No

ID pipeline.

e37ebee5d98b4781897f6086e89f9c56

Priority

integer

No

Prioritas tugas. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Nilai valid: 1 hingga 10.

5

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

****12e8864746a0a398****

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

31E30781-9495-5E2D-A84D-759B0A01E262

TranscodeParentJob

object

TranscodeParentJobWithSubJobDTO.

TranscodeJobList

array<object>

Daftar pekerjaan anak.

array<object>

Detail pekerjaan anak.

CreateTime

string

Waktu pembuatan pekerjaan. Pengatur waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (diakhiri dengan Z).

2022-01-12T08:49:41Z

Name

string

Nama pekerjaan.

transcode-job

ParentJobId

string

ID pekerjaan induk.

8b2198504dd340b7b3c9842a74fc9baa

JobId

string

ID pekerjaan anak.

7d6a7e0d4db2457a8d45ff5d43e1bf0a

JobIndex

integer

Indeks pekerjaan anak dalam pekerjaan induk.

0

InputGroup

array<object>

Kelompok input pekerjaan. Satu input menunjukkan pekerjaan transkoding. Beberapa input menunjukkan pekerjaan penggabungan aliran audio dan aliran video.

object

Masukan pekerjaan.

Type

string

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Nilai media.

  • Jika Type diatur ke OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP.

  • Jika Type diatur ke Media, nilai berupa ID aset media.

oss://bucket/path/to/video.mp4

InputUrl

string

Jalur aliran input:

  • Parameter ini hanya berlaku ketika Type diatur ke Media, yang memungkinkan Anda memilih file tertentu di bawah aset media sebagai input.

  • Sistem memeriksa apakah inputUrl ada di bawah aset media.

oss://bucket/path/to/video.mp4

ProcessConfig

object

Konfigurasi transkoding.

Transcode

object

Konfigurasi transkoding.

TemplateId

string

ID template.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

Parameter timpa. Jika ditentukan, parameter ini menimpa parameter template terkait.

Video

object

Pengaturan video.

Codec

string

Format encoding.

H.264

Profile

string

Profil pengkodean.

Main

Bitrate

string

Laju bitrate video rata-rata.

3000

Crf

string

Laju faktor kontrol kualitas-bitrate.

23

Width

string

Lebar.

1920

Height

string

Tinggi.

1080

Fps

string

Laju frame.

25

Gop

string

Jumlah maksimum frame antar keyframe.

250

Preset

string

Preset penyandi video. Hanya H.264 yang mendukung parameter ini.

medium

ScanMode

string

Mode pemindaian.

progressive

PixFmt

string

Format piksel video.

yuv420p

Remove

string

Apakah akan menghapus aliran video.

false

Crop

string

Pengaturan pemotongan video. Dua metode didukung.

1280:800:0:140

Pad

string

Pengaturan padding video.

1280:800:0:140

LongShortMode

string

Apakah akan mengaktifkan adaptasi otomatis lanskap dan potret (mode sisi panjang-pendek).

false

Bufsize

string

Ukuran buffer.

6000

Maxrate

string

Laju bitrate video puncak.

9000

AbrMax

string

Laju bitrate maksimum ABR. Parameter ini hanya valid untuk Narrowband HD 1.0.

6000

Audio

object

Pengaturan audio.

Codec

string

Format Kodek audio. Nilai valid: AAC, MP3, VORBIS, dan FLAC.

AAC

Profile

string

Preset pengkodean audio.

aac_low

Samplerate

string

Laju sampel.

44100

Bitrate

string

Bitrate audio file output.

128

Channels

string

Jumlah saluran audio.

2

Remove

string

Apakah akan menghapus aliran audio.

false

Volume

object

Pengaturan kontrol volume.

Method

string

Metode penyesuaian volume.

auto

IntegratedLoudnessTarget

string

Target loudness terintegrasi.

-6

TruePeak

string

Volume Puncak.

-1

LoudnessRangeTarget

string

Rentang kenyaringan.

8

Container

object

Pengaturan format kontainer.

Format

string

Format kontainer.

mp4

MuxConfig

object

Pengaturan muxing.

Segment

object

Pengaturan segmen.

Duration

string

Durasi segmen.

10

ForceSegTime

string

Titik pengatur waktu segmen paksa.

2,3

TransConfig

object

Parameter transkoding bersyarat.

TransMode

string

Mode transkoding video. Nilai valid:

onepass

IsCheckReso

string

Apakah akan memeriksa resolusi video. Hanya satu dari IsCheckReso dan IsCheckResoFail yang dapat digunakan. IsCheckResoFail memiliki prioritas lebih tinggi.

true

IsCheckResoFail

string

Apakah akan memeriksa resolusi video. Hanya satu dari IsCheckReso dan IsCheckResoFail yang dapat digunakan. Parameter ini memiliki prioritas lebih tinggi.

true

IsCheckVideoBitrate

string

Apakah akan memeriksa laju bitrate video. Hanya satu dari IsCheckVideoBitrate dan IsCheckVideoBitrateFail yang dapat digunakan. IsCheckVideoBitrateFail memiliki prioritas lebih tinggi.

true

IsCheckVideoBitrateFail

string

Apakah akan memeriksa laju bitrate video. Hanya satu dari IsCheckVideoBitrate dan IsCheckVideoBitrateFail yang dapat digunakan. Parameter ini memiliki prioritas lebih tinggi.

true

IsCheckAudioBitrate

string

Apakah akan memeriksa laju bitrate audio. Hanya satu dari IsCheckAudioBitrate dan IsCheckAudioBitrateFail yang dapat digunakan. IsCheckAudioBitrateFail memiliki prioritas lebih tinggi.

true

IsCheckAudioBitrateFail

string

Apakah akan memeriksa laju bitrate audio. Hanya satu dari IsCheckAudioBitrate dan IsCheckAudioBitrateFail yang dapat digunakan. Parameter ini memiliki prioritas lebih tinggi.

true

AdjDarMethod

string

Metode penulisan ulang rasio aspek. Parameter ini hanya berlaku jika Width dan Height keduanya ditentukan. Dapat digunakan bersama dengan LongShortMode.

none

ImageWatermarks

array<object>

Pengaturan watermark gambar.

array<object>

Pengaturan watermark gambar.

TemplateId

string

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Width

string

Lebar gambar watermark pada video output. Nilai dapat dalam salah satu format berikut:

  • Integer: Nilai piksel lebar gambar watermark.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio lebar gambar watermark terhadap lebar resolusi video output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

32

Height

string

Tinggi gambar watermark pada video output. Nilai dapat dalam salah satu format berikut:

  • Integer: Nilai piksel tinggi gambar watermark.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio tinggi gambar watermark terhadap tinggi resolusi video output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

32

Dx

string

Offset horizontal gambar watermark relatif terhadap video output. Nilai default: 0. Nilai dapat dalam salah satu format berikut:

  • Integer: Offset dalam piksel.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio offset horizontal terhadap lebar resolusi output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

10

Dy

string

Offset vertikal gambar watermark relatif terhadap video output. Nilai default: 0. Nilai dapat dalam salah satu format berikut:

  • Integer: Offset dalam piksel.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio offset vertikal terhadap tinggi resolusi output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

10

ReferPos

string

Posisi watermark.

  • Nilai valid: TopRight (kanan atas), TopLeft (kiri atas), BottomRight (kanan bawah), dan BottomLeft (kiri bawah).

  • Nilai default: TopRight.

TopLeft

Timeline

object

Pengaturan pengatur waktu tampilan untuk watermark dinamis.

Start

string

Pengatur waktu saat watermark mulai muncul.

  • Unit: detik.

  • Nilai valid: nilai numerik.

  • Nilai default: 0.

00:00:05

Duration

string

Durasi watermark.

  • Nilai valid: [nilai numerik, ToEND].

  • Nilai default: ToEND.

ToEND

File

object

File gambar watermark.

Type

string

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Nilai media.

  • Jika Type diatur ke OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP.

  • Jika Type diatur ke Media, nilai berupa ID aset media.

oss://bucket/path/to/video.mp4

TextWatermarks

array<object>

Pengaturan watermark teks.

array<object>

Pengaturan watermark teks.

TemplateId

string

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Content

string

Teks watermark. Pengkodean Base64 tidak diperlukan. String harus dikodekan dalam UTF-8.

Test watermark

FontName

string

Font. Nilai default: SimSun.

SimSun

FontColor

string

Warna.

#006400

FontAlpha

string

Transparansi font.

  • Nilai valid: (0, 1].

  • Nilai default: 1.0.

1.0

Top

string

Margin atas teks.

  • Nilai default: 0.

  • Nilai valid: 0 hingga 4096.

10

Left

string

Margin kiri teks.

  • Nilai default: 0.

  • Nilai valid: 0 hingga 4096.

10

FontSize

integer

Ukuran font.

  • Nilai default: 16.

  • Nilai valid: 5 hingga 119.

16

BorderWidth

integer

Lebar garis tepi.

  • Nilai default: 0.

  • Nilai valid: 1 hingga 4096.

0

BorderColor

string

Warna garis tepi. Nilai default: Black. Untuk nilai valid lainnya, lihat BorderColor.

#006400

Adaptive

string

Apakah akan menyesuaikan ukuran font berdasarkan ukuran video output. Nilai valid: true dan false. Nilai default: false.

false

Subtitles

array<object>

Konfigurasi burn-in subtitle.

array<object>

Konfigurasi burn-in subtitle.

TemplateId

string

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Format

string

Format file subtitle.

vtt

CharEnc

string

Format encoding file.

UTF-8

File

object

File subtitle.

Type

string

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Nilai media.

  • Jika Type diatur ke OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP.

  • Jika Type diatur ke Media, nilai berupa ID aset media.

oss://bucket/path/to/video.mp4

Encryption

object

Konfigurasi enkripsi.

EncryptType

string

Jenis enkripsi.

PrivateEncryption

CipherText

string

Ciphertext kunci enkripsi standar.

MTYi00NDU0LTg5O****

DecryptKeyUri

string

URL layanan dekripsi untuk enkripsi standar.

https://sample.com/path?CipherText=MTYi00NDU0LTg5O****

KeyServiceType

string

Jenis layanan kunci. Hanya KMS dan Base64 yang didukung.

KMS

CombineConfigs

array<object>

Konfigurasi pencampuran aliran multi-input.

object

Konfigurasi pencampuran aliran.

AudioIndex

string

Indeks aliran audio.

0 or exclude

VideoIndex

string

Indeks aliran video.

0 or exclude

Start

number

Waktu mulai aliran input. Nilai default: 0.

0.0

Duration

number

Durasi aliran input. Nilai default: durasi video.

20.0

Output

object

Konfigurasi media output.

Type

string

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Nilai media.

  • Jika Type diatur ke OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP.

  • Jika Type diatur ke Media, nilai berupa ID aset media.

oss://bucket/path/to/video.mp4

OutputUrl

string

Jalur aliran keluar. Parameter ini hanya berlaku ketika Type diatur ke Media. Parameter ini memungkinkan Anda memilih file tertentu di bawah aset media sebagai keluaran. Placeholder yang didukung:

  • {MediaId}: ID aset media.

  • {JobId}: ID subtugas transkoding.

  • {MediaBucket}: bucket tempat ID aset media berada.

  • {ExtName}: ekstensi nama file, yaitu format keluaran dari template transkoding.

  • {DestMd5}: nilai hash MD5 dari file keluaran transkoding. Catatan:

  1. Parameter ini harus mengandung placeholder {MediaId} dan {JobId}.

  2. Bucket keluaran harus sama dengan bucket tempat MediaId berada.

oss://bucket/path/to/{MediaId}/{JobId}.mp4

UserData

string

Data pengguna.

user-data

ScheduleConfig

object

Informasi penjadwalan tugas.

PipelineId

string

ID pipeline.

e37ebee5d98b4781897f6086e89f9c56

Priority

integer

Prioritas tugas. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Nilai valid: 1 hingga 10.

5

Status

string

Status pekerjaan transkoding. Nilai valid:

  • Init: Dikirim.

  • Processing: Mentranskoding.

  • Success: Transkoding berhasil.

  • Fail: Transkoding gagal.

  • Deleted: Dihapus.

Init

OutFileMeta

object

Informasi media video yang dihasilkan.

FileBasicInfo

object

Informasi file dasar.

MediaId

string

ID aset media.

73e07de0f77171eca3fc7035d0b26402

FileName

string

Nama file.

file.m3u8

FileStatus

string

Status file.

Normal

FileType

string

Tipe file. Nilai valid: source_file dan transcode_file.

source_file

FileSize

string

Ukuran file. Unit: byte.

31737

FileUrl

string

URL file.

http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8

Region

string

Wilayah tempat file berada.

cn-shanghai

FormatName

string

Nama format video.

hls,applehttp

Duration

string

Durasi video. Unit: detik.

403.039999

Bitrate

string

bitrate video.

888.563

Width

string

Lebar.

848

Height

string

Tinggi.

478

AudioStreamInfoList

array<object>

Informasi aliran audio.

object

Informasi aliran audio.

Index

string

Indeks aliran.

1

CodecName

string

Kodek.

aac

CodecLongName

string

Nama panjang kodek.

AAC (Advanced Audio Coding)

CodecTimeBase

string

Basis pengatur waktu kodek.

1/44100

CodecTagString

string

String tag kodek.

[15][0][0][0]

CodecTag

string

Tag kodek.

0x000f

SampleFmt

string

Format sampel.

fltp

SampleRate

string

Laju sampel. Unit: Hz.

44100

Channels

string

Jumlah saluran.

2

ChannelLayout

string

Tata letak saluran.

stereo

Timebase

string

Basis pengatur waktu.

1/90000

StartTime

string

Pengatur waktu mulai. Unit: detik.

1.473556

Duration

string

Durasi. Unit: detik.

403.039989

Bitrate

string

bitrate.

0.f

Lang

string

Bahasa.

cn

VideoStreamInfoList

array<object>

Informasi aliran video.

object

Informasi aliran video.

Index

string

Indeks aliran.

0

Codec_name

string

Kodek.

h264

Codec_long_name

string

Nama panjang kodek.

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

Profile

string

Profil penyandi.

High

Codec_time_base

string

Basis pengatur waktu kodek.

1/50

Codec_tag_string

string

String tag kodek.

[27][0][0][0]

Codec_tag

string

Tag kodek.

0x001b

Width

string

Lebar.

848

Height

string

Tinggi.

478

Has_b_frames

string

Apakah B-frame ada. Nilai valid:

  • 0: Tidak ada B-frame.

  • 1: Satu B-frame.

  • 2: Beberapa B-frame berurutan.

2

Sar

string

Rasio aspek sampel.

478:477

Dar

string

Rasio aspek tampilan.

16:9

PixFmt

string

Format piksel.

yuv420p

Level

string

Tingkat pengkodean.

31

Fps

string

Laju frame.

25.0

Avg_fps

string

Laju frame rata-rata.

25.0

Time_base

string

Basis pengatur waktu.

1/90000

Start_time

string

Pengatur waktu mulai, dalam detik.

1.473556

Duration

string

Durasi. Unit: detik.

403.039989

Bit_rate

string

bitrate.

888.563

NumFrames

string

Jumlah total frame.

10040

Lang

string

Bahasa.

cn

Rotate

string

Sudut rotasi video. Nilai valid: 0, 90, 180, dan 270. Nilai default: 0.

0

SubmitResultJson

object

Hasil pengiriman pekerjaan.

{}

SubmitTime

string

Pengatur waktu pengiriman pekerjaan. Waktu dalam format ISO 8601 dan UTC (diakhiri dengan Z).

2022-01-12T08:49:41Z

FinishTime

string

Pengatur waktu penyelesaian pekerjaan. Waktu dalam format ISO 8601 dan UTC (diakhiri dengan Z).

2022-01-12T08:49:41Z

RequestId

string

ID permintaan untuk pengiriman pekerjaan.

31E30781-9495-5E2D-A84D-759B0A01E262

CreateTime

string

Pengatur waktu pembuatan pekerjaan. Format: yyyy-MM-ddTHH:mm:ssZ.

2022-01-12T08:49:41Z

Name

string

Nama pekerjaan.

transcode-job

RequestId

string

ID permintaan untuk pengiriman pekerjaan.

31E30781-9495-5E2D-A84D-759B0A01E262

ParentJobId

string

ID pekerjaan induk.

8b2198504dd340b7b3c9842a74fc9baa

JobCount

integer

Jumlah pekerjaan turunan.

1

Status

string

Status pekerjaan. Nilai valid: Success (setidaknya satu pekerjaan turunan berhasil setelah semua pekerjaan turunan selesai) dan Fail (semua pekerjaan turunan gagal).

Success

TriggerSource

string

Sumber pekerjaan. Nilai valid: API, WorkFlow, dan Console.

API

Percent

integer

Persentase penyelesaian pekerjaan.

0

SubmitTime

string

Pengatur waktu pengiriman pekerjaan. Format: yyyy-MM-ddTHH:mm:ssZ.

2022-01-12T08:49:41Z

FinishTime

string

Pengatur waktu penyelesaian pekerjaan. Format: yyyy-MM-ddTHH:mm:ssZ.

2022-01-12T08:49:41Z

InputGroup

array<object>

Kelompok input pekerjaan. Input tunggal menunjukkan pekerjaan transkoding. Beberapa input menunjukkan pekerjaan penggabungan aliran audio dan aliran video.

object

Masukan pekerjaan.

Type

string

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Nilai media.

  • Jika Type diatur ke OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP.

  • Jika Type diatur ke Media, nilai berupa ID aset media.

oss://bucket/path/to/video.mp4

OutputGroup

array<object>

Kelompok output tugas.

array<object>

Output pekerjaan.

Output

object

Konfigurasi media output.

Type

string

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Nilai media.

  • Jika Type diatur ke OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP.

  • Jika Type diatur ke Media, nilai berupa ID aset media.

oss://bucket/path/to/video.mp4

ProcessConfig

object

Konfigurasi pemrosesan tugas.

Transcode

object

Konfigurasi transkoding.

TemplateId

string

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Video

object

Pengaturan video.

Codec

string

Kodek.

H.264

Profile

string

Profil pengkodean. Nilai valid:

  • garis dasar: Untuk perangkat shift.

  • main: Untuk perangkat resolusi standar.

  • high: Untuk perangkat resolusi tinggi.

Nilai default: high.

Main

Bitrate

string

bitrate video rata-rata.

  • Nilai valid: 10 hingga 50000.

  • Unit: Kbit/s.

3000

Crf

string

Faktor laju konstan (CRF) untuk kontrol kualitas-bitrate.

  • Nilai valid: 0 hingga 51.

  • Nilai default: 23 untuk H.264 dan 26 untuk H.265.

Jika Crf ditentukan, pengaturan Bitrate menjadi tidak valid.

23

Width

string

Lebar.

  • Nilai valid: 128 hingga 4096.

  • Unit: piksel.

  • Nilai default: Lebar asli video.

1920

Height

string

Tinggi.

  • Nilai valid: 128 hingga 4096.

  • Unit: piksel.

  • Nilai default: Tinggi asli video.

1080

Fps

string

Laju frame.

  • Nilai valid: (0, 60].

  • Jika laju frame file input melebihi 60, nilai diatur ke 60.

  • Nilai default: Laju frame file input.

25

Gop

string

Jumlah frame maksimum antar keyframe.

  • Nilai valid: 1 hingga 1080000.

  • Nilai default: 250.

250

Preset

string

Preset algoritma video. Parameter ini hanya didukung untuk H.264. Nilai valid: veryfast, fast, medium, slow, dan slower. Nilai default: medium.

medium

ScanMode

string

Mode pemindaian. Nilai valid: interlaced dan progressive.

progressive

PixFmt

string

Format piksel video. Nilai valid: format warna standar seperti yuv420p dan yuvj420p.

yuv420p

Remove

string

Apakah akan menghapus aliran video.

false

Crop

string

Pengaturan pemotongan video. Dua metode didukung:

  • Deteksi dan pemotongan otomatis batas hitam. Atur nilai menjadi "border".

  • Pemotongan kustom. Format parameter: width:height:left:top. Contoh: 1280:800:0:140.

1280:800:0:140

Pad

string

Pengaturan padding video untuk menambahkan batas hitam.

  • Format parameter: width:height:left:top.

  • Contoh: 1280:800:0:140.

1280:800:0:140

LongShortMode

string

Apakah akan mengaktifkan mode lanskap dan potret adaptif, yang menyesuaikan output berdasarkan sisi panjang dan pendek video.

false

Bufsize

string

Ukuran buffer.

  • Nilai valid: 1000 hingga 128000.

  • Nilai default: 6000.

  • Unit: Kb.

6000

Maxrate

string

Bitrate video puncak.

  • Nilai valid: 10 hingga 50000.

  • Unit: Kbit/s.

9000

AbrMax

string

Bitrate adaptif (ABR) maksimum. Parameter ini hanya valid untuk Narrowband HD 1.0.

  • Nilai valid: 10 hingga 50000.

  • Unit: Kbit/s.

6000

Audio

object

Pengaturan audio.

Codec

string

Format kodek audio. Nilai valid: AAC, MP3, VORBIS, dan FLAC. Nilai default: AAC.

AAC

Profile

string

Profil pengkodean audio. Ketika Codec diatur ke AAC, nilai valid adalah aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld.

aac_low

Samplerate

string

Laju pengambilan sampel audio.

  • Nilai default: 44100. Nilai valid: 22050, 32000, 44100, 48000, dan 96000.

  • Unit: Hz.

44100

Bitrate

string

Bitrate audio file output.

  • Nilai valid: 8 hingga 1000.

  • Unit: Kbit/s.

  • Nilai default: 128.

128

Channels

string

Jumlah saluran audio. Nilai default: 2.

2

Remove

string

Apakah akan menghapus aliran audio.

false

Volume

object

Pengaturan kontrol volume.

Method

string

Metode penyesuaian volume.

auto

IntegratedLoudnessTarget

string

Volume target.

-6

TruePeak

string

Volume puncak.

-1

LoudnessRangeTarget

string

Rentang kenyaringan.

8

Container

object

Pengaturan format kontainer.

Format

string

Format kontainer.

mp4

MuxConfig

object

Pengaturan multiplexing.

Segment

object

Pengaturan segmen.

Duration

string

Durasi segmen.

10

ForceSegTime

string

Titik pengatur waktu segmentasi paksa.

2,3

TransConfig

object

Parameter transkoding bersyarat.

TransMode

string

Mode transkoding video. Nilai valid:

  • onepass: Biasanya digunakan untuk ABR. Kecepatan pengkodean lebih cepat daripada twopass.

  • twopass: Biasanya digunakan untuk VBR. Kecepatan pengkodean lebih lambat daripada onepass.

  • CBR: Mode bitrate konstan. Nilai default: onepass.

onepass

IsCheckReso

string

Apakah akan memeriksa resolusi video. Anda hanya dapat menentukan salah satu dari IsCheckReso dan IsCheckResoFail. IsCheckResoFail memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa resolusi. Jika lebar atau tinggi resolusi video input lebih kecil dari pengaturan output, resolusi video input digunakan untuk transkoding.

  • false: Tidak memeriksa resolusi. Nilai default: false.

true

IsCheckResoFail

string

Apakah akan memeriksa resolusi video. Anda hanya dapat menentukan salah satu dari IsCheckReso dan IsCheckResoFail. Parameter ini memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa resolusi. Jika lebar atau tinggi resolusi video input lebih kecil dari pengaturan output, kegagalan transkoding akan dikembalikan.

  • false: Tidak memeriksa resolusi. Nilai default: false.

true

IsCheckVideoBitrate

string

Apakah akan memeriksa bitrate video. Anda hanya dapat menentukan salah satu dari IsCheckVideoBitrate dan IsCheckVideoBitrateFail. IsCheckVideoBitrateFail memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa bitrate. Jika bitrate video input lebih rendah dari pengaturan output, bitrate video input digunakan untuk transkoding.

  • false: Tidak memeriksa bitrate. Nilai default: false.

true

IsCheckVideoBitrateFail

string

Apakah akan memeriksa bitrate video. Anda hanya dapat menentukan salah satu dari IsCheckVideoBitrate dan IsCheckVideoBitrateFail. Parameter ini memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa bitrate. Jika bitrate video input lebih rendah dari pengaturan output, kegagalan transkoding dikembalikan.

  • false: Tidak memeriksa bitrate. Nilai default: false.

true

IsCheckAudioBitrate

string

Apakah akan memeriksa bitrate audio. Anda hanya dapat menentukan salah satu dari IsCheckAudioBitrate dan IsCheckAudioBitrateFail. IsCheckAudioBitrateFail memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa bitrate. Jika bitrate audio input lebih rendah dari pengaturan output, bitrate audio input digunakan untuk transkoding.

  • false: Tidak memeriksa bitrate. Nilai default:

  • false jika parameter kosong dan kodek berbeda dari sumber input.

  • true jika parameter kosong dan kodek sama dengan sumber input.

true

IsCheckAudioBitrateFail

string

Apakah akan memeriksa bitrate audio. Anda hanya dapat menentukan salah satu dari IsCheckAudioBitrate dan IsCheckAudioBitrateFail. Parameter ini memiliki prioritas lebih tinggi. Nilai valid:

  • true: Memeriksa bitrate. Jika bitrate audio input lebih rendah dari pengaturan output, kegagalan transkoding dikembalikan.

  • false: Tidak memeriksa bitrate. Nilai default: false.

true

AdjDarMethod

string

Metode penyesuaian resolusi. Parameter ini hanya berlaku jika Width dan Height ditentukan. Dapat digunakan bersama dengan LongShortMode. Nilai valid: rescale, crop, pad, dan none. Nilai default: none.

none

ImageWatermarks

array<object>

Pengaturan watermark gambar.

array<object>

Pengaturan watermark gambar.

TemplateId

string

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Width

string

Lebar gambar watermark pada video output. Nilai dapat dalam salah satu format berikut:

  • Integer: Nilai piksel lebar gambar watermark.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio lebar gambar watermark terhadap lebar resolusi video output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

32

Height

string

Tinggi gambar watermark pada video output. Nilai dapat dalam salah satu format berikut:

  • Integer: Nilai piksel tinggi gambar watermark.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio tinggi gambar watermark terhadap tinggi resolusi video output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

32

Dx

string

Offset horizontal gambar watermark relatif terhadap video output. Nilai default: 0. Nilai dapat dalam salah satu format berikut:

  • Integer: Offset dalam piksel.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio offset horizontal terhadap lebar resolusi output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

10

Dy

string

Offset vertikal gambar watermark relatif terhadap video output. Nilai default: 0. Nilai dapat dalam salah satu format berikut:

  • Integer: Offset dalam piksel.
    • Nilai valid: [8, 4096].

    • Unit: px.

  • Desimal: Rasio offset vertikal terhadap tinggi resolusi output.
    • Nilai valid: (0, 1).

    • Hingga empat tempat desimal didukung, seperti 0.9999. Tempat desimal tambahan secara otomatis dibuang oleh sistem.

10

ReferPos

string

Posisi watermark.

  • Nilai valid: TopRight (kanan atas), TopLeft (kiri atas), BottomRight (kanan bawah), dan BottomLeft (kiri bawah).

  • Nilai default: TopRight.

TopLeft

Timeline

object

Pengaturan pengatur waktu tampilan untuk watermark dinamis.

Start

string

Pengatur waktu ketika watermark mulai muncul.

  • Unit: detik.

  • Nilai valid: nilai numerik.

  • Nilai default: 0.

00:00:05

Duration

string

Durasi watermark.

  • Nilai valid: [nilai numerik, ToEND].

  • Nilai default: ToEND.

ToEND

File

object

File gambar watermark.

Type

string

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Nilai media.

  • Jika Type diatur ke OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP.

  • Jika Type diatur ke Media, nilai berupa ID aset media.

oss://bucket/path/to/video.mp4

TextWatermarks

array<object>

Pengaturan watermark teks.

array<object>

Pengaturan watermark teks.

TemplateId

string

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Content

string

Teks watermark. Pengkodean Base64 tidak diperlukan. String harus dikodekan dalam UTF-8.

Test watermark

FontName

string

Font. Nilai default: SimSun.

SimSun

FontColor

string

Warna.

#006400

FontAlpha

string

Transparansi font.

  • Nilai valid: (0, 1].

  • Nilai default: 1.0.

1.0

Top

string

Margin atas teks.

  • Nilai default: 0.

  • Nilai valid: 0 hingga 4096.

10

Left

string

Margin kiri teks.

  • Nilai default: 0.

  • Nilai valid: 0 hingga 4096.

10

FontSize

integer

Ukuran font.

  • Nilai default: 16.

  • Nilai valid: 5 hingga 119.

16

BorderWidth

integer

Lebar garis tepi.

  • Nilai default: 0.

  • Nilai valid: 1 hingga 4096.

0

BorderColor

string

Warna garis tepi. Nilai default: Black. Untuk nilai valid lainnya, lihat BorderColor.

#006400

Adaptive

string

Apakah akan menyesuaikan ukuran font berdasarkan ukuran video keluaran.

  • true: false

  • default: false

false

Subtitles

array<object>

Konfigurasi burn-in subtitle.

array<object>

Konfigurasi burn-in subtitle.

TemplateId

string

ID templat.

9547c6ad97cb4f2aaa29683ebd18d410

OverwriteParams

object

Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.

Format

string

Format file subtitle.

vtt

CharEnc

string

Format encoding file.

UTF-8

File

object

File subtitle.

Type

string

Tipe objek media. Nilai valid:

  • OSS: File OSS

  • Media: ID aset media

OSS

Media

string

Nilai media. Ketika Type diatur ke OSS, nilainya adalah URL. Protokol OSS dan HTTP didukung. Ketika Type diatur ke Media, nilainya adalah ID aset media.

oss://bucket/path/to/video.mp4

Encryption

object

Konfigurasi enkripsi.

EncryptType

string

Jenis enkripsi.

PrivateEncryption

CipherText

string

Ciphertext kunci enkripsi standar.

MTYi00NDU0LTg5O****

DecryptKeyUri

string

URL layanan dekripsi untuk enkripsi standar.

https://sample.com/path?CipherText=MTYi00NDU0LTg5O****

KeyServiceType

string

Jenis layanan kunci. Hanya KMS dan Base64 yang didukung.

KMS

CombineConfigs

array<object>

Konfigurasi pencampuran aliran multi-input.

object

Konfigurasi pencampuran aliran multi-input.

AudioIndex

string

Indeks aliran audio.

0 or exclude

VideoIndex

string

Indeks aliran video.

0 or exclude

Start

number

Pengatur waktu mulai aliran input. Nilai default: 0.

0.0

Duration

number

Durasi aliran input. Nilai default: durasi video.

20.0

UserData

string

Data pengguna.

user-data

ScheduleConfig

object

Konfigurasi penjadwalan pekerjaan.

PipelineId

string

ID pipeline.

e37ebee5d98b4781897f6086e89f9c56

Priority

integer

Prioritas tugas. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Nilai valid: 1 hingga 10.

5

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.