Skip to main content

​
Flow Runner

The Flow Runner is Hyperclip’s execution engine. It takes your flow (the node graph you built in the Flow Builder) and runs it step-by-step to produce a finished video.

​
Execution model

The Flow Runner:
  1. Converts your node graph into a topologically sorted sequence of steps
  2. Merges Choice Groups into single choosable steps
  3. Separates background and interactive steps — background steps auto-execute, interactive steps wait for your input
  4. Manages artifacts — Data produced by each step (images, videos, text) is passed to downstream steps

​
Step types

​
Background steps

These execute automatically without user input:
  • Script Generation
  • Image Generation
  • Text-to-Video Generation
  • Image-to-Video Generation
  • Motion Transfer
  • AI Transform
  • Parse Scenes
  • Continuity Enhance
  • AI Music
  • Clip Finder
  • Split (For Each)
  • Collect (Merge)
Background steps show a loading spinner with a status message. Credits are deducted automatically before each generation.

​
Interactive steps

These pause execution and wait for your input:
  • Text Input
  • Media Upload
  • TikTok Scraper
  • YouTube Scraper
  • Text Editor
  • Review / Approve
  • Auto Captions
  • Voiceover
  • Background Audio
  • Audio Overlay
  • Mixed Media Analysis
  • Multi-Angle Generation
  • Approve & Export
The flow runner displays a stepper showing only interactive steps. Background steps run between interactive steps without appearing in the stepper.
  • Use Next to advance to the next interactive step
  • Use Back to return to a previous step (skips background steps)
  • Background steps run automatically when you advance past them

​
Credit handling

Credits are checked and deducted before each AI generation step. If you don’t have enough credits, the step cancels and you’re notified.