The Video library to save and manage your video assets is essential for creating a VOD encoding or a Livestream. It provides a convenient way to access these assets for encoding or deletion when they are no longer needed, thus helping to optimize storage space usage.

Certain requirements need to be followed when uploading files to the Video library. 

1. Upload your asset

We offer three options to provide your asset sources:

• Upload the asset file from the local storage
• Copy the asset file from your cloud storage

If you'd like to upload the asset file, you can use the following API with the file type, file source, and file size to request an upload.

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

Here is the example of the request body:

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

After a successful response, you will receive the upload ID of your file, how many parts you should split the file, and the one-time presigned URLs for uploading.

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

Now you can upload the split files to the AWS S3 bucket for BlendVision One using the presigned URLs. Note that the part size should be 5 MiB to 5 GiB, and the last part of your multipart upload has no minimum size limit.

2. Notify the uploads completed

After completing all the uploading, you can use the following API to notify that the asset file is ready to access.

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
    }
  ]
}