All Products
Search

This Product

    Intelligent Media Services:SubmitLiveEditingJob

    Document Center

    Intelligent Media Services:SubmitLiveEditingJob

    Last Updated:Jun 11, 2026

    Pengeditan langsung merujuk pada penyusunan satu atau beberapa segmen aliran langsung menjadi produk jadi. Setelah mengirimkan pekerjaan pengeditan langsung, pekerjaan tersebut akan masuk antrean di latar belakang dan dieksekusi secara asinkron. Setelah pengiriman, Anda dapat memanggil API GetLiveEditingJob untuk mengkueri status pekerjaan berdasarkan jobId. Anda juga dapat memanggil API GetMediaInfo untuk mengkueri informasi aset media yang dihasilkan berdasarkan MediaId.

    Deskripsi operasi

    • API ini adalah API asinkron. Setelah pekerjaan dikirim, ID pekerjaan akan dikembalikan (pekerjaan belum selesai dan akan masuk antrean di latar belakang serta dieksekusi secara asinkron). Hasil akhir akan diberitahukan melalui callback. Anda juga dapat secara aktif mengkueri status pekerjaan melalui GetLiveEditingJob.

    • Saat ini, pengeditan langsung didukung untuk aliran langsung yang direkam ke OSS dan VOD. Untuk pengeditan campuran multi-aliran langsung, hanya kasus di mana semua aliran langsung direkam ke OSS atau semua aliran langsung direkam ke VOD yang didukung.

    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:SubmitLiveEditingJob

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Clips

    string

    Yes

    Daftar klip pengeditan. Produk jadi keluaran dibentuk dengan menggabungkan klip dalam daftar secara berurutan dari ujung ke ujung. Array JSON.

    Setiap klip berisi waktu mulai dan waktu akhir. Jika tidak ada parameter aliran langsung yang ditentukan, konfigurasi aliran langsung luar akan diutamakan. Kedua stempel waktu mulai dan akhir berada dalam waktu UTC. Untuk detail parameter, lihat struktur data Clip di bawah ini.

    [{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" , "AppName": "app", "DomainName": "domain.com", "StreamName": "stream"}, {\"StartTime\": \" 2021-06-21T08:05:00Z\", \"EndTime\": \" 2021-06-21T08:09:00Z\" }]
    ProjectId

    string

    No

    ID proyek pengeditan langsung. Jika tidak kosong, konfigurasi penyimpanan terkait proyek akan dibaca. Jika kosong, konfigurasi penyimpanan yang ditentukan di parameter masukan akan diutamakan.

    ****fddd7748b58bf1d47e95****
    LiveStreamConfig

    string

    No

    Konfigurasi aliran langsung, Objek JSON. Item konfigurasi berikut harus disertakan:

    • AppName: Nama aplikasi tempat aliran berada

    • DomainName: Nama domain

    • StreamName: Nama aliran langsung

    { "AppName": "app", "DomainName": "domain.com", "StreamName": "stream" }
    OutputMediaConfig

    string

    No

    Konfigurasi target produk jadi keluaran, JSON Object. Anda dapat mengatur URL produk jadi keluaran di OSS, atau lokasi penyimpanan di Bucket VOD.

    • Saat mengeluarkan ke OSS, MediaURL dari target keluaran wajib diisi.

    • Saat mengeluarkan ke VOD, parameter StorageLocation dan FileName wajib diisi.

    { "MediaURL": "https://ice-auto-test.oss-cn-shanghai.aliyuncs.com/testfile.mp4" }, 或 { "StorageLocation": "bucket.oss-cn-shanghai.aliyuncs.com", "FileName": "output.mp4" }
    MediaProduceConfig

    string

    No

    Konfigurasi pencampuran aliran untuk menghasilkan klip, dinyatakan dalam format JSON. Mode menunjukkan mode pengeditan. Nilai valid:

    • AccurateFast (default): Pengeditan akurat cepat, yang memiliki kecepatan pencampuran aliran lebih cepat dibandingkan dengan mode Accurate. File keluaran memiliki resolusi yang sama dengan aliran sumber, dan menentukan lebar serta tinggi produk jadi keluaran tidak didukung.

    • Accurate: Pengeditan akurat, yang memungkinkan Anda menentukan lebar dan tinggi produk jadi keluaran.

    • Rough: Pengeditan kasar, dengan presisi minimum satu segmen TS. Produk jadi berisi semua segmen pengatur waktu mulai dan akhir yang ditentukan pengguna, dan Anda dapat menentukan lebar serta tinggi produk jadi keluaran.

    • RoughFast: Pengeditan kasar cepat, yang memiliki kecepatan pencampuran aliran lebih cepat dibandingkan dengan mode Accurate, dengan presisi minimum satu segmen TS. Produk jadi berisi semua segmen pengatur waktu mulai dan akhir yang ditentukan pengguna. File keluaran memiliki resolusi yang sama dengan aliran sumber, dan menentukan lebar serta tinggi produk jadi keluaran tidak didukung.

    { "Mode": "AccurateFast"}
    UserData

    string

    No

    Pengaturan kustom, JSON Object, dengan batas panjang 512 byte.

    {"key": "value"}
    OutputMediaTarget

    string

    No

    Tipe target produk jadi keluaran. Nilai valid:

    • oss-object: Objek OSS di bawah bucket OSS Alibaba Cloud

    • vod-media: Aset media dari VOD Alibaba Cloud.

    oss-object

    Struktur Data Clip

    Nama AtributTipeContohDeskripsiWajib
    StartTimeString2021-06-21T08:01:00ZWaktu mulai klip yang diambil, dalam format stempel waktu UTCYa
    EndTimeString2021-06-21T08:05:00ZWaktu akhir klip yang diambil, dalam format stempel waktu UTCYa
    AppNameStringappNama aplikasi tempat aliran berada. Jika kosong, konfigurasi aliran langsung luar akan diutamakan.Tidak
    DomainNameStringdomain.comNama domain. Jika kosong, konfigurasi aliran langsung luar akan diutamakan.Tidak
    StreamNameStringstreamNama aliran langsung. Jika kosong, konfigurasi aliran langsung luar akan diutamakan.Tidak
    CoverTimeString2021-06-21T08:03:00ZMenentukan waktu dalam klip sebagai gambar sampul produk jadi, dalam format stempel waktu UTC. Ketika beberapa klip memiliki parameter CoverTime yang diatur, hanya yang pertama yang berlaku. CoverTime harus lebih besar atau sama dengan StartTime dan kurang dari atau sama dengan EndTime.Tidak
    CoverUrlStringhttps://test.oss-cn-shanghai.aliyuncs.comAlamat keluaran tangkapan layar kustom. Bucket OSS harus berada di wilayah yang sama dengan wilayah akses layanan. Hanya bucket OSS Anda sendiri yang didukung; bucket yang dihosting VOD tidak didukung.Tidak

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    ****36-3C1E-4417-BDB2-1E034F****
    ProjectId

    string

    ID proyek pengeditan langsung.

    ****fddd7748b58bf1d47e95****
    JobId

    string

    ID pekerjaan pengeditan langsung.

    ****d80e4e4044975745c14b****
    MediaId

    string

    ID aset media dari produk jadi yang disusun.

    ****c469e944b5a856828dc2****
    MediaURL

    string

    Alamat produk jadi yang disusun.

    http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4
    VodMediaId

    string

    Jika lokasi keluaran video adalah VOD, ID aset media VOD akan dikembalikan.

    ****d7578s4h75ci945c14b****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "ProjectId": "****fddd7748b58bf1d47e95****",
  "JobId": "****d80e4e4044975745c14b****",
  "MediaId": "****c469e944b5a856828dc2****",
  "MediaURL": "http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4",
  "VodMediaId": "****d7578s4h75ci945c14b****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.