Skip to main content
A node is a single operation in a Knouds pipeline. It accepts data through input handles on its left edge, processes it, and emits results through output handles on its right edge. Connecting nodes together forms a directed graph that Knouds executes from start to finish when you press Run.

​
Inputs and outputs

Every node has zero or more handles on each side:
  • Input handles (left) — receive data wired in from an upstream node’s output.
  • Output handles (right) — emit data that downstream nodes can consume.
Handles are color-coded by data type. See the handle color reference on the canvas page for the full table.

​
Node categories

Nodes are organized into categories in the sidebar.

Inputs

Request Input — defines the fields that callers send when running the workflow via API. Upload — lets you attach a file directly on the canvas during a run.

LLMs

Assistant — runs a language model call. Built-in models include Claude Sonnet, GPT-5.4 Mini, and Gemini 3.1 Flash Lite. Accepts text prompts and optional image inputs, returns text.

Image Models

Image Generator — generates images from text prompts or reference images. Built-in models include Nano Banana 2, Seedream V5 Lite, and GPT Image 2.

Video Models

Video Generator — produces video from text prompts or a starting image. Built-in models include Seedance 2.0 (Full Access, Fast, and base variants), Kling Video v2.5 Turbo Pro, Kling V3 Pro I2V, Kling O3 Pro Ref2V, and Kling V3 Motion.

Music Models

Music Generator — generates audio tracks from text descriptions using the selected model (e.g. Suno V5). All music models are registry-based.

Utilities

List — processes arrays of items. HTTP Request — makes arbitrary HTTP calls to external APIs.

Custom

Custom Model and Registry Node — models added by your workspace admin via the Node Builder. They appear in this category alongside built-in nodes.

Outputs

Response Output — collects the data you want to return as the workflow’s API response.

​
How data flows

When you run a workflow, Knouds automatically determines the correct execution order. It starts from nodes with no unmet inputs and works forward through the graph, passing each node’s output into the inputs of every connected downstream node.
Only nodes that are connected to the execution graph run. Disconnected nodes are skipped entirely. This means you can leave unused nodes on the canvas without them affecting your results or consuming credits.

​
Node status states

Each node displays a status indicator during and after a run:
StateMeaning
IdleNot yet run in this session
ExecutingCurrently processing
CompletedFinished successfully — output is available
ErrorAn error occurred — check the node’s output panel for details
If a node fails, downstream nodes that depend on its output are also prevented from running, cascading the failure through that branch of the graph.

​
Linked fields

When a node’s input field is connected to an output handle from another node, the field becomes linked. Linked fields display a badge instead of an editable control, and their value is read-only on the canvas — the value is supplied at run time by the upstream node.

​
The side panel inspector

Clicking a node opens the side panel on the right side of the canvas. The panel shows all configuration fields for that node, including settings that are not shown directly on the canvas card (such as system prompts, reference images, and output format options).
For generator nodes, the side panel is the best place to configure reference images (start frame, end frame, style, character) and advanced parameters, without cluttering the canvas card.