Nodes and connectors

Everything in Spaces starts with nodes and connectors. Each node can contain content, like text or media, or trigger actions using tools such as generators, the Assistant, or the Upscaler. Connectors define how those nodes interact, passing information from one step to the next.

This page shows how to add, use, and connect nodes to structure your creative flow.

Types of nodes

Each node in Spaces serves a specific purpose. Some are for input, others for generation or transformation. You can combine them in any order to match the structure of your workflow.

Below is an overview of the main node types:

Upload and Media nodes

There are two ways to add assets to your canvas:

Upload: Use files directly from your computer. This option supports starting from your own images or videos.
Media: Select content from your personal history, Freepik stock, or the Community library. This allows you to reuse, remix, or test with existing visuals.

These nodes act as inputs and can connect to other nodes, such as generators, upscalers, or the Assistant.

Text

The Text node lets you add written content to your workflow. You can use it to write prompts or leave notes, such as describing steps or adding context. This helps you organize your ideas and keep your flow easy to follow.

When you click the node or start typing, a toolbar appears above it. This bar includes:

Change node background color.
Rename, duplicate, or delete the node.
Open preview to view the full content.
Once your text is ready, click the Run button in the action bar to process the text.

While typing, the same bar expands to show text formatting options:

Set text style: Paragraph, Heading 1, Heading 2, or Heading 3.
Apply bold or italics.
Create a bullet list or numbered list.
Insert a horizontal rule.

These options make the Text node useful for both content creation and visual organization within your Space.

Generator nodes

Spaces includes several types of generator nodes that help you create content using AI. These include the Image Generator, Video Generator, Assistant, and Image Upscaler. Here's how they work:

Image Generator

Generates images based on text or visual inputs. You can set:

The model used for generation.
Aspect ratio.
Number of images to create.

Image Generator nodes accept prompts, reference images, or a combination of both.

To see how it works in practice, try the template Explore how to create Images in Spaces, available under Spaces > Templates > Getting Started. It gives you a guided setup to start generating visuals right away.

Video Generator

Creates short-form video content. You can customize:

The generation model.
Duration.
Aspect ratio.
Resolution.
Number of outputs.

This node is useful when converting concepts or visuals into motion.

If you want to try it out, use the template Let’s create your first Video in Spaces available under Spaces > Templates > Getting Started. It walks you through the key steps for generating video.

Assistant

An AI-powered helper for writing, describing, or exploring ideas. This node can:

Generate prompts from texts or visual references.
Describe images, videos, or assets in context.
Provide variations or creative suggestions.
Explore creative directions or refine existing ideas.

The Assistant adapts to the data you connect and supports many use cases, from ideation to automation. It can help you build faster, clarify steps, or generate new inputs within your workflow.

Image Upscaler

Improves the resolution and quality of an image. Configuration options include:

Upscaling mode (Creative or Precision)
Scale factor.
Additional settings like engine type and presets.

If you need more information about the different upscaling modes and settings, you can check the Image Upscaler page.

Camera Angles

Produces multiple realistic perspectives from a single image (AI-generated or not) with precise control over viewpoint and framing. The node supports:

Rotating the image to display front, side, or top angles.
Setting camera positions and simulating subtle movements.
Defining start and end frames for smooth video transitions.
Preserving visual quality and detail consistency.

Camera Angles adds precision and flexibility to any workflow, delivering motion and depth to static visuals. It’s great for product imagery, interior design, and video concept development.

Node options: Action bar

When you click a node while using the selection tool, a horizontal action bar appears just above it. This bar gives you quick access to common actions, though the exact options vary depending on the type of node.

Here are the available actions, some of which may only appear for specific nodes:

Run: Execute the node and generate output.
Duplicate: Copy the node.
Delete: Remove it from the canvas.
Download: Save the generated image or video (for output nodes).
Open preview: View the output in full.
Edit image: Open the editing tool for visuals.
Replace creation: Swap the current input with another.
Reset creation: Clear the output and reset the node.

You can also use the Run button in the bottom-right corner of the node to reprocess content. Choose This node only or Run from here to control how much of the flow is rerun.

Adding a node

Nodes are the starting point for any flow. Here’s how to place one on the canvas:

Go to the left sidebar of your Space.
Click the + Add element button.
Choose the type of node you want to use.

You can reposition, lock, duplicate, or delete any node once it’s on the canvas.

Understanding connectors

Connectors define how data moves between nodes in a workflow. They link steps together in a clear sequence, helping you create a structured and repeatable process.

Each connector links an output point (top-right corner of a node) to an input point (bottom-left corner of another node). These points become visible when you hover over the node.

Connectors are one-directional. Information flows from the source node to the connected node.

If you want to practice using connectors in a real setup, go to Spaces > Templates and try the template Mastering Spaces: From Connection to Creation. It's a guided example to help you understand how nodes interact and flow together.

How to connect nodes

To create a connection:

Hover over the source node to reveal the output point (top-right corner).
Click and drag a line from the output to the input point (bottom-left corner) of the target node.
Release to complete the connection.

Once connected, the receiving node uses the incoming data as input for its operation. Remember that you can send one output to multiple inputs.

To remove a connector, simply click on the connection line.

When to use connectors

Connectors allow you to control how information flows between nodes in your workflow. Depending on the node type, you may be able to send or receive specific inputs.

Here’s how connectors apply to each node type:

Asset nodes: Provide output only. These nodes do not accept any inputs. You can connect their output to other nodes that require image or video input, such as the Image Generator, Video Generator, Assistant, or Image Upscaler.
Text nodes: Provide output only. These do not accept inputs. Connect them to nodes that require prompt input, such as the Image Generator, Video Generator, or Assistant.
Image Generator nodes: Accept two inputs: one for text prompts and one for reference images. Also includes an output for generated images, which you can connect to other nodes like the Upscaler or Assistant.
Video Generator nodes: Accept text and reference image inputs. They have an output that passes generated videos to other nodes (such as the Assistant).
Assistant nodes: Accept text and reference inputs. Its output can be connected to generators or used as a basis for further steps in the workflow.
Image Upscaler nodes: Accept one image input via connector and provide an upscaled output. They do not support connected text, but when using the Creative mode, you can manually enter a text prompt within the node settings to guide the result.
Camera Angles nodes: Accept a single image input, either through a connector or a reference image, and provide a new output showing the same content from a different angle. They do not support text or video inputs. Still, the resulting image can be treated as a generated output and connected to other nodes, such as the Upscaler or Video Generator.

Use connectors to define the order of operations and re-use inputs across multiple outputs. For example, a single Text node can be connected to both an Image Generator and a Video Generator to produce different formats from the same prompt. As your Space grows, grouping related nodes and keeping a clear layout helps maintain structure and makes complex flows easier to understand.

Running a node

After connecting nodes, you need to run them to execute their tasks and generate results.

There are two ways to run nodes:

1. Run a single node

Click the Run button in the bottom-right corner of the node.
Generator nodes must have all required inputs before the button becomes active.
Once run, the node produces an output you can use in the next step.

This is useful when you're testing specific parts of your workflow or working in sections.

2. Run from a specific point

Click the Run icon, then select Run from here.
This triggers the selected node and all nodes that follow it in the connected flow.

Use this option when you want to process multiple steps at once, especially after updating an input earlier in the flow.

Running is always a manual action, giving you full control over how and when your workflow progresses.

Next steps

Now that you understand how nodes and connectors work, continue with:

Your first space: Build and test your own workflow.
Collaboration: Share your Space and work with teammates.

Can't find an answer to your question?