# Action Node

Action Nodes are operational tools that transform your media in predictable, deterministic ways—no AI model required. Where generation nodes use AI to create new content, Action Nodes apply precise operations like color grading, video stitching, frame extraction, and text manipulation directly to your inputs. The result is the same every time for the same settings, giving you complete control.

## Overview

Actions fill the gap between AI generation and traditional media editing. They're ideal for tasks that don't need a generative model—things like:

* **Adjusting color and tone** on an image or video
* **Splitting or stitching** video clips together
* **Extracting frames** from a video as still images
* **Changing aspect ratios** with crop or pad options
* **Manipulating text** with find-and-replace, splitting, or concatenation

Because Actions are deterministic, they're fast, inexpensive, and repeatable. You get the exact output you'd expect from the parameters you set.

***

## Getting Started

### Adding an Action Node

{% stepper %}
{% step %}
**Open the Add Node Menu**

Press the **+** button or use the canvas shortcut to open the node menu. Under the **Utilities** section, click **Action**.
{% endstep %}

{% step %}
**Choose an Action**

A picker panel opens showing all available actions. Browse the list or use the search bar to find what you need. Each action shows its input and output types (image, video, text) so you know what to connect.
{% endstep %}

{% step %}
**Connect Inputs**

Drag a connection from an upstream node (an Image, Video, or Text node) to the Action Node's input handle. The action will process whatever media is connected.
{% endstep %}

{% step %}
**Configure Parameters**

Each action has its own set of adjustable parameters (sliders, dropdowns, color pickers, toggles). Adjust these to dial in the exact result you want.
{% endstep %}

{% step %}
**Run**

Click the **Run** button on the Action Node. The result appears in one or more output slots depending on the action.
{% endstep %}
{% endstepper %}

***

## Available Actions

Actions span image, video, and text operations. Here's the full catalog:

### Image Actions

| Action                | What It Does                                                                                            | Key Parameters                                |
| --------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| **Color Grade Image** | Cinematic color grading with adjustable tone                                                            | Warmth, Contrast, Saturation, Brightness      |
| **Color Filter**      | Apply preset filters: Grayscale, Sepia, Duotone, Clarendon, Moon, Nashville, Noir, Fade, and more       | Filter preset, Intensity                      |
| **Color Tint**        | Tint an image with a chosen color using blend modes (Multiply, Screen, Overlay, Soft Light)             | Tint Color, Intensity, Blend Mode             |
| **Filter Color**      | Isolate, replace, or remove pixels matching a target color (chroma key, background removal, color swap) | Target Color, Tolerance, Mode                 |
| **Change Image AR**   | Change aspect ratio by center-cropping or padding without upscaling                                     | Aspect Ratio, Fit (Crop/Pad), Background Mode |
| **Rotate Image**      | Rotate by any angle with optional canvas expansion                                                      | Angle, Expand Canvas, Background Color        |
| **Flip Image**        | Mirror horizontally, vertically, or both                                                                | Direction                                     |
| **Blur**              | Gaussian, Box, Motion, Radial, Bilateral, Bokeh, Tilt-Shift, or Target Color blur                       | Blur Type, Radius/Amount                      |
| **Duplicate Image**   | Output N copies of an image for branching into parallel workflow lanes                                  | Number of Copies                              |

### Video Actions

| Action                       | What It Does                                                                                   | Key Parameters                                        |
| ---------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| **Color Grade Video**        | Cinematic color grading for video                                                              | Contrast, Saturation, Brightness, Gamma               |
| **Video Color Filter**       | Preset color filters for video: Grayscale, Sepia, Invert, Clarendon, Moon, Nashville, and more | Filter preset                                         |
| **Video Effect**             | Stylistic effects: Vignette, Film Grain, Pixelate, Camera Shake, Chromatic Aberration, VHS     | Effect type, Intensity                                |
| **Stitch Videos**            | Join multiple clips into one with optional transitions and aspect-ratio normalization          | Transition type, Duration, Aspect Ratio, Fit Mode     |
| **Split Video**              | Cut a video into segments by equal parts, fixed duration, or scene detection                   | Split Mode, Segment count, Sensitivity                |
| **Extract Video Frames**     | Pull still frames from video as PNG images                                                     | Mode (Single, Evenly Spaced, Interval, Scene Changes) |
| **Image to Video Ken Burns** | Animate a still image with smooth pan/zoom into a video                                        | Duration, Zoom Level, Pan Direction, Easing           |
| **Video to Frame Grid**      | Arrange extracted frames in a grid contact sheet                                               | Rows, Columns, Cell Width, Gap                        |
| **Video to Long Exposure**   | Stack all frames into a single long-exposure image (Average, Lighten, Darken blend)            | Blend Mode                                            |
| **Boomerang**                | Play a video forward then reverse for a looping clip                                           | Loops, Speed, Frame Stride                            |
| **Reverse Video**            | Play a video backwards                                                                         | Reverse Audio, Keep Original Audio                    |
| **Speed Up Video**           | Increase playback speed                                                                        | Speed Factor, Keep Audio                              |
| **Slow Down Video**          | Decrease playback speed                                                                        | Slow Factor, Keep Audio                               |
| **Watermark**                | Burn a text or image watermark into a video                                                    | Text/Image, Position, Opacity, Scale                  |
| **Greenscreen Remove**       | Chroma-key out a background color and output transparent video                                 | Color Preset, Similarity, Edge Blend                  |
| **Duplicate Video**          | Output N copies of a video for branching workflows                                             | Number of Copies                                      |

