Skip to main content

​
Artifacts

Artifacts are the data objects that carry information between nodes during flow execution. Each step produces an artifact that downstream steps can access.

​
Artifact structure

A StepArtifact can contain any combination of:
FieldTypeDescription
promptstringText prompt or generated script
imageUrlstringURL of a generated or uploaded image
videoUrlstringURL of a generated or uploaded video
mediaUrlstringURL of uploaded media (image or video)
mediaType”image” | “video”Type of the uploaded media
scenesstring[]Array of scene descriptions (from script generation)
sceneImagesstring[]Array of generated image URLs per scene
sceneVideosstring[]Array of generated video URLs per scene
clipTrimsClipTrim[]Video clip trim points (start, end, duration)
shotDetailsShotDetail[]Per-shot text, image prompt, and video prompt
captionWordsCaptionWord[]Transcribed words with timestamps
captionStyleCaptionStyleCaption styling configuration
audioUrlstringURL of generated or selected audio
audioTitlestringTitle of the audio track
audioArtiststringArtist of the audio track
audioDurationnumberLength of the audio in seconds
audioLicenseUrlstringLicense URL for the audio track

​
How artifacts flow

Artifacts are stored in a key-value map indexed by step number. When a node executes:
  1. It reads artifacts from previous steps that are connected to it
  2. It produces a new artifact with its output data
  3. Downstream nodes can access this artifact

​
Example flow

Text Input (artifact: { prompt: "A sunset over the ocean" })
    ↓
Image Generation (artifact: { imageUrl: "https://..." })
    ↓
Image-to-Video (artifact: { videoUrl: "https://..." })
Each step accesses the previous step’s artifact to get its input data.

​
Artifact types by node

Node TypeProduces
Text Inputprompt
Script Generationprompt, scenes, shotDetails
Image GenerationimageUrl
Text-to-VideovideoUrl
Image-to-VideovideoUrl
Media UploadmediaUrl, mediaType
Auto CaptionscaptionWords, captionStyle, videoUrl
VoiceoveraudioUrl, videoUrl
Background AudioaudioUrl, audioTitle, audioArtist
Multi-Shot GenerationsceneImages, sceneVideos, shotDetails
Clip FinderclipTrims