Intelligent Media Services:FAQ Produksi Cerdas

Bagaimana cara mengekspor video output ke ApsaraVideo VOD?

Saat memanggil operasi SubmitMediaProducingJob untuk mengirimkan pekerjaan produksi, atur parameter OutputMediaTarget ke vod-media. Pada parameter OutputMediaConfig, tetapkan StorageLocation dan FileName sesuai dengan lokasi penyimpanan dan nama file aset media di ApsaraVideo VOD:

"OutputMediaConfig": {
  "StorageLocation": "outin-8e7*******.oss-cn-shanghai.aliyuncs.com",
  "FileName": "vod-output.mp4"
}

Bagaimana cara mendapatkan hasil pekerjaan produksi cerdas?

Setelah Anda memanggil operasi SubmitMediaProducingJob untuk mengirimkan pekerjaan produksi, responsnya mencakup JobId. Panggil operasi GetMediaProducingJob dan berikan JobId tersebut untuk mengecek status pekerjaan, lalu gunakan bidang Status dalam respons untuk menentukan status pekerjaan tersebut.

Berapa lama waktu yang dibutuhkan untuk menyelesaikan pekerjaan produksi cerdas?

Waktu produksi kira-kira setara dengan durasi video output. Misalnya, video output berdurasi 5 menit umumnya memerlukan sekitar 5 menit untuk diproses. Namun, setiap pekerjaan juga membutuhkan waktu tambahan untuk antrian, analisis file, dan pengunduhan, sehingga bahkan video output terpendek memerlukan minimal 15 detik. Bergantung pada kompleksitasnya, waktu produksi video berdurasi 15 detik biasanya berkisar antara 10 detik hingga 2 menit. Jika Anda mengirimkan banyak pekerjaan sekaligus—misalnya puluhan ribu—pekerjaan tersebut akan diantrekan dan diproses secara berurutan. Untuk meningkatkan kapasitas pemrosesan, ajukan tiket.

Faktor apa saja yang memengaruhi waktu produksi?

Proses produksi dilakukan frame per frame; oleh karena itu, semakin tinggi resolusi dan semakin panjang durasi video output, semakin lama waktu produksinya. Waktu produksi juga bertambah jika video output menggunakan banyak efek khusus atau transisi, atau jika media sumber diskalakan—misalnya, menurunkan skala media 4K ke 480p. Konfigurasi timeline yang tidak tepat juga dapat memperpanjang waktu produksi. Jika waktu produksi tidak sesuai ekspektasi Anda, ajukan tiket untuk dukungan teknis atau bergabung dengan grup dukungan di DingTalk (ID: 84650000851).

Mengapa durasi video output berbeda dari yang saya harapkan?

• "Transisi memperpendek durasi output." Transisi merupakan peralihan dari satu klip ke klip berikutnya, di mana kedua klip diputar secara bersamaan selama transisi. Akibatnya, klip kedua dimulai lebih awal dan durasi total berkurang. Untuk mempertahankan durasi asli, sisakan ruang yang cukup untuk transisi saat memotong klip. Alternatifnya, gunakan DLTransition untuk menambahkan frame selama transisi dan menjaga durasi output tetap utuh.

• "AI_TTS dapat memperpanjang durasi total." Saat menggunakan AI_TTS, klip audio yang dihasilkan bisa lebih panjang daripada trek videonya, sehingga memperpanjang durasi output keseluruhan. Pendekatan yang dijelaskan dalam Menyelaraskan durasi berbagai klip media secara otomatis dapat mengatasi masalah ini.

• "Konfigurasi timeline yang salah mengubah durasi." Jika hanya mengatur TimelineIn dan TimelineOut tanpa menetapkan In dan Out, setiap klip akan diproses dengan durasi aslinya. Atur in = 0 dan out = timelineOut - timelineIn untuk mengontrol cara klip diproses.

Mengapa video output saya menampilkan layar hitam setelah waktu tertentu?

Layar hitam biasanya terjadi ketika durasi media video Anda lebih pendek daripada trek lainnya. Misalnya, jika klip video berdurasi 6 detik sedangkan trek audionya berdurasi 12 detik, segmen setelah detik ke-6 akan dirender sebagai layar hitam. Untuk mengatasinya, atur trek video sebagai main track agar trek lainnya diselaraskan dengannya, atau sesuaikan durasi trek lain agar sejalan dengan trek video.

Mengapa saya menerima error "TimelineFormatError" saat memanggil API?

