Nodes/arkennemasis - ChatGPT / Codex / fal AI nodes/arkennemasis fal · Seedance 2.5 US Reference to Video · $0.26-1.40/s
ComfyUI Node

arkennemasis fal · Seedance 2.5 US Reference to Video · $0.26-1.40/s

The one that edits and extends video, not just makes it

By Hishamahmer·Created 3 months ago·Updated 9 days ago· 11
arkennemasis fal · Seedance 2.5 US Reference to Video · $0.26-1.40/s
  • image_1
  • image_2
  • image_3
  • image_4
  • image_5
  • image_6
  • video_1
  • video_2
  • video_3
  • audio_1
  • audio_2
  • audio_3
  • video
  • video_path
  • seed
  • draft_id
  • info
◄prompt►
◄taskreference►
◄resolution720p►
◄durationauto►
◄aspect_ratioauto►
◄generate_audiotrue►
◄bitrate_modestandard►
◄codecauto►
◄seed-1►
◄max_cost_usd20.0►
◄reuse_identical_runtrue►
◄extra_json►
◄max_concurrent1►

The other three Seedance nodes generate video. This one takes video as input - up to ten clips, thirty pictures and ten audio files - and can either use them as guidance, modify one of them, or continue one where it left off. That's a video editor inside your graph, and it's the least understood node in the pack.

It's also the one where reading the schema pays for itself, because task changes the meaning of every other widget on the node.

How it works

The mechanism is fal's reference conditioning: your media is uploaded to fal's CDN, referenced by position in the prompt, and the model conditions on it while generating the new shot. Prompt-side, images are addressed as @Image1, @Image2, videos as @Video1, audio as @Audio1, and the numbering follows the sockets - each socket can carry a whole batch, and the first picture of image_1 is number one, then the rest of that batch, then image_2. Get the order wrong and the model confidently edits the wrong person.

The submission, polling, download and logging path is the same as every fal node in the pack: estimate, upload free, one billed call, result into output/fal/bytedance_seedance-2.5_us_reference-to-video/, request logged to output/fal/_requests.jsonl.

The inputs that matter

task is the one to set first:

  • reference uses your media as guidance for a fresh shot.
  • editing modifies a reference video. Per the tooltip it also coerces aspect_ratio and duration to auto - so if you set a duration and nothing seems to listen, that's why.
  • extension continues a reference video and coerces aspect_ratio to auto to keep the framing continuous.

prompt is where the @Image1 and @Video1 references live; empty is allowed for pure edits. resolution and duration behave as on the other Seedance nodes, and seed defaults to -1 (the tooltip is upfront that the same seed can still drift slightly - treat it as best-effort, not a lock).

The reference sockets are optional individually but they're the whole point: image_1 through image_6, video_1 through video_3, audio_1 through audio_3. Their constraints are real and enforced - images up to 30 MB each, up to 30 of them; videos 1.8–30.2 seconds, ≤200 MB each, MP4/MOV, 300–6000 px per side, 24–60 fps, with combined video duration capped at 30.2 seconds; audio MP3/WAV, ≤15 MB each, 1.8–30.2 seconds. And across everything, 50 files maximum.

Outputs: video, video_path, seed, draft_id, info.

Money, because this node is different

Same per-second rates as the US image-to-video twin - roughly $0.26 / $0.57 / $1.40 per second at 480p / 720p / 1080p - but with a twist worth knowing: when video inputs are supplied, the price is multiplied by 0.6. At 720p with a reference clip that lands near $0.34/s. Handing it a clip makes a run cheaper, not more expensive.

Install

Manager → search comfyui-arkennemasis, or clone it:

cd ComfyUI/custom_nodes
git clone https://github.com/Hishamahmer/comfyui-arkennemasis

Restart, then put FAL_KEY=... in the .env beside run_nvidia_gpu.bat. No key box on the node - that's deliberate so keys never travel inside shared workflows.

Common issues & troubleshooting

"More than 50 files." The total across images, videos and audio is capped. Six full image sockets each carrying a batch of ten is sixty before you've added a clip.

The edit came back the wrong shape or length. Expected under task: editing - duration and aspect ratio get coerced to auto. Extension does the same to aspect ratio only.

@Image2 isn't the picture you meant. Batching reorders the numbering. One item per socket while you're setting a shot up is the boring, reliable way to work.

A reference video is refused. Duration, size, fps and per-side resolution are all checked; a 4K phone clip or something under 1.8 seconds will be rejected, and the node stops before billing rather than paying for a failure.

The default cost cap trips. max_cost_usd is $20 out of the box, and a long 1080p clip clears that easily. 0 disables the cap.

