Actions21
Image Sequence Export
AI-generatedSummary
Export video frames as an image sequence using FFmpeg.wasm.
Inputs
- binaryPropertyName — Name of the binary property containing the input video file. Default: 'data'.
- outputBinaryPropertyName — Name of the binary property to store each exported frame. Default: 'data'.
- sequenceOutputFormat (required) — Output image format for exported frames. Options: PNG, JPEG, WebP. Default: 'jpg'.
- sequenceWidth — Output width in pixels. Use -1 to retain original width.
- sequenceHeight — Output height in pixels. Use -1 to retain original height.
- sequenceFps — Extract one frame every N seconds. fps=1 means 1 frame per second. Default: 1.
- sequenceStartTime — Start time for frame extraction (HH:MM:SS or seconds). Default: '00:00:00'.
- sequenceDuration — Duration of frame extraction in seconds. Leave empty to extract from start time to video end.
- sequenceQuality — JPEG/WebP quality (1-100). Applied via FFmpeg -q:v. Default: 90.
- additionalOptions — Optional collection for timeout, enableLogging, and encodingPreset.
Output shape
An array of items, one per extracted frame. Each item contains:
json: original item JSON augmented with ffmpeg metadata (operation, inputFilename, outputFilename as frame name, frameIndex, size in bytes). binary: outputBinaryPropertyName key mapped to { data: base64-encoded image, fileName: frame_XXXX.ext, mimeType: image/... }.
Examples
Example 1: Extract first 5 seconds of a video as JPEG frames at 1 fps, starting from 00:00:10.
binaryPropertyName: 'data'; outputBinaryPropertyName: 'frameData'; sequenceOutputFormat: 'jpg'; sequenceWidth: -1; sequenceHeight: -1; sequenceFps: 1; sequenceStartTime: '00:00:10'; sequenceDuration: '5'; sequenceQuality: 90