Scale Video Dimensions

Resize a video to target width and/or height. If only one dimension is provided, the other is calculated automatically to preserve the original aspect ratio.

When to use

• Downscale for web — reduce a 4K recording to 1080p or 720p.
• Normalize resolution before concatenating clips of different sizes.
• Resize thumbnails — scale to a fixed width for consistent display.

Inputs & outputs

Input modality	Video file (URL)
Output modality	Video file (GCS URL)
Max input duration	30 min
Max input size	5 GB

Parameters

Param	Required	Description
width	one of	Target width in pixels (positive integer)
height	one of	Target height in pixels (positive integer)

At least one of width or height must be provided. If both are given, the video is scaled to fit those exact dimensions.

Examples

Scale to 1280px wide (720p, auto height)

{
  "type": "video.scale",
  "input": { "video_url": "gs://infery-prod-media/example/input.mp4" },
  "params": { "width": 1280 }
}

Scale to exact 1920×1080

{
  "type": "video.scale",
  "input": { "video_url": "gs://infery-prod-media/example/input.mp4" },
  "params": { "width": 1920, "height": 1080 }
}

Related capabilities

• video.crop — crop to a specific region after scaling
• video.transcode — re-encode after resizing to control output bitrate
• video.pipeline — combine scale with other operations in one request

{
  "width": 1280
}