Video

Video transformation is a resource-intensive operation, so it takes a significant amount of time and heavily depends on the size of the original file. It is recommended to use asynchronous transformation for video processing.

If the video file has not yet been transformed, a response with a 423 status code will be sent, indicating that the file is not yet ready.

Example:

// optimize video size ?q_a
https://api.defaultuploader.com/v1/video/upload/token/sample.mp4?q_a

q_auto

alias: q_a

Sets optimal video settings, preserving quality while reducing file size.

?q_a

q_a

width

alias: w

Creates a video with the specified width while maintaining the correct aspect ratio.

min 0, max 5000

w=300

height

alias: h

Creates a video with the specified height while maintaining the correct aspect ratio.

min 0, max 5000

h=300

format

alias: f

Changes the video format.

Supported formats
MP4, MOV, WEBM, AVI, default is mp4

vertical

alias: vt

Creates a video in a 9x16 format by cropping the center.

?vt

thumbnail

Creates a thumbnail image from the video.

?thumbnail
By default, a frame from the first 100ms of the video is used.

duration

Specifies the moment in the video to create the thumbnail.

1 = 100ms
Works only with the thumbnail property.

keyframe

alias: kf

Sets the keyframe interval (GOP size) for the video. A keyframe interval defines how often a full frame is inserted into the video stream. Lower values improve seek accuracy and editing precision but increase file size.

min 1, max 120
?keyframe=30

kf_boost

Enables an adaptive keyframe placement strategy. When enabled, keyframes are placed more frequently at the beginning of the video (every 0.5 seconds during the first 5 seconds) and less frequently afterward (every 2 seconds). This improves initial playback and seek performance for the start of the video.

?kf_boost