全部產品
Search
文件中心

Intelligent Media Services:基於OSS API上傳

更新時間:Oct 25, 2024

當媒體檔案為網路檔案或需要自動化上傳、大批量遷移時,可以通過調用智能媒體服務相關介面擷取媒資上傳地址和憑證,再調用OSS原生介面完成上傳功能。通過閱讀本文,您可以瞭解基於OSS API上傳的方法。

前提條件

背景資訊

調用OSS API進行媒資上傳前,您需要擷取媒資上傳地址和憑證。上傳地址是指智能媒體服務中OSS的儲存地址,上傳憑證是完成上傳動作的授權憑證。上傳地址和憑證均由智能媒體服務下發,主要解決媒體上傳過程中的授權和安全問題,防止惡意上傳。同時,智能媒體服務在下發上傳地址和憑證時會自動建立媒資資訊,即媒資ID,可用於後續媒資生命週期管理或ApsaraVideo for Media Processing。

注意事項

  • 單個音視頻檔案大小最大支援5 GB。

  • 上傳時檔案的副檔名大小寫不敏感,如果上傳時副檔名不支援(即格式不支援,和上傳憑證不匹配),不支援的檔案會上傳失敗。

步驟一:擷取上傳地址和憑證

通過整合服務端SDK(推薦)或自建HTTP(S)請求後調用介面CreateUploadMedia,擷取媒資上傳地址和憑證。更多資訊,請參見RPC 調用機制

重要
  • 單個上傳地址和憑證只能用於單個媒資,不能混用,否則會造成覆蓋。

  • 對於單個媒資檔案重複擷取上傳地址和憑證時,前後擷取到上傳地址和憑證不同。

  • 上傳地址由智能媒體服務自動分配,暫不支援自訂。

  • 上傳憑證有效時間為3000秒,如果視頻檔案較大,上傳過程中憑證可能會失效,需要調用RefreshUploadMedia重新整理上傳憑證,重新整理後新的憑證有效期間仍為3000秒,且上傳地址不變。

  • 圖片、輔助媒資(字幕、字型檔)檔案較小,憑證失效後需要重新擷取。

步驟二:調用OSS API上傳媒資

通過Base64解碼上傳地址和憑證後,調用OSS上傳相關的API,進行媒資上傳。更多資訊,請參見公用HTTP頭定義上傳檔案至OSS

API參考