Categoryarkennemasis/fal/Video/Seedance

Inputs (25)

NameTypeDefaultDescription
promptSTRINGThe text prompt used to generate the video. Empty leaves it out.
taskCOMBOreferenceThe type of video generation task. Reference uses the supplied media as guidance. Editing modifies a reference video and automatically coerces aspect_ratio and duration to auto. Extension continues a reference video and automatically coerces aspect_ratio to auto.
resolutionCOMBO720pVideo resolution - 480p for faster generation, 720p for balance, 1080p for high quality.
durationCOMBOautoDuration of the video in seconds. Supports 4 to 30 seconds, or auto to let the model decide based on the prompt.
aspect_ratioCOMBOautoThe aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide.
generate_audioBOOLEANtrueWhether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not.
bitrate_modeCOMBOstandardOutput bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate.
codecCOMBOauto'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265.
seedINT-1-1–2147483647Random seed for reproducibility. Note that results may still vary slightly even with the same seed. -1 leaves it to the model.
image_1optIMAGEReference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50. Each socket may carry a batch; they are sent in socket order (the first picture of socket 1 is number 1).
image_2optIMAGEReference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50. Each socket may carry a batch; they are sent in socket order (the first picture of socket 1 is number 1).
image_3optIMAGEReference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50. Each socket may carry a batch; they are sent in socket order (the first picture of socket 1 is number 1).
image_4optIMAGEReference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50. Each socket may carry a batch; they are sent in socket order (the first picture of socket 1 is number 1).
image_5optIMAGEReference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50. Each socket may carry a batch; they are sent in socket order (the first picture of socket 1 is number 1).
image_6optIMAGEReference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50. Each socket may carry a batch; they are sent in socket order (the first picture of socket 1 is number 1).
video_1optVIDEOReference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 10 videos. Each video must be 1.8 to 30.2 seconds and no larger than 200 MB; combined duration must not exceed 30.2 seconds. Dimensions must be 300 to 6,000 pixels per side, aspect ratio 0.4 to 2.5, and frame rate 24 to 60 FPS. Each socket may carry a batch; they are sent in socket orde
video_2optVIDEOReference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 10 videos. Each video must be 1.8 to 30.2 seconds and no larger than 200 MB; combined duration must not exceed 30.2 seconds. Dimensions must be 300 to 6,000 pixels per side, aspect ratio 0.4 to 2.5, and frame rate 24 to 60 FPS. Each socket may carry a batch; they are sent in socket orde
video_3optVIDEOReference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 10 videos. Each video must be 1.8 to 30.2 seconds and no larger than 200 MB; combined duration must not exceed 30.2 seconds. Dimensions must be 300 to 6,000 pixels per side, aspect ratio 0.4 to 2.5, and frame rate 24 to 60 FPS. Each socket may carry a batch; they are sent in socket orde
audio_1optAUDIOReference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 10 files. Each file must be 1.8 to 30.2 seconds and no larger than 15 MB; combined duration must not exceed 30.2 seconds. Each socket may carry a batch; they are sent in socket order (the first picture of socket 1 is number 1).
audio_2optAUDIOReference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 10 files. Each file must be 1.8 to 30.2 seconds and no larger than 15 MB; combined duration must not exceed 30.2 seconds. Each socket may carry a batch; they are sent in socket order (the first picture of socket 1 is number 1).
audio_3optAUDIOReference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 10 files. Each file must be 1.8 to 30.2 seconds and no larger than 15 MB; combined duration must not exceed 30.2 seconds. Each socket may carry a batch; they are sent in socket order (the first picture of socket 1 is number 1).
max_cost_usdoptFLOAT20.00–100000Safety cap. If the estimated cost of this run is above this many US dollars the node stops BEFORE sending anything to fal. 0 = no cap.
reuse_identical_runoptBOOLEANtrueIf these exact inputs (the settings AND the same pictures/clips/audio) were already paid for and the files are still in output/fal, return them instead of paying again - also after a ComfyUI restart. Turn off for a fresh take with the same settings.
extra_jsonoptSTRINGAdvanced: a JSON object merged into the request last, for any fal field this node has no box for. Example: {"seed": 7}. Leave empty normally.
max_concurrentoptINT11–32How many paid fal calls may run at the same time in one run, across every fal node. 1 (default) = one after another. This node starts its paid part only while fewer than this many fal calls are running. Once any fal node fails, the ones still waiting are not started, so nothing more is billed.

Outputs (5)

NameTypeDescription
videoVIDEO—
video_pathSTRING—
seedINT—
draft_idSTRING—
infoSTRINGJSON: request id, cost estimate, saved files and fal's full answer.