Extract Single Frame

Pull a single frame from a video at a given timestamp and return it as an image.

When to use

• Generate thumbnails for video previews or catalog displays.
• Capture a key moment as a still image (e.g. the first frame, the midpoint).
• Create cover art from existing video content.

Inputs & outputs

Input modality	Video file (URL)
Output modality	Image file (GCS URL)
Supported output formats	png, jpeg
Max input duration	30 min

Parameters

Param	Required	Description
time_sec	yes	Timestamp in seconds to extract the frame from (non-negative)
format	no	Output image format — png or jpeg. Default: png

Examples

JPEG thumbnail at 5 seconds

{
  "type": "video.extract_frame",
  "input": { "video_url": "gs://infery-prod-media/example/input.mp4" },
  "params": { "time_sec": 5, "format": "jpeg" }
}

PNG frame at the 1-minute mark

{
  "type": "video.extract_frame",
  "input": { "video_url": "gs://infery-prod-media/example/input.mp4" },
  "params": { "time_sec": 60, "format": "png" }
}

Related capabilities

• video.trim — cut a shorter clip first to target the right region
• video.scale — resize the video before extracting a frame at a specific resolution
• video.pipeline — combine trim and frame extraction in one request

{
  "time_sec": 5,
  "format": "jpeg"
}