（以下內容均翻譯自英文版文件，最新資訊及內容敬請切換至英文語系參考原文）

影片庫 對於管理影片資產至關重要，尤其是在建立 VOD 轉檔或直播串流時。它是影片檔案的中央儲存資料庫，提供了一種簡化的方式來訪問這些資產，以便在不再需要時進行轉檔或刪除。這種高效的影片資產管理有助於優化儲存空間的使用。

將檔案上傳到影片庫時，必須遵守以下規範。針對不同類型檔案，影片庫支援特定的格式和大小：

1. 上傳資產

我們為您的資產來源提供三種選擇：

• 從本機儲存上傳資產檔案
• 從您的雲端儲存空間中複製資產檔案

如果您想上傳資產檔案，可以使用以下 API 並輸入檔案類型、檔案來源和檔案大小來請求上傳。

POST /bv/cms/v1/library/files:upload

以下是請求主體的範例：

"file":{
  "type":"FILE_TYPE_VIDEO",
  "source":"FILE_SOURCE_ADD_VOD",
  "name":"file_name",
  "size":"file_size_in_bytes"
}

回應成功後，您將收到上傳檔案的 ID、您應分割成的檔案數量以及用於上傳每個分割檔的一次性預指定 URL。

以下是一個回應範例：

"upload_data":{
  "id":"upload_id_of_your_file",
  "parts":[
    {
      "part_number":0,
      "presigned_url":"string"
    },
    {
      "part_number":1,
      "presigned_url":"string"
    }
  ]
}

然後，您可以使用這些預指定的 URL 將分割檔上傳到 BlendVision One 的 AWS S3 儲存空間。請注意，分段大小應為5 MiB到5 GiB，並且分段上傳的最後一部分沒有最小大小限制。

通知上傳已完成

上傳檔案的所有分割檔後，您必須通知系統上傳已完成，資產檔案可隨時訪問。您可以使用以下 API 來完成這項工作：

POST /bv/cms/v1/library/files/{id}:complete-upload

以下是請求主體的範例：

"complete_data":{
  "checksum_sha1":"pdDzow0HQgS+BeLRmgWFL6/Zccw=",
  "id":"rIRIDq829eK9VqjlX7K0iSRRwpLBa6F2Qea0ojXKOCp0cExQEg.0XayecVa_hEV2uW4hsN5DDFBKNiYQIGHRTrEgUXS072GsMBMA49eJXAMBVvK68mQGeLGNafXkNvkLuupz_tuo07gcw5OCEuqEBA--",
  "parts":[
    {
      "etag":"5021b3b7c402468d5b018a8b4a2b448a",
      "part_number":1
    }
  ]
}

checksum_sha1 是物件的 64 編碼的 160 位 SHA-1 摘要。etag 可從上載的預簽名 URL 的回應標頭中取得。

下圖是整個過程的示意圖：