Sign in
latestOpenAPI 3.1.22026-08-10223187.9 KB

7610937217a4

Accept Request

Accept and Upload Video Request

Calling this endpoint reserves the estimated credits and returns signed URL(s) for multi-part upload.

Video uploads

The Video API uses multi-part upload to receive the video file for processing. You can use a simple byte-division function to create segments for the API to receive.

For example, if you have a 900MB video file and the system returns 3 upload URLs. You would then:

  • Upload bytes 0-300,000,000 via HTTP PUT to urls[0]
  • Upload bytes 300,000,001-600,000,000 via HTTP PUT to urls[1]
  • Upload bytes 600,000,001-900,000,000 via HTTP PUT to urls[2]

If one of the uploads fail, you may reuse the same URL to retry - the action overwrites any partially uploaded data.

A successful response from the PUT request returns an ETag value in the header for each segment. Retain the part number and ETag pair for the next step (PATCH /video/{requestId}/complete-upload/).

Response body

PropertyTypeDescription
uploadIdStringUpload ID for multi-part upload
urlsArrayURLs for multi-part uploads
patch/video/{requestId}/accept

Path parameters

requestIdstring uuid required

Response

Successful response

uploadIdstring

Upload ID for completing multi-part upload

urlsstring[]

URLs to PUT the parts to. The source video should be split into urls.length number of byte ranges.

messagestring

The endpoint will return message only if the video will be sourced from an external storage provider