Upload a video from your local device. If the upload is successful, a 201 Created status code is returned along with the video’s ID and metadata.
⚠️ IMPORTANT: The video is not yet ready for enhancement when this endpoint returns 201 Created. This is because the video is still being uploaded to the cloud storage. After uploading the video, follow these steps to ensure the video is fully uploaded and ready for enhancement:
Poll for video’s status:
- Use the
get uploaded videoendpoint to check the status of the video.- Poll this endpoint periodically to check the
filefield in the response.Checking the
fileField:
- If the file field is
null, the video is still being prepared.- Once the file field contains a URL, the video is ready for further processing and enhancement.
Token-based authentication with required prefix "Token"
Pre-signed uploaded video URL. The URL may expire after some time. To generate a new URL, call the endpoint again. If the field is null, it means the video hasn't been completely uploaded to our servers yet. The field can also be null if the video was enhanced using the /jobs/from-url endpoint. In that case the video is not stored on our servers and the field is null
Media name
Width of the video in pixels
Height of the video in pixels
Date when the media was created
Number of frames in the video
Video framerate in frames per second
Size of the video in bytes
Thumbnail of the video. null if the video was enhanced with the /jobs/from-url endpoint
Video bitrate in bits per second
Bit depth of the video
Pre-signed uploaded video URL. The URL may expire after some time. To generate a new URL, call the endpoint again. If the field is null, it means the video hasn't been completely uploaded to our servers yet. The field can also be null if the video was enhanced using the /jobs/from-url endpoint. In that case the video is not stored on our servers and the field is null