Calling this endpoint reserves the estimated credits and returns signed URL(s) for multi-part upload.
Video uploads
The Video API uses segmented uploads to ingest footage for processing. You can use a simple byte-division function to create segments for the API to receive.
For example, if you have a 850MB video file, the system will return 3 upload URLs. You would then:
- Upload bytes 0-283,333,332 to
urls[0] - Upload bytes 283,333,333-566,666,665 to
urls[1] - Upload bytes 566,666,666-849,999,999 to
urls[2]
The system divides the total file size evenly across the number of parts, ensuring each part (except possibly the last) is of equal size.
If 2 URLs are returned for a 100 MB file, for example, upload bytes 0-49 to urls[0] and bytes 50-100 to urls[1].
If one of the uploads fail, you may reuse the same URL - 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.
Response body
| Property | Type | Description |
|---|---|---|
| uploadId | String | Upload ID for multi-part upload |
| urls | Array | URLs for multi-part uploads |
| message | String | Response message |