Periksa apakah timeline sesuai dengan format yang ditentukan dalam konfigurasi Timeline dan pastikan JSON tidak mengandung kesalahan sintaksis. Contoh timeline dalam Menggabungkan dan mengedit video serta gambar mencakup struktur yang paling umum.

Mengapa subtitle gagal ditampilkan, tampak rusak, atau dirender salah setelah saya menambahkannya?

Jika Anda menggunakan bahasa yang kurang umum seperti Korea, Arab, atau Mongolia, rendering font dapat menyebabkan masalah ini. Kirimkan pekerjaan menggunakan font default (Alibaba PuHuiTi). Jika masalah tetap berlanjut, cari grup DingTalk 84650000851 dan bergabunglah dengan "grup produk Intelligent Media Services" untuk menghubungi kami.

Mengapa posisi output gambar, teks, atau subtitle tidak sesuai?

• Pastikan ukuran frame output sesuai dengan ukuran pratinjau. Nilai posisi relatif antara 0 dan 1 menjaga konsistensi tata letak di berbagai ukuran.

• Jika klip pada trek yang sama tumpang tindih dalam waktu atau posisi, mekanisme anti-tabrakan dapat menggeser posisinya. Untuk mengatur posisi dan waktu secara lebih fleksibel, pisahkan klip tersebut ke trek berbeda.

Mengapa FontSize pada subtitle tidak sesuai dengan pratinjau?

• Jika Anda menggunakan properti FontSize dalam Effect Type: Text, ukuran font akan diskalakan berdasarkan ukuran klip dan resolusi video output. Ganti FontSize dengan FixedFontSize agar ukuran font tidak mengalami penskalaan.

• Anda dapat menggunakan trek subtitle SubtitleTrackClip untuk menentukan konten subtitle. Jika Anda menetapkan font subtitle, tinggi subtitle yang dirender dalam piksel mungkin lebih kecil daripada ukuran font tertentu. Atur SizeRequestType=Nominal agar tinggi yang dirender dalam piksel sama dengan ukuran font.

• Menetapkan ukuran pratinjau memastikan ukuran font output konsisten dengan tampilan pratinjau. Misalnya, untuk menghasilkan video output 720p, atur parameter ukuran pratinjau menjadi FECanvas={"Height":720,"Width":1280}.

Apa yang harus saya lakukan jika menerima error "Throttling.User" saat mengirimkan pekerjaan?

• Operasi penulisan IMS biasanya dibatasi hingga 30 QPS. Throttling dapat terjadi jika Anda mengirimkan pekerjaan dengan konkurensi tinggi. Dalam kasus ini, tunggu satu detik lalu lanjutkan mengirimkan pekerjaan.

• Dengan batas 30 QPS, Anda dapat mengirimkan hingga 1.800 pekerjaan per menit—cukup untuk memenuhi kebutuhan sebagian besar pelanggan. Jika bisnis Anda memerlukan pengiriman berkelanjutan di atas 30 QPS selama puluhan menit, misalnya untuk memproduksi jutaan video dalam waktu setengah jam guna mendukung aktivitas operasional, ajukan tiket untuk meminta peningkatan QPS.

Apa yang harus saya lakukan jika analisis indeks gagal?

Pada halaman Media Asset Management, pilih aset media yang ingin Anda analisis ulang, lalu klik Index Analysis di bawah daftar untuk memulai pekerjaan analisis indeks baru.

Apa yang harus saya lakukan jika operasi produksi mengembalikan error izin tidak mencukupi atau Forbidden.SubscriptionRequired?

Error ini memiliki dua kemungkinan penyebab:

• "Izin akun tidak mencukupi": Berikan kebijakan AliyunICEFullAccess kepada Pengguna RAM atau kebijakan kustom yang mencakup aksi seperti ice:SubmitMediaProducingJob, serta pastikan wilayah proyek sesuai dengan wilayah panggilan API.

• "Layanan belum diaktifkan": Error Forbidden.SubscriptionRequired menunjukkan bahwa Anda belum berlangganan edisi yang diperlukan atau belum membeli paket uji coba fitur. Lakukan langganan terlebih dahulu, lalu coba lagi.

Bagaimana cara memecahkan masalah tingkat kegagalan pekerjaan produksi yang tinggi?

Lakukan pemecahan masalah dalam urutan berikut:

• Periksa file sumber: Gunakan alat seperti ffprobe untuk memastikan aliran audio dan video lengkap, metadata normal, serta format berada dalam rentang yang didukung.

