Video
Video integration · 24 node(s).
00Overview
Turn media processing into ordinary flow steps: trim, join, crop, rotate, scale and transcode video, extract or replace audio, burn in captions, watermarks and picture-in-picture overlays, and generate GIFs, thumbnails, frame stills, slideshows and waveform images. Feed in a file or blob reference from an earlier step - an upload, a download or another video action - and each node hands back a new media reference you can pass straight to the next one. Everything runs on the flow's own runner, so there is no account to link and nothing leaves your infrastructure.
Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.
01Connecting Video
- The Video nodes need no account, API key or secret — they process media directly on the runner that executes your flow, so there is nothing to link and nothing leaves your infrastructure.
- Make sure the runner host has ffmpeg and ffprobe installed and on its
PATH(a platform administrator normally handles this); an operator can otherwise point the runner at explicit binaries with theFLOMATION_FFMPEG_PATHandFLOMATION_FFPROBE_PATHenvironment variables. Actions fail fast with a clear message if either binary is missing. - Give each node its media through the file/blob reference field — a
flo:file:…orflo:blob:…value produced by an earlier step such as an upload, an HTTP download or another Video node. - Wire the node's output reference (video, audio or image) into the next node in the flow; because the source is never altered in place, you always continue from the fresh result.
02Adjust
Adjust Audio
video/adjust_audio · Action
Change volume, loudness-normalise, or fade an audio or video's audio in/out
| Field | Type | Details | |
|---|---|---|---|
| Audio or video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Operation | string | choices: Normalise loudness, Change volume (dB), Fade in, Fade out | |
| Amount (dB for volume, seconds for fades) | string | 3 |
Returns: tool_result, media, size_bytes, success, error
03Burn
Burn Text onto Video
video/burn_text · Action
Overlay a text caption onto a video, burned into the picture
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Caption text | text | Required | Your caption |
| Font size (px) | integer | ||
| Text colour | string | white, #ff0000 | |
| Position | string | choices: Top, Centre, Bottom | |
| Font file path (optional override) | string | /path/to/font.ttf |
Returns: tool_result, video, size_bytes, success, error
04Concat
Concatenate Videos
video/concat · Action
Join several videos end to end into one (given as a list of references)
| Field | Type | Details | |
|---|---|---|---|
| Video references (one per line, in order) | text | Required | flo:file:… flo:blob:… |
| Re-encode (use if the clips differ) | boolean |
Returns: tool_result, video, count, size_bytes, success, error
05Convert
Convert Audio
video/convert_audio · Action
Convert an audio file to mp3/aac/wav/ogg/flac at a chosen bitrate
| Field | Type | Details | |
|---|---|---|---|
| Audio (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Format | string | choices: MP3, AAC, WAV (lossless), OGG, FLAC (lossless) | |
| Bitrate (lossy formats) | string | choices: 128 kbps, 192 kbps, 256 kbps, 320 kbps |
Returns: tool_result, audio, format, size_bytes, success, error
06Crop
Crop Video
video/crop_video · Action
Crop a rectangular region from a video by position and size
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Left offset (px) | integer | ||
| Top offset (px) | integer | ||
| Width (px) | integer | Required | |
| Height (px) | integer | Required |
Returns: tool_result, video, size_bytes, success, error
07Extract
Extract Audio
video/extract_audio · Action
Extract the audio track from a video as mp3/aac/wav/ogg
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Audio format | string | choices: MP3, AAC, WAV, OGG | |
| Bitrate | string | choices: 128 kbps, 192 kbps, 256 kbps, 320 kbps |
Returns: tool_result, audio, format, duration_seconds, size_bytes, success, error
08Fade
Fade Video In / Out
video/fade · Action
Fade a video in from and/or out to black over a number of seconds
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Fade in (seconds, 0 = none) | string | 1 | |
| Fade out (seconds, 0 = none) | string | 1 |
Returns: tool_result, video, size_bytes, success, error
09Frames
Extract Frames
video/frames · Action
Extract still frames from a video as images at a chosen rate
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Frames per second | string | 1 | |
| Image format | string | choices: PNG, JPEG | |
| Maximum frames | integer |
Returns: tool_result, frames, first_frame, count, success, error
10Gif
Video to GIF
video/gif · Action
Convert a video, or a portion of it, into an animated GIF
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Start (seconds) | string | 0 | |
| Duration (seconds, blank = whole) | string | 5 | |
| Frames per second | string | 12 | |
| Width (px) | integer |
Returns: tool_result, gif, size_bytes, success, error
11Info
Get Video Info
video/info · Action
Read a video's duration, resolution, codecs and bitrate (ffprobe)
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
Returns: tool_result, duration_seconds, format, video_codec, audio_codec, width, height, bitrate, size_bytes, success, error
12Ken
Ken Burns (Animate Image)
video/ken_burns · Action
Animate a still image with a slow zoom and pan, producing a video clip
| Field | Type | Details | |
|---|---|---|---|
| Image (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Duration (seconds) | string | 5 | |
| Zoom | string | choices: Zoom in, Zoom out | |
| Width (px) | integer | ||
| Frames per second | integer |
Returns: tool_result, video, size_bytes, success, error
13Mix
Mix Audio
video/mix_audio · Action
Mix two audio tracks into one (e.g. background music under a voiceover)
| Field | Type | Details | |
|---|---|---|---|
| First audio (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Second audio (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Result length | string | choices: As long as the longest, As long as the shortest, As long as the first | |
| Format | string | choices: MP3, AAC, WAV |
Returns: tool_result, audio, size_bytes, success, error
14Mute
Mute Video
video/mute · Action
Remove the audio track from a video (video is copied, not re-encoded)
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
Returns: tool_result, video, size_bytes, success, error
15Overlay
Overlay Video / Graphic
video/overlay · Action
Composite an animated or static graphic onto a video (picture-in-picture)
| Field | Type | Details | |
|---|---|---|---|
| Base video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Overlay graphic — video/GIF/image (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Position | string | choices: Centre, Top, Bottom, Top left, Top right, Bottom left, Bottom right | |
| Margin (px) | integer | ||
| Overlay width (px, 0 = original) | integer | ||
| Loop the overlay to the video length | boolean | ||
| Show from (seconds, blank = start) | string | 0 | |
| Show for (seconds, blank = whole) | string | 5 |
Returns: tool_result, video, size_bytes, success, error
16Rotate
Rotate / Flip Video
video/rotate_video · Action
Rotate a video by 90/180/270° and/or flip it horizontally or vertically
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Rotate | string | choices: None, 90° clockwise, 180°, 270° clockwise | |
| Flip | string | choices: None, Horizontal, Vertical |
Returns: tool_result, video, size_bytes, success, error
17Scale
Scale Video
video/scale · Action
Resize a video to a standard resolution, keeping the aspect ratio
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Resolution | string | choices: 1080p, 720p, 480p, 360p |
Returns: tool_result, video, width, height, size_bytes, success, error
18Set
Set Video Audio
video/set_audio · Action
Replace a video's audio track with a supplied audio file
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Audio (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Trim to the shorter track | boolean |
Returns: tool_result, video, size_bytes, success, error
19Slideshow
Slideshow from Images
video/slideshow · Action
Build a video from a list of images, each shown for a set number of seconds
| Field | Type | Details | |
|---|---|---|---|
| Image references (one per line, in order) | text | Required | flo:file:… flo:blob:… |
| Seconds per image | string | 3 | |
| Width (px) | integer |
Returns: tool_result, video, image_count, size_bytes, success, error
20Speed
Change Video Speed
video/speed · Action
Speed up or slow down a video (audio pitch is preserved)
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Speed | string | choices: 0.5× (half speed), 1× (unchanged), 1.5×, 2×, 4× |
Returns: tool_result, video, size_bytes, success, error
21Thumbnail
Create Thumbnail
video/thumbnail · Action
Capture a single frame from a video as a PNG or JPEG image
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Timestamp (seconds) | string | 1 | |
| Image format | string | choices: PNG, JPEG |
Returns: tool_result, image, format, size_bytes, success, error
22Transcode
Transcode Video
video/transcode · Action
Re-encode a video to a chosen format (codec + container) and quality
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Format | string | choices: MP4 (H.264), MP4 (H.265/HEVC), WebM (VP9), MKV (H.265) | |
| Quality | string | choices: High (larger file), Medium, Low (smaller file) |
Returns: tool_result, video, format, size_bytes, success, error
23Trim
Trim Video
video/trim · Action
Cut a clip from a video by start time and duration
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Start (seconds) | string | 0 | |
| Duration (seconds) | string | Required | 10 |
| Re-encode (slower, frame-accurate) | boolean |
Returns: tool_result, video, duration_seconds, size_bytes, success, error
24Video
Watermark Video
video/video_watermark · Action
Overlay an image (logo/watermark) onto a video at a chosen position
| Field | Type | Details | |
|---|---|---|---|
| Video (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Overlay image (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Position | string | choices: Centre, Top left, Top right, Bottom left, Bottom right | |
| Margin (px) | integer |
Returns: tool_result, video, size_bytes, success, error
25Waveform
Audio Waveform Image
video/waveform · Action
Render an audio track as a waveform PNG image
| Field | Type | Details | |
|---|---|---|---|
| Audio (file/blob reference) | string | Required | flo:file:… or flo:blob:… |
| Width (px) | integer | ||
| Height (px) | integer | ||
| Colour | string | #00aa9c |
Returns: tool_result, image, size_bytes, success, error
26Notes & Limitations
Behaviours and constraints worth knowing before you build with these nodes.
- Every action that transforms media hands back a brand-new reference and leaves the file you fed in untouched, so wire each node's output reference into the node that follows it.
- Trim and Concatenate copy the existing streams by default, which is fast and lossless but not frame-accurate, so switch on Re-encode when you need an exact cut or when joining clips that differ in codec, resolution or frame rate.
- Processing is time-bounded on the runner: lighter actions are capped at two minutes and heavier ones such as concatenation, transcoding and replacing a video's audio at ten, so very long or high-resolution sources can time out and fail.
- Burning a text caption into a video needs a TrueType font on the runner and will fail if none is found, unless you point it at a specific font-file path.