All Products
Search

This Product

    Intelligent Media Services:GetTranscodeJob

    Document Center

    Intelligent Media Services:GetTranscodeJob

    Last Updated:Jun 15, 2026

    Mengkueri detail satu job transcoding.

    Deskripsi operasi

    API ini sudah tidak digunakan lagi. Gunakan GetMediaConvertJob – Kueri job transcoding media sebagai gantinya.

    Coba sekarang

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

    Test

    RAM authorization

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

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

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

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

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

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

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

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

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

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ice:GetTranscodeJob

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ParentJobId

    string

    Yes

    ID Job

    ab4802364a2e49208c99efab82dfa8e8

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Respons.

    RequestId

    string

    ID Permintaan.

    9EDC30DC-0050-5459-B788-F761B2BE359B
    TranscodeParentJob

    object

    TranscodeParentJobWithSubJobDTO

    TranscodeJobList

    array<object>

    Daftar sub-job.

    array<object>

    Sub-job.

    CreateTime

    string

    Waktu pembuatan job.

    2022-01-12T08:49:41Z
    Name

    string

    Nama job.

    transcode-job
    ParentJobId

    string

    ID job induk.

    8b2198504dd340b7b3c9842a74fc9baa
    JobId

    string

    ID sub-job.

    7d6a7e0d4db2457a8d45ff5d43e1bf0a
    JobIndex

    integer

    Indeks sub-job dalam job induk.

    0
    InputGroup

    array<object>

    Grup input job. Input tunggal menunjukkan tugas transcode. Input ganda menunjukkan tugas penggabungan audio/video.

    object

    Input job.

    Type

    string

    Jenis objek media. Nilai valid:

    • OSS: File OSS.

    • Media: ID Media.

    OSS
    Media

    string

    Nilai media:

    • Jika type adalah OSS, nilainya adalah URL. Protokol OSS dan protokol HTTP didukung.

    • Jika type adalah Media, nilainya adalah ID media.

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

    string

    URL stream media. Atur parameter ini hanya saat melakukan transcode stream media.

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

    object

    Konfigurasi pemrosesan transcode.

    Transcode

    object

    Konfigurasi transcode.

    TemplateId

    string

    ID Template.

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    Parameter pengganti. Jika ditentukan, parameter ini akan menggantikan parameter template yang sesuai.

    Video

    object

    Pengaturan video.

    Codec

    string

    Format codec.

    H.264
    Profile

    string

    Profil encoding. Nilai yang didukung: baseline, main, high.

    • baseline: untuk perangkat mobile.

    • main: untuk perangkat resolusi standar.

    • high: untuk perangkat resolusi tinggi.

    Nilai default: high.

    Main
    Bitrate

    string

    Bitrate rata-rata video.

    • Nilai valid: [10, 50000].

    • Satuan: Kbps.

    3000
    Crf

    string

    Faktor kontrol kualitas-bitrate.

    • Nilai valid: [0, 51].

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

    Jika CRF diatur, pengaturan Bitrate diabaikan.

    23
    Width

    string

    Lebar.

    • Nilai valid: [128, 4096].

    • Satuan: px.

    Nilai default: lebar video asli.

    1920
    Height

    string

    Tinggi.

    • Nilai valid: [128, 4096].

    • Satuan: px.

    Nilai default: tinggi video asli.

    1080
    Fps

    string

    Frame rate.

    • Nilai valid: (0, 60].

    • Jika frame rate file input melebihi 60, nilai 60 digunakan.

    • Nilai default: frame rate file input.

    25
    Gop

    string

    Jumlah frame maksimum antara keyframe.

    • Nilai valid: [1, 1080000].

    • Nilai default: 250.

    250
    Preset

    string

    Preset encoder video. Hanya H.264 yang mendukung parameter ini. Nilai yang didukung: veryfast, fast, medium, slow, slower.

    Nilai default: medium.

    medium
    ScanMode

    string

    Mode scan. Nilai yang didukung: interlaced, progressive.

    progressive
    PixFmt

    string

    Format piksel video. Nilai valid: yuv420p, yuvj420p, dan format piksel standar lainnya.

    yuv420p
    Remove

    string

    Apakah akan menghapus video.

    false
    Crop

    string

    Pemotongan video. Dua metode didukung:

    • Deteksi dan pemotongan black bar otomatis: atur ke "border".

    • Pemotongan kustom. Format: width:height:left:top.

    1280:800:0:140
    Pad

    string

    Padding video. Format: width:height:left:top.

    1280:800:0:140
    LongShortMode

    string

    Apakah akan mengaktifkan mode adaptif landscape/portrait (mode sisi panjang-pendek).

    false
    Bufsize

    string

    Ukuran buffer.

    • Nilai valid: [1000, 128000].

    • Nilai default: 6000.

    • Satuan: Kb.

    6000
    Maxrate

    string

    Bitrate video puncak.

    • Nilai valid: [10, 50000].

    • Satuan: Kbps.

    9000
    AbrMax

    string

    Bitrate ABR maksimum (hanya berlaku untuk Narrowband HD 1.0).

    • Nilai valid: [10, 50000].

    • Satuan: Kbps.

    6000
    Audio

    object

    Pengaturan audio.

    Codec

    string

    Format codec audio: AAC, MP3, VORBIS, FLAC. Nilai default: AAC.

    AAC
    Profile

    string

    Preset encoding audio. Jika Codec adalah AAC, nilai valid: aac_low, aac_he, aac_he_v2, aac_ld, aac_eld.

    aac_low
    Samplerate

    string

    Sample rate.

    • Nilai default: 44100.

    • Nilai yang didukung: 22050, 32000, 44100, 48000, 96000.

    • Satuan: Hz.

    44100
    Bitrate

    string

    Bitrate audio file output.

    • Nilai valid: [8, 1000].

    • Satuan: Kbps.

    • Nilai default: 128.

    128
    Channels

    string

    Jumlah kanal audio. Nilai default: 2.

    2
    Remove

    string

    Apakah akan menghapus stream audio.

    false
    Volume

    object

    Kontrol volume.

    Method

    string

    Metode penyesuaian volume.

    auto
    IntegratedLoudnessTarget

    string

    Target loudness.

    -6
    TruePeak

    string

    True peak.

    -1
    LoudnessRangeTarget

    string

    Rentang loudness.

    8
    Container

    object

    Pengaturan format container.

    Format

    string

    Format container.

    mp4
    MuxConfig

    object

    Pengaturan mux.

    Segment

    object

    Pengaturan segmen.

    Duration

    string

    Durasi segmen.

    10
    ForceSegTime

    string

    Titik waktu segmen paksa.

    2,3
    TransConfig

    object

    Parameter transcode bersyarat.

    TransMode

    string

    Mode transcode video. Nilai valid:

    • onepass: umumnya digunakan untuk ABR. Kecepatan encoding lebih cepat dari twopass.

    • twopass: umumnya digunakan untuk VBR. Kecepatan encoding lebih lambat dari onepass.

    • CBR: mode bitrate konstan.

    Nilai default: onepass.

    onepass
    IsCheckReso

    string

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

    • true: Periksa. Jika resolusi video input (lebar atau tinggi) lebih rendah dari pengaturan output, transcode pada resolusi video input.

    • false: Jangan periksa.

    Nilai default: false.

    true
    IsCheckResoFail

    string

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

    • true: Periksa. Jika resolusi video input (lebar atau tinggi) lebih rendah dari pengaturan output, kegagalan transcode dikembalikan.

    • false: Jangan periksa.

    Nilai default: false.

    true
    IsCheckVideoBitrate

    string

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

    • true: Periksa. Jika bitrate video input lebih rendah dari pengaturan output, transcode pada bitrate video input.

    • false: Jangan periksa.

    Nilai default: false.

    true
    IsCheckVideoBitrateFail

    string

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

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

    • false: Jangan periksa.

    Nilai default: false.

    true
    IsCheckAudioBitrate

    string

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

    • true: Periksa. Jika bitrate audio input lebih rendah dari pengaturan output, transcode pada bitrate audio input.

    • false: Jangan periksa.

    Nilai default:

    • Jika parameter kosong dan codec berbeda dari sumber input: false.

    • Jika parameter kosong dan codec sama dengan sumber input: true.

    true
    IsCheckAudioBitrateFail

    string

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

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

    • false: Jangan periksa.

    Nilai default: false.

    true
    AdjDarMethod

    string

    Metode penulisan ulang resolusi. Hanya berlaku jika Width dan Height keduanya ditentukan. Dapat digunakan bersama dengan LongShortMode.

    Nilai valid: rescale, crop, pad, none.

    Nilai default: none.

    Untuk contoh, lihat Cara mengatur resolusi.

    none
    Tags

    object

    string

    ImageWatermarks

    array<object>

    Konfigurasi watermark gambar.

    array<object>

    Konfigurasi watermark gambar.

    TemplateId

    string

    ID Template.

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    Parameter pengganti. Jika ditentukan, parameter ini akan menggantikan parameter template yang sesuai.

    Width

    string

    Lebar.

    32
    Height

    string

    Tinggi.

    32
    Dx

    string

    Posisi watermark, x.

    10
    Dy

    string

    Posisi watermark, y.

    10
    ReferPos

    string

    Posisi referensi: TopLeft, TopRight, BottomLeft, BottomRight. Nilai default: TopLeft.

    TopLeft
    Timeline

    object

    Pengaturan timeline tampilan.

    Start

    string

    Waktu mulai.

    00:00:05
    Duration

    string

    Durasi tampilan, dalam detik atau "ToEND".

    ToEND
    File

    object

    File gambar watermark.

    Type

    string

    Jenis objek media. Nilai valid:

    • OSS: File OSS.

    • Media: ID Media.

    OSS
    Media

    string

    Nilai media:

    • Jika type adalah OSS, nilainya adalah URL. Protokol OSS dan protokol HTTP didukung.

    • Jika type adalah Media, nilainya adalah ID media.

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

    array<object>

    Konfigurasi watermark teks.

    array<object>

    Konfigurasi watermark teks.

    TemplateId

    string

    ID Template.

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    Parameter pengganti. Jika ditentukan, parameter ini akan menggantikan parameter template yang sesuai.

    Content

    string

    Teks watermark. Encoding Base64 tidak diperlukan. String harus dienkode UTF-8.

    test watermark
    FontName

    string

    Font.

    SimSun
    FontColor

    string

    Warna.

    #006400
    FontAlpha

    string

    Opasitas.

    1.0
    Top

    string

    Posisi watermark, jarak dari atas.

    10
    Left

    string

    Posisi watermark, jarak dari kiri.

    10
    FontSize

    integer

    Ukuran font.

    16
    BorderWidth

    integer

    Lebar border.

    0
    BorderColor

    string

    Warna border.

    #006400
    Adaptive

    string

    Apakah akan menyesuaikan ukuran font berdasarkan dimensi video output. true / false, default: false.

    false
    Subtitles

    array<object>

    Konfigurasi overlay subtitle.

    array<object>

    Konfigurasi overlay subtitle.

    TemplateId

    string

    ID Template

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    Parameter pengganti. Jika ditentukan, parameter ini akan menggantikan parameter template yang sesuai.

    Format

    string

    Format file subtitle.

    vtt
    CharEnc

    string

    Format encoding file.

    UTF-8
    File

    object

    File subtitle.

    Type

    string

    Jenis objek media. Nilai valid:

    • OSS: File OSS.

    • Media: ID Media.

    OSS
    Media

    string

    Nilai media:

    • Jika type adalah OSS, nilainya adalah URL. Protokol OSS dan protokol HTTP didukung.

    • Jika type adalah Media, nilainya adalah ID media.

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

    object

    Konfigurasi enkripsi.

    EncryptType

    string

    Jenis enkripsi.

    PrivateEncryption
    CipherText

    string

    Ciphertext kunci enkripsi.

    MTYi00NDU0LTg5O****
    DecryptKeyUri

    string

    URL layanan dekripsi untuk enkripsi standar.

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

    string

    Jenis layanan kunci. Saat ini hanya KMS dan Base64 yang didukung.

    KMS
    CombineConfigs

    array<object>

    Konfigurasi penggabungan multi-input

    object

    AudioIndex

    string

    Indeks stream audio

    0 or exclude
    VideoIndex

    string

    Indeks stream video

    0 or exclude
    Start

    number

    Waktu mulai stream input. Nilai default: 0.

    0.0
    Duration

    number

    Durasi stream input. Nilai default: durasi video.

    20.0
    IsInheritTags

    boolean

    Apakah akan mewarisi tag dari stream input. Parameter ini tidak berlaku jika input bukan aset media. Nilai default: false.

    true
    Output

    object

    Konfigurasi media output.

    Type

    string

    Jenis objek media. Nilai valid:

    • OSS: File OSS.

    • Media: ID Media.

    OSS
    Media

    string

    Nilai media:

    • Jika type adalah OSS, nilainya adalah URL. Protokol OSS dan protokol HTTP didukung.

    • Jika type adalah Media, nilainya adalah ID media.

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

    string

    URL stream output transcode. Atur parameter ini hanya jika output adalah stream media.

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

    UserData

    string

    Data pengguna.

    user-data
    ScheduleConfig

    object

    Konfigurasi penjadwalan.

    PipelineId

    string

    ID Pipeline.

    e37ebee5d98b4781897f6086e89f9c56
    Priority

    integer

    Prioritas job. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Nilai valid: 1 sampai 10.

    5
    Status

    string

    Status tugas transcode.

    • Init: Dikirim.

    • Processing: Sedang transcode.

    • Success: Transcode berhasil.

    • Fail: Transcode gagal.

    • Deleted: Dihapus.

    Init
    OutFileMeta

    object

    Informasi media file output.

    FileBasicInfo

    object

    Informasi dasar file.

    MediaId

    string

    ID Media.

    486c2890096871edba6f81848c016303
    FileName

    string

    Nama file.

    file.m3u8
    FileStatus

    string

    Status file.

    Normal
    FileType

    string

    Jenis file. Nilai valid: source_file, transcode_file.

    source_file
    FileSize

    string

    Ukuran file. Satuan: Byte.

    31737
    FileUrl

    string

    URL File.

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

    string

    Region tempat file berada.

    cn-shanghai
    FormatName

    string

    Nama format video.

    hls,applehttp
    Duration

    string

    Durasi video (satuan: detik).

    403.039999
    Bitrate

    string

    Bitrate video.

    888.563
    Width

    string

    Lebar.

    848
    Height

    string

    Tinggi.

    478
    AudioStreamInfoList

    array<object>

    Informasi stream audio.

    object

    Informasi stream audio.

    Index

    string

    Indeks stream.

    1
    CodecName

    string

    Format codec.

    aac
    CodecLongName

    string

    Nama codec.

    AAC (Advanced Audio Coding)
    CodecTimeBase

    string

    Time base codec.

    1/44100
    CodecTagString

    string

    String tag codec.

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

    string

    Tag codec.

    0x000f
    SampleFmt

    string

    Format sampel.

    fltp
    SampleRate

    string

    Sample rate (satuan: Hz).

    44100
    Channels

    string

    Jumlah kanal audio.

    2
    ChannelLayout

    string

    Tata letak kanal.

    stereo
    Timebase

    string

    Time base codec.

    1/90000
    StartTime

    string

    Waktu mulai.

    1.473556
    Duration

    string

    Durasi (satuan: detik).

    403.039989
    Bitrate

    string

    Bitrate.

    0.f
    Lang

    string

    Bahasa.

    cn
    VideoStreamInfoList

    array<object>

    Informasi stream video.

    object

    Informasi stream video.

    Index

    string

    Indeks stream.

    0
    Codec_name

    string

    Format codec.

    h264
    Codec_long_name

    string

    Nama codec.

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

    string

    Preset encoder.

    High
    Codec_time_base

    string

    Time base codec.

    1/50
    Codec_tag_string

    string

    String tag codec.

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

    string

    Tag codec.

    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 berturut-turut.

    2
    Sar

    string

    Sample aspect ratio (SAR).

    478:477
    Dar

    string

    Display aspect ratio (DAR).

    16:9
    PixFmt

    string

    Format piksel.

    yuv420p
    Level

    string

    Level encoding.

    31
    Fps

    string

    Frame rate.

    25.0
    Avg_fps

    string

    Frame rate rata-rata.

    25.0
    Time_base

    string

    Time base.

    1/90000
    Start_time

    string

    Waktu mulai.

    1.473556
    Duration

    string

    Durasi (satuan: 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, 270. Nilai default: 0.

    0
    SubmitResultJson

    object

    Hasil pengiriman job.

    {}
    SubmitTime

    string

    Waktu pengiriman job.

    2022-01-12T08:49:41Z
    FinishTime

    string

    Waktu selesai job.

    2022-01-12T08:49:41Z
    RequestId

    string

    ID Request saat pengiriman job.

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

    string

    Waktu pembuatan job. Format: yyyy-MM-ddTHH:mm:ssZ.

    2022-01-12T08:49:41Z
    Name

    string

    Nama job.

    transcode-job
    RequestId

    string

    ID Permintaan saat pengiriman job.

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

    string

    ID job induk.

    8b2198504dd340b7b3c9842a74fc9baa
    JobCount

    integer

    Jumlah sub-job.

    1
    Status

    string

    Status job.

    • Success: Semua sub-job berhasil diselesaikan.

    • Fail: Semua sub-job gagal.

    Success
    TriggerSource

    string

    Sumber job.

    • API: API

    • WorkFlow: Workflow

    • Console: Konsol

    API
    Percent

    integer

    Persentase penyelesaian job.

    0
    SubmitTime

    string

    Waktu pengiriman job. Format: yyyy-MM-ddTHH:mm:ssZ.

    2022-01-12T08:49:41Z
    FinishTime

    string

    Waktu penyelesaian job. Format: yyyy-MM-ddTHH:mm:ssZ.

    2022-01-12T08:49:41Z
    InputGroup

    array<object>

    Grup input job. Satu input mewakili job transcoding. Beberapa input mewakili job penggabungan audio-video.

    object

    Input job.

    Type

    string

    Jenis objek media. Nilai valid:

    • OSS: File OSS.

    • Media: ID Media.

    OSS
    Media

    string

    Nilai media:

    • Jika type adalah OSS, nilainya adalah URL. Protokol OSS dan protokol HTTP didukung.

    • Jika type adalah Media, nilainya adalah ID media.

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

    array<object>

    Grup output job.

    array<object>

    Output job.

    Output

    object

    Konfigurasi media output.

    Type

    string

    Jenis objek media. Nilai valid:

    • OSS: File OSS.

    • Media: ID Media.

    OSS
    Media

    string

    Nilai media:

    • Jika type adalah OSS, nilainya adalah URL. Protokol OSS dan protokol HTTP didukung.

    • Jika type adalah Media, nilainya adalah ID media.

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

    string

    URL stream output.

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

    ProcessConfig

    object

    Konfigurasi pemrosesan job.

    Transcode

    object

    Konfigurasi transcode.

    TemplateId

    string

    ID Template.

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    Parameter pengganti. Jika ditentukan, parameter ini akan menggantikan parameter template yang sesuai.

    Video

    object

    Pengaturan video.

    Codec

    string

    Format codec.

    H.264
    Profile

    string

    Profil encoding. Nilai yang didukung: baseline, main, high.

    • baseline: untuk perangkat mobile.

    • main: untuk perangkat resolusi standar.

    • high: untuk perangkat resolusi tinggi.

    Nilai default: high.

    Main
    Bitrate

    string

    Bitrate rata-rata video.

    • Nilai valid: [10, 50000].

    • Satuan: Kbps.

    3000
    Crf

    string

    Faktor kontrol kualitas-bitrate.

    • Nilai valid: [0, 51].

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

    • Jika CRF diatur, pengaturan Bitrate diabaikan.

    23
    Width

    string

    Lebar.

    • Nilai valid: [128, 4096].

    • Satuan: px.

    • Nilai default: lebar video asli.

    1920
    Height

    string

    Tinggi.

    • Nilai valid: [128, 4096].

    • Satuan: px.

    • Nilai default: tinggi video asli.

    1080
    Fps

    string

    Frame rate.

    • Nilai valid: (0, 60].

    • Jika frame rate file input melebihi 60, nilai 60 digunakan.

    • Nilai default: frame rate file input.

    25
    Gop

    string

    Jumlah frame maksimum antara keyframe.

    • Nilai valid: [1, 1080000].

    • Nilai default: 250.

    250
    Preset

    string

    Preset encoder video. Hanya H.264 yang mendukung parameter ini. Nilai yang didukung: veryfast, fast, medium, slow, slower. Nilai default: medium.

    medium
    ScanMode

    string

    Mode scan. Nilai yang didukung: interlaced, progressive.

    progressive
    PixFmt

    string

    Format piksel video. Nilai valid: yuv420p, yuvj420p, dan format piksel standar lainnya.

    yuv420p
    Remove

    string

    Apakah akan menghapus video.

    false
    Crop

    string

    Pemotongan video. Dua metode didukung:

    • Deteksi dan pemotongan black bar otomatis: atur ke "border".

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

    1280:800:0:140
    Pad

    string

    Padding video.

    • Format: width:height:left:top.

    • Contoh: 1280:800:0:140.

    1280:800:0:140
    LongShortMode

    string

    Apakah akan mengaktifkan mode adaptif landscape/portrait (mode sisi panjang-pendek).

    false
    Bufsize

    string

    Ukuran buffer.

    • Nilai valid: [1000, 128000].

    • Nilai default: 6000.

    • Satuan: Kb.

    6000
    Maxrate

    string

    Bitrate video puncak.

    • Nilai valid: [10, 50000].

    • Satuan: Kbps.

    9000
    AbrMax

    string

    Bitrate ABR maksimum (hanya berlaku untuk Narrowband HD 1.0).

    • Nilai valid: [10, 50000].

    • Satuan: Kbps.

    6000
    Audio

    object

    Pengaturan audio.

    Codec

    string

    Format codec audio: AAC, MP3, VORBIS, FLAC. Nilai default: AAC.

    AAC
    Profile

    string

    Preset encoding audio. Jika Codec adalah AAC, nilai valid: aac_low, aac_he, aac_he_v2, aac_ld, aac_eld.

    aac_low
    Samplerate

    string

    Sample rate.

    • Nilai default: 44100.

    • Nilai yang didukung: 22050, 32000, 44100, 48000, 96000.

    • Satuan: Hz.

    44100
    Bitrate

    string

    Bitrate audio file output.

    • Nilai valid: [8, 1000].

    • Satuan: Kbps.

    • Nilai default: 128.

    128
    Channels

    string

    Jumlah kanal audio. Nilai default: 2.

    2
    Remove

    string

    Apakah akan menghapus stream audio.

    false
    Volume

    object

    Kontrol volume.

    Method

    string

    Metode penyesuaian volume.

    auto
    IntegratedLoudnessTarget

    string

    Target loudness.

    -6
    TruePeak

    string

    True peak.

    -1
    LoudnessRangeTarget

    string

    Rentang loudness.

    8
    Container

    object

    Pengaturan format container.

    Format

    string

    Format container.

    mp4
    MuxConfig

    object

    Pengaturan mux.

    Segment

    object

    Pengaturan segmen.

    Duration

    string

    Durasi segmen.

    10
    ForceSegTime

    string

    Titik waktu segmen paksa.

    2,3
    TransConfig

    object

    Parameter transcode bersyarat.

    TransMode

    string

    Mode transcode video. Nilai valid:

    • onepass: umumnya digunakan untuk ABR. Kecepatan encoding lebih cepat dari twopass.

    • twopass: umumnya digunakan untuk VBR. Kecepatan encoding lebih lambat dari onepass.

    • CBR: mode bitrate konstan.

    Nilai default: onepass.

    onepass
    IsCheckReso

    string

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

    • true: Periksa. Jika resolusi video input (lebar atau tinggi) lebih rendah dari pengaturan output, transcode pada resolusi video input.

    • false: Jangan periksa.

    Nilai default: false.

    true
    IsCheckResoFail

    string

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

    • true: Periksa. Jika resolusi video input (lebar atau tinggi) lebih rendah dari pengaturan output, kegagalan transcode dikembalikan.

    • false: Jangan periksa.

    Nilai default: false.

    true
    IsCheckVideoBitrate

    string

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

    • true: Periksa. Jika bitrate video input lebih rendah dari pengaturan output, transcode pada bitrate video input.

    • false: Jangan periksa.

    Nilai default: false.

    true
    IsCheckVideoBitrateFail

    string

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

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

    • false: Jangan periksa.

    Nilai default: false.

    true
    IsCheckAudioBitrate

    string

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

    • true: Periksa. Jika bitrate audio input lebih rendah dari pengaturan output, transcode pada bitrate audio input.

    • false: Jangan periksa.

    Nilai default:

    • Jika parameter kosong dan codec berbeda dari sumber input: false.

    • Jika parameter kosong dan codec sama dengan sumber input: true.

    true
    IsCheckAudioBitrateFail

    string

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

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

    • false: Jangan periksa.

    Nilai default: false.

    true
    AdjDarMethod

    string

    Metode penulisan ulang resolusi. Hanya berlaku jika Width dan Height keduanya ditentukan. Dapat digunakan bersama dengan LongShortMode.

    Nilai valid: rescale, crop, pad, none.

    Nilai default: none.

    none
    ImageWatermarks

    array<object>

    Konfigurasi watermark gambar.

    array<object>

    Konfigurasi watermark gambar.

    TemplateId

    string

    ID Template.

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    Parameter pengganti. Jika ditentukan, parameter ini akan menggantikan parameter template yang sesuai.

    Width

    string

    Lebar.

    32
    Height

    string

    Tinggi.

    32
    Dx

    string

    Posisi watermark, x.

    10
    Dy

    string

    Posisi watermark, y.

    10
    ReferPos

    string

    Posisi referensi: TopLeft, TopRight, BottomLeft, BottomRight. Nilai default: TopLeft.

    TopLeft
    Timeline

    object

    Pengaturan timeline tampilan.

    Start

    string

    Waktu mulai.

    00:00:05
    Duration

    string

    Durasi tampilan, dalam detik atau "ToEND".

    ToEND
    File

    object

    File gambar watermark.

    Type

    string

    Jenis objek media. Nilai valid:

    • OSS: File OSS.

    • Media: ID Media.

    OSS
    Media

    string

    Nilai media:

    • Jika type adalah OSS, nilainya adalah URL. Protokol OSS dan protokol HTTP didukung.

    • Jika type adalah Media, nilainya adalah ID media.

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

    array<object>

    Konfigurasi watermark teks.

    array<object>

    Konfigurasi watermark teks.

    TemplateId

    string

    ID Template.

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    Parameter pengganti. Jika ditentukan, parameter ini akan menggantikan parameter template yang sesuai.

    Content

    string

    Teks watermark. Encoding Base64 tidak diperlukan. String harus dienkode UTF-8.

    test watermark
    FontName

    string

    Font.

    SimSun
    FontColor

    string

    Warna.

    #006400
    FontAlpha

    string

    Opasitas.

    1.0
    Top

    string

    Posisi watermark, jarak dari atas.

    10
    Left

    string

    Posisi watermark, jarak dari kiri.

    10
    FontSize

    integer

    Ukuran font.

    16
    BorderWidth

    integer

    Lebar border.

    0
    BorderColor

    string

    Warna border.

    #006400
    Adaptive

    string

    Apakah akan menyesuaikan ukuran font berdasarkan dimensi video output. true / false, default: false.

    false
    Subtitles

    array<object>

    Konfigurasi overlay subtitle.

    array<object>

    Konfigurasi overlay subtitle.

    TemplateId

    string

    ID Template.

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    Parameter pengganti. Jika ditentukan, parameter ini akan menggantikan parameter template yang sesuai.

    Format

    string

    Format file subtitle.

    vtt
    CharEnc

    string

    Format encoding file.

    UTF-8
    File

    object

    File subtitle.

    Type

    string

    Jenis objek media. Nilai valid:

    • OSS: File OSS.

    • Media: ID Media.

    OSS
    Media

    string

    Nilai media:

    • Jika type adalah OSS, nilainya adalah URL. Protokol OSS dan protokol HTTP didukung.

    • Jika type adalah Media, nilainya adalah ID media.

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

    object

    Konfigurasi enkripsi.

    EncryptType

    string

    Jenis enkripsi.

    PrivateEncryption
    CipherText

    string

    Ciphertext kunci enkripsi.

    MTYi00NDU0LTg5O****
    DecryptKeyUri

    string

    URL layanan dekripsi untuk enkripsi standar.

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

    string

    Jenis layanan kunci. Saat ini hanya KMS dan Base64 yang didukung.

    KMS
    CombineConfigs

    array<object>

    Konfigurasi penggabungan multi-input

    object

    Konfigurasi penggabungan multi-input

    AudioIndex

    string

    Indeks stream audio

    0 or exclude
    VideoIndex

    string

    Indeks stream video

    0 or exclude
    Start

    number

    Waktu mulai stream input. Nilai default: 0.

    0.0
    Duration

    number

    Durasi stream input. Nilai default: durasi video.

    20.0
    UserData

    string

    Data pengguna.

    user-data
    ScheduleConfig

    object

    Konfigurasi penjadwalan job.

    PipelineId

    string

    ID Pipeline.

    e37ebee5d98b4781897f6086e89f9c56
    Priority

    integer

    Prioritas job. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Nilai valid: 1 sampai 10.

    5

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.