• Periksa wilayah penyimpanan: Pastikan bucket OSS input dan output berada di wilayah yang sama dengan IMS. Beberapa wilayah, seperti Guangzhou dan Chengdu, tidak didukung.

• Periksa parameter timeline: Verifikasi struktur dan nama bidang sesuai dokumentasi konfigurasi timeline, serta pastikan parameter seperti MediaId dan durasi telah benar.

Apa saja kesalahan konfigurasi timeline yang paling umum?

• Trek efek tidak boleh tumpang tindih: Tempatkan setiap efek pada trek terpisah agar efek dalam EffectTracks tidak tumpang tindih dalam waktu.

• Error "Both video tracks and audio tracks are empty": Timeline tidak dikirimkan dalam format yang diperlukan. Perbaiki strukturnya sesuai dokumentasi.

• MediaId harus berupa ID aset media yang valid: Jangan gunakan placeholder variabel. Nama bidang harus diawali huruf kapital.

• Konfigurasikan parameter transisi di dalam klip video, bukan dengan membuat trek transisi terpisah.

• Jangan mencampurkan tag SSML dari Intelligent Speech Interaction. Parameter AudioTrackClips seperti Content dan Volume harus mengikuti dokumentasi IMS.

Bagaimana cara mengontrol jumlah video output dan gaya judul dalam produksi video otomatis?

• OutputConfig.Count mengontrol jumlah video output. Nilai yang valid: 1 hingga 100. Nilai default: 1. Parameter ini berlaku untuk produksi otomatis berbasis skrip dan produksi pencocokan gambar-teks cerdas.

• Jika jarak antar karakter tidak normal, atur ModifySpacing menjadi true dalam SubHeadingConfig dan kurangi nilai Spacing.

• Satu judul hanya mendukung satu warna. Untuk menggunakan beberapa warna, konfigurasikan beberapa judul dalam TitleArray dan tentukan warna untuk masing-masing judul.

• Jika teks yang mengandung karakter khusus gagal dihasilkan, lakukan escape terhadap karakter khusus tersebut sesuai persyaratan SSML, lalu kirimkan ulang pekerjaan tersebut.

Mengapa templat advanced (AE) saya gagal diunggah?

Paket templat harus memenuhi semua persyaratan berikut:

• Paket menggunakan format .zip. Format RAR dan 7z tidak didukung.

• Nama paket tidak boleh mengandung karakter Tionghoa atau simbol khusus.

• Paket berisi empat direktori root: assets, config.json, datas, dan ui.

• Wilayah saat ini mendukung templat Advanced.

  Wilayah saat ini mendukung templat Advanced.

Apakah saya perlu membersihkan secara manual aset media yang dihasilkan oleh pekerjaan produksi?

Video output yang dihasilkan melalui API secara otomatis didaftarkan sebagai aset media dan dikenai biaya penyimpanan serta manajemen. Panggil DeleteMediaInfos untuk menghapusnya jika tidak lagi diperlukan. Hindari menulis output dari dua pekerjaan ke lokasi penyimpanan yang sama karena dapat saling menimpa dan menghasilkan video output yang tidak normal.

Jawaban cepat untuk pertanyaan umum lainnya

• Mendapatkan URL video output: Pekerjaan produksi merupakan tugas asinkron. Setelah mengirimkan pekerjaan, panggil GetMediaProducingJob untuk memeriksa status pekerjaan dan mendapatkan URL video output. Anda juga dapat menerima hasil melalui callback event (antrian pesan). Pastikan Anda memilih jenis pesan yang sesuai.

• Layar hitam di akhir video output: Masalah ini umumnya disebabkan oleh ketidaksesuaian antara trek video dan trek audio. Sesuaikan ClipId dan ReferenceClipId dari klip terakhir untuk menyelaraskan kedua trek tersebut.

• Font kustom: Setelah mengunggah file font, sistem akan menghasilkan MediaId yang sesuai. Gunakan nilai MediaId tersebut dalam customFontList untuk menerapkan font tersebut.

• Latar belakang transparan untuk matting adegan nyata: Jika Anda tidak memberikan parameter gambar latar belakang, output dapat berupa file WEBM dengan saluran alpha. Matting adegan nyata memerlukan latar belakang berwarna solid dan tidak berlaku untuk latar belakang kompleks seperti interior rumah atau pemandangan luar ruangan.

• Pemotongan otomatis aliran langsung: Panggil operasi SubmitLiveEditingJob.

• Callback tidak real time: Callback event tidak dijamin sepenuhnya tersinkronisasi dengan penyelesaian pekerjaan. Oleh karena itu, jangan menjadikan callback sebagai satu-satunya dasar logika bisnis Anda. Gunakan polling status pekerjaan sebagai metode utama dan callback sebagai pelengkap. Atur interval polling minimal 5 detik.

• Apa saja yang dapat didefinisikan dalam produksi video otomatis selain media: Pembuka, penutup, judul, subtitle, musik latar, dan skrip narasi semuanya dapat didefinisikan melalui parameter timeline atau templat. Anda dapat menemukan ID templat di Template Factory di Konsol, serta titik akhir bucket di halaman ikhtisar Konsol OSS.

Bagaimana cara mengidentifikasi penyebab pasti kegagalan pekerjaan produksi?

Peroleh sendiri pesan error dan cocokkan dengan penyebabnya—jangan menunggu investigasi manual.

• Dapatkan JobId yang dikembalikan saat Anda mengirimkan pekerjaan. Anda juga dapat menemukannya di daftar pekerjaan di Konsol.

• Panggil GetMediaProducingJob dengan JobId. Periksa terlebih dahulu nilai Status untuk menentukan tahap pekerjaan, lalu baca pesan error dalam respons.

• Tangani error berdasarkan kategorinya: untuk error akun seperti Forbidden.SubscriptionRequired, izin tidak mencukupi, atau akun jatuh tempo, perbaiki status akun terlebih dahulu; untuk error parameter seperti TimelineFormatError, trek kosong, atau tipe bidang salah, perbaiki parameter terlebih dahulu; untuk error media seperti format tidak didukung atau informasi aliran tidak normal, validasi file sumber terlebih dahulu.

  JobId

Apa yang harus saya lakukan jika pekerjaan gagal dengan error parameter VideoTracks atau AudioTracks?

Dalam timeline, VideoTracks, AudioTracks, ImageTracks, dan SubtitleTracks semuanya berupa "array" dan harus diapit dengan [ ]. Pekerjaan akan langsung gagal jika Anda secara tidak sengaja mengirimkan objek yang diapit dengan { }. Bahkan ketika hanya ada satu trek, tulis sebagai array berisi satu elemen, misalnya "VideoTracks": [{"VideoTrackClips": [...]}].

Apa yang harus saya lakukan jika menerima error "Track duration adaptation and material alignment cannot be used at the same time"?

Adaptasi durasi trek dan penyelarasan klip bersifat saling eksklusif sehingga tidak dapat digunakan dalam pekerjaan yang sama.

• Adaptasi durasi trek dikontrol oleh TrackShortenMode dan TrackExpandMode, seperti AutoSpeed.

• Penyelarasan klip dikontrol oleh ClipId dan ReferenceClipId.

  Untuk mengatasi error ini, cari bidang-bidang tersebut dalam timeline dan hapus salah satu set. Pertahankan TrackShortenMode dan TrackExpandMode jika Anda memerlukan penyesuaian kecepatan otomatis, atau pertahankan ReferenceClipId jika Anda perlu menyelaraskan klip ke klip tertentu.

Apa yang harus saya lakukan jika menerima error "User not authorized to operate on the specified resource" atau kode status 403?

Error ini menunjukkan bahwa URL file input tidak dapat dibaca. Ikuti langkah-langkah berikut untuk mengatasi masalah tersebut:

• Gunakan URL lengkap yang diawali dengan https saat mengirimkan parameter. Beberapa format URL yang disusun secara manual ditolak selama validasi.

• Pastikan bucket dan IMS berada di wilayah yang sama serta peran terkait layanan telah diberi otorisasi.

• Jika Anda memanggil operasi sebagai Pengguna RAM, pastikan pengguna tersebut memiliki izin baca pada OSS dan izin asumsi peran.

Bagaimana cara mengetahui apakah pekerjaan yang tetap dalam status pemrosesan bersifat abnormal?

• Pertama, bandingkan durasi waktu yang telah berlalu dengan ekspektasi: waktu produksi umumnya setara dengan durasi video output, dan bahkan video output terpendek memerlukan minimal 15 detik. Pekerjaan akan masuk antrean jika Anda mengirimkan banyak pekerjaan sekaligus.

• Status pemrosesan tidak menjamin bahwa semua subtugas berjalan normal. Untuk pekerjaan batch, pekerjaan utama dapat ditandai sebagai selesai meskipun beberapa subtugas gagal. Periksa hasil setiap subtugas, jangan hanya mengandalkan status ringkasan.

• Jika waktu yang telah berlalu jauh melebihi ekspektasi—misalnya, video pendek belum selesai setelah 30 menit—sertakan JobId dan waktu pengiriman saat mengajukan tiket.

Bagaimana cara mencegah tagihan yang sangat tinggi dari satu pekerjaan?

Penyebab paling umum adalah konfigurasi timeline yang salah, sehingga durasi video output jauh lebih panjang dari yang diharapkan. Pernah terjadi satu pekerjaan menghasilkan video output selama ratusan ribu detik, dan biaya produksi dihitung berdasarkan durasi pemrosesan tersebut. Lakukan dua pemeriksaan berikut sebelum mengirimkan pekerjaan secara batch:

• Pastikan In dan Out diatur berpasangan dengan TimelineIn dan TimelineOut untuk setiap klip. Jika hanya TimelineIn dan TimelineOut yang ditetapkan, klip akan diproses sesuai durasi aslinya.

• Terapkan batas atas pada durasi video output dalam logika bisnis Anda dan blokir pengiriman pekerjaan yang melebihi ambang batas yang ditentukan. Jalankan satu atau dua pekerjaan uji terlebih dahulu, lalu verifikasi tagihannya sebelum melakukan penskalaan.

Apa saja persyaratan media jika file yang diunggah gagal setelah saya mengirimkannya?

Gunakan file audio dan video dalam format kontainer umum seperti MP4 dan MOV, serta pastikan file tersebut dapat diputar dengan lancar. Sebelum mengunggah, gunakan ffprobe untuk memverifikasi bahwa aliran audio dan video lengkap serta metadata dalam kondisi normal. File dengan encoding tidak standar, aliran video hilang, atau format kontainer langka sering gagal pada fase analisis. Dalam beberapa skenario produksi otomatis, gambar kurang stabil dibandingkan video. Jika video hasil tidak menggunakan semua gambar Anda sesuai harapan, lakukan verifikasi terlebih dahulu menggunakan file video.

Mengapa file masih ada di bucket saya setelah saya menghapus aset media?

Catatan aset media dan file fisik merupakan dua lapisan terpisah. Secara default, penghapusan aset media tidak menghapus file sumber di Object Storage Service (OSS), sehingga biaya penyimpanan tidak berhenti secara otomatis.

• Untuk menghapus file fisik sekaligus, atur parameter yang menghapus file fisik secara eksplisit saat memanggil operasi penghapusan, misalnya tetapkan DeletePhysicalFiles ke true.

• Media yang diunggah dan output produksi tidak berperilaku identik: video output yang dihasilkan melalui API secara otomatis didaftarkan sebagai aset media, dan penghapusannya mungkin mengharuskan Anda membersihkan file output di OSS secara terpisah.

• Untuk pembersihan massal, panggil DeleteMediaInfos untuk menghapus catatan aset media terlebih dahulu, lalu konfirmasi di sisi OSS bahwa direktori yang sesuai telah kosong.

Berapa periode validitas default URL Object Storage Service (OSS) privat yang dikembalikan oleh Intelligent Media Services (IMS)?

Secara default, URL privat OSS yang dikembalikan oleh Intelligent Media Services (IMS) berlaku selama 1 jam. Untuk mengetahui waktu kedaluwarsa yang tepat, periksa parameter expier dalam URL.

Apa yang harus saya lakukan jika pustaka aset media menunjukkan penggunaan penyimpanan tetapi tidak ada file spesifik?

Masalah ini biasanya terjadi karena file video sumber disimpan di bucket OSS terkait, tetapi operasi penghapusan tidak menghapus file sumber tersebut dari OSS. Ikuti langkah-langkah berikut untuk mengatasi masalah ini:

1. Konfirmasi bahwa Intelligent Media Services (IMS) telah diberi otorisasi untuk mengakses bucket OSS yang sesuai di bawah akun saat ini.

2. Berikan izin kepada peran terkait layanan IMS untuk menghapus objek OSS. Anda dapat mengonfigurasi izin ini di Konsol Manajemen Alibaba Cloud tanpa perlu menulis kode.

3. Setelah otorisasi selesai, jalankan kembali operasi penghapusan. Sistem akan menghapus file sumber beserta file turunannya—seperti file hasil transkode dan edit—dari OSS, melepaskan penyimpanan yang digunakan, dan menyinkronkan daftar pustaka aset media.