全部产品
Search

搜索本产品

    ApsaraVideo VOD：CreateUploadVideo

    文档中心

    ApsaraVideo VOD：CreateUploadVideo

    更新时间：Dec 15, 2025

    ApsaraVideo VOD menyediakan URL unggah dan kredensial untuk mengotorisasi serta menjamin keamanan unggahan. Saat Anda memanggil operasi ini untuk mendapatkan URL unggah dan kredensial, sebuah ID media (MediaId), juga dikenal sebagai ID video (VideoId), secara otomatis dibuat untuk mengelola aset audio atau video tersebut.

    Deskripsi operasi

    • Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan dan harga ApsaraVideo VOD. Mengunggah aset media ke ApsaraVideo VOD akan dikenai biaya penyimpanan. Untuk informasi selengkapnya, lihat Penagihan penyimpanan aset media. Jika Anda mengaktifkan akselerasi transfer, Anda juga akan dikenai biaya akselerasi unggah. Untuk informasi selengkapnya, lihat Penagihan akselerasi transfer penyimpanan. Biaya penyimpanan dikenakan setelah file berhasil diunggah, sedangkan biaya akselerasi berlaku saat Anda mengunggah file setelah fitur tersebut diaktifkan. Pemanggilan operasi ini tidak dikenai biaya.

    • Mendapatkan URL unggah dan kredensial merupakan fitur inti ApsaraVideo VOD serta langkah wajib dalam setiap proses unggah. ApsaraVideo VOD menyediakan berbagai metode unggah, dengan persyaratan yang berbeda untuk memperoleh URL dan kredensial pada tiap metode. Untuk informasi selengkapnya, lihat URL unggah dan kredensial.

    • Operasi ini hanya digunakan untuk mendapatkan URL unggah dan kredensial serta membuat catatan aset media, bukan untuk mengunggah file. Untuk contoh lengkap cara mengunggah aset media melalui pemanggilan API, lihat Unggah aset media menggunakan operasi API ApsaraVideo VOD.

    • Anda dapat menggunakan operasi ini untuk mendapatkan URL unggah dan kredensial baik untuk file video maupun audio. Untuk informasi selengkapnya, lihat URL unggah dan kredensial.

    • Jika kredensial unggah kedaluwarsa, Anda dapat memanggil operasi RefreshUploadVideo untuk mendapatkan kredensial baru. Masa berlaku default adalah 3.000 detik.

    • Setelah unggahan selesai, Anda dapat mengonfigurasi callback untuk menerima notifikasi event unggahan atau memanggil operasi GetMezzanineInfo guna memeriksa status file dan memastikan keberhasilan unggahan.

    • Gunakan parameter VideoId yang dikembalikan oleh operasi ini untuk manajemen siklus hidup aset media atau Pemrosesan Media ApsaraVideo.

    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

    vod:CreateUploadVideo

    create

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    CoverURL

    string

    No

    URL gambar mini video kustom.

    https://example.aliyundoc.com/image/D22F553TEST****.jpeg
    Description

    string

    No

    Deskripsi file audio atau video yang ditampilkan di ApsaraVideo VOD setelah unggahan selesai.

    • Panjang deskripsi maksimal 1.024 karakter.

    • Nilainya harus dikodekan dalam UTF-8.

    UploadTest
    FileName

    string

    Yes

    Jalur file sumber audio atau video yang akan diunggah.

    • Nama file harus mencantumkan ekstensi file. Ekstensi file tidak peka huruf besar/kecil.

    • Untuk informasi selengkapnya mengenai ekstensi file yang didukung, lihat Ikhtisar unggahan.

    D:\video_01.mp4
    FileSize

    integer

    No

    Ukuran file sumber audio atau video. Satuan: byte.

    123
    Title

    string

    Yes

    Judul file audio atau video yang ditampilkan di ApsaraVideo VOD setelah unggahan selesai.

    • Panjang judul maksimal 128 karakter.

    • Nilainya harus dikodekan dalam UTF-8.

    UploadTest
    CateId

    integer

    No

    ID kategori. Anda dapat memperoleh ID kategori dengan salah satu cara berikut:

    • Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi, pilih Configuration Management > Media Management Configuration > Category Management untuk melihat ID kategori.

    • Nilai parameter CateId yang dikembalikan setelah Anda memanggil operasi AddCategory untuk membuat kategori.

    • Nilai parameter CateId yang dikembalikan setelah Anda memanggil operasi GetCategories untuk mengkueri kategori.

    100036****
    Tags

    string

    No

    Tag untuk file audio atau video.

    • Maksimal 16 tag dapat ditambahkan.

    • Pisahkan beberapa tag dengan koma (,).

    • Panjang tiap tag maksimal 32 karakter.

    • Nilainya harus dikodekan dalam UTF-8.

    tag1,tag2
    UserData

    string

    No

    Pengaturan kustom. Ini adalah string JSON yang mendukung pengaturan seperti callback pesan dan akselerasi transfer. Untuk informasi selengkapnya, lihat UserData.

    Catatan

    • Untuk menggunakan fitur callback pesan, Anda harus mengonfigurasi alamat webhook dan memilih jenis event yang sesuai di Konsol ApsaraVideo VOD. Jika tidak, pengaturan callback tidak akan berlaku. Untuk informasi selengkapnya tentang cara mengonfigurasi webhook di konsol, lihat Pengaturan callback.

    • Untuk menggunakan fitur akselerasi unggah, Anda harus mengisi formulir di Yida untuk meminta aktivasi. Untuk informasi selengkapnya, lihat Petunjuk unggahan.

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
    TemplateGroupId

    string

    No

    ID kelompok template transkoding. Anda dapat memperoleh ID ini dengan salah satu cara berikut:

    • Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi, pilih Configuration Management > Media Processing Configuration > Transcoding Template Groups untuk melihat ID kelompok template transkoding.

    • Nilai parameter TranscodeTemplateGroupId yang dikembalikan setelah Anda memanggil operasi AddTranscodeTemplateGroup.

    • Nilai parameter TranscodeTemplateGroupId yang dikembalikan setelah Anda memanggil operasi ListTranscodeTemplateGroup.

    Catatan

    • Jika Anda menentukan `WorkflowId` dan `TemplateGroupId` sekaligus, `WorkflowId` memiliki prioritas lebih tinggi.

    • Jika Anda tidak menentukan parameter ini, kelompok template transkoding default akan digunakan. Jika Anda menentukan parameter ini, kelompok template transkoding yang ditentukan akan digunakan.

    • Jika Anda mengatur parameter ini ke ID kelompok template No Transcoding bawaan sistem, Anda hanya akan menerima notifikasi event VideoUploadComplete setelah file audio atau video diunggah. Anda tidak akan menerima notifikasi event TranscodeComplete.

    • Untuk memastikan pemutaran normal, jika Anda mengatur parameter ini ke ID kelompok template No Transcoding bawaan sistem, hanya file dalam format MP4, FLV, MP3, M3U8, dan WEBM yang dapat diputar tanpa transkoding setelah diunggah. File dalam format lain hanya dapat disimpan. Perhatikan ekstensi file dalam `FileName`. Jika Anda menggunakan Pemutar Video Apsara, versi pemutar harus 3.1.0 atau lebih baru.

    405477f9e214d19ea2c7c854****
    WorkflowId

    string

    No

    ID alur kerja. Masuk ke Konsol ApsaraVideo VOD dan pilih Configuration Management > Media Processing Configuration > Workflow Management untuk melihat ID alur kerja.

    Catatan

    Jika Anda menentukan `WorkflowId` dan `TemplateGroupId` sekaligus, `WorkflowId` memiliki prioritas lebih tinggi. Untuk informasi selengkapnya, lihat Alur kerja.

    613efff3887ec34af685714cc461****
    StorageLocation

    string

    No

    Alamat penyimpanan. Masuk ke Konsol ApsaraVideo VOD dan pilih Configuration Management > Media Management Configuration > Storage untuk melihat alamat penyimpanan.

    Catatan

    Jika Anda tidak menentukan parameter ini, file audio atau video akan diunggah ke alamat penyimpanan default. Jika tidak ada alamat penyimpanan default yang dikonfigurasi, file akan diunggah ke alamat penyimpanan pertama dalam daftar penyimpanan. Jika Anda menentukan parameter ini, file akan diunggah ke alamat penyimpanan yang ditentukan.

    out-****.oss-cn-shanghai.aliyuncs.com
    AppId

    string

    No

    ID aplikasi. Nilai default: app-1000000. Untuk informasi selengkapnya, lihat Layanan multi-aplikasi.

    app-1000000
    ReferenceId

    string

    No

    ID kustom. Dapat berisi huruf kecil, huruf besar, angka, tanda hubung (-), dan garis bawah (_). Panjang ID harus antara 6 hingga 64 karakter dan unik untuk tiap pengguna.

    123-123

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    RequestId

    string

    ID permintaan.

    25818875-5F78-4AF6-04D5-D7393642****
    UploadAddress

    string

    URL unggah.

    Catatan

    URL unggah yang dikembalikan oleh operasi ini dikodekan dalam Base64. Anda harus mendekode Base64 URL tersebut sebelum menggunakan SDK atau operasi API untuk mengunggah aset media. Anda hanya perlu mengurai `UploadAddress` jika mengunggah aset media menggunakan SDK native Object Storage Service (OSS) atau dengan memanggil operasi API OSS.

    eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
    VideoId

    string

    ID file audio atau video. Anda dapat menggunakan ID ini sebagai parameter permintaan saat memanggil operasi lain, seperti operasi untuk manajemen aset media, pemrosesan media, dan tinjauan media.

    93ab850b4f6f54b6e91d24d81d44****
    UploadAuth

    string

    Kredensial unggah.

    Catatan

    Kredensial unggah yang dikembalikan oleh operasi ini dikodekan dalam Base64. Anda harus mendekode Base64 kredensial tersebut sebelum menggunakan SDK atau operasi API untuk mengunggah aset media. Anda hanya perlu mengurai `UploadAuth` jika mengunggah aset media menggunakan SDK native OSS atau dengan memanggil operasi API OSS.

    eyJFbmRwb2ludCI6Imm****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "25818875-5F78-4AF6-04D5-D7393642****",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "VideoId": "93ab850b4f6f54b6e91d24d81d44****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.