### Text Actions

| Action               | What It Does                                                                         | Key Parameters                              |
| -------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------- |
| **Split Text**       | Split text into parts by separator, regex, paragraph, line count, or character count | Split Mode, Separator, Max Parts            |
| **Find and Replace** | Find and replace text with optional regex, case-insensitive, and whole-word modes    | Find, Replace, Use Regex, Case Sensitive    |
| **Concat Text**      | Combine multiple text inputs into one                                                | Separator, Prefix, Suffix, Trim, Skip Empty |

***

## How Actions Work

### Inputs and Outputs

Every action declares typed **input slots** and **output slots**. The Action Node shows modality badges (image, video, text) on each slot so you can see at a glance what connects where.

* **Single inputs** accept exactly one connection (e.g., one image to color-grade)
* **Dynamic inputs** accept multiple connections (e.g., Stitch Videos takes 2+ video clips)
* **Single outputs** produce one result (e.g., a color-graded image)
* **Dynamic outputs** produce a variable number of results (e.g., Split Video outputs multiple video segments)

### Parameters

Actions expose configurable parameters directly on the node—no prompt writing needed. Parameter types include:

* **Sliders** for numeric values (warmth, contrast, speed factor)
* **Dropdowns** for preset options (blur type, filter style, aspect ratio)
* **Color pickers** for color-based operations (tint color, background color)
* **Toggles** for boolean options (keep audio, expand canvas)
* **Text fields** for string inputs (watermark text, separator)

Some parameters are conditional—they only appear when a related setting is active. For example, the Blur Amount slider in Change Image AR only shows when Fit is set to "Pad" and Background Mode is "Blur."

## Actions in Workflows

Actions become especially powerful when connected into larger workflows alongside other Flora nodes.

### Chaining with Generation Nodes

Use actions to prepare media before or after AI generation:

```
[Text Node] → [Image Node: Generate] → [Color Grade Image] → Final Output
              "product on white bg"     warmth=0.2, contrast=1.3
```

Generate an image with AI, then apply deterministic color grading for a consistent brand look.

### Combining with Techniques

Actions work seamlessly as steps before or after Techniques:

```
[Image Upload] → [Change Image AR] → [Technique: Product Lifestyle] → Final Output
                  9:16 portrait
```

Reformat your image to the right aspect ratio before feeding it into a multi-step technique.

### Batch Processing

Connect a [Batch Node](/nodes/batch-node.md) to an Action Node to apply the same operation across many items at once:

```
[Image 1] ─┐
[Image 2] ─┼─→ [Batch Node] ─→ [Color Grade Image] → 4 graded outputs
[Image 3] ─┤     (4 items)      warmth=0.15
[Image 4] ─┘
```

Every item in the batch is processed with identical settings—perfect for maintaining visual consistency across a set of assets.

### Multi-Step Action Chains

Actions can chain together for complex transformations without any AI:

```
[Video Upload] → [Split Video] → [Extract Frames] → [Color Filter: Noir]
                  3 segments       per segment          per frame
```

### Cross-Modality Conversions

Some actions convert between modalities, enabling creative cross-format workflows:

```
[Image] → [Ken Burns Video] → [Stitch Videos] → Final Video
[Image] → [Ken Burns Video] ─┘
```

Turn still images into animated clips and stitch them into a sequence—all without AI generation.

***

## Tips

* **Test with one input first** before connecting a batch—dial in your parameters on a single item, then scale up
* **Chain actions freely**—they're lightweight and fast, so stacking multiple actions adds minimal time
* **Use Duplicate Image/Video** to branch a single input into parallel workflow lanes with different downstream processing
* **Dynamic outputs** (like Split Video or Extract Frames) produce multiple result nodes—each can feed into its own downstream workflow


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flora.ai/nodes/action-node.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
