Nodes/ComfyUI_Fill-Nodes/FL Fal Seedream Edit
ComfyUI Node

FL Fal Seedream Edit

ByteDance's closed image editor, ten references at once

By filliptm·Created 3 years ago·Updated about 13 hours ago· 628
FL Fal Seedream Edit
  • image_1
  • image_2
  • image_3
  • image_4
  • image_5
  • image_6
  • image_7
  • image_8
  • image_9
  • image_10
  • images
  • image_urls
  • seed
  • status_msg
api_key
promptDress the model in the clothes and shoes.
image_sizesquare_hd
num_images1
seed0
sync_modefalse
max_retries3
retry_indefinitelyfalse
use_custom_resolutionfalse
auto_scale_to_minimumtrue
custom_width1280
custom_height1280

ByteDance's Seedream v4, the image-editing side of a lab that runs a deliberately two-track strategy: flagship generation products - Seedream, Seedance - stay closed and API-only forever, while a steady stream of open components (SDXL-Lightning, PuLID, Depth Anything, and more) ships free underneath. Seedream itself is squarely in the "you will never self-host this" column, so Fal.ai's hosted endpoint is the only door in, and this node is that door.

The mechanism

Composites or edits up to ten reference images against one shared prompt (image_1 through image_10, all optional), auto-scaling inputs to meet Seedream's minimum dimension requirements while preserving aspect ratio if auto_scale_to_minimum is left on - it defaults to true, and you generally want it left there, since turning it off means undersized inputs can just fail the API call instead of being quietly upscaled first. All ten reference slots are optional, so unlike FL_Fal_GPTImage2_Edit in this same pack, you can leave every image input empty and use this purely as a text-to-image node against the prompt alone.

Inputs and outputs that matter

prompt - the default sample is literally "Dress the model in the clothes and shoes," which tells you the kind of compositing task this is tuned for: garment or product try-on style edits. image_size gives six fixed presets (square_hd through landscape_16_9), num_images (1-4) sets outputs per call, and seed, sync_mode, max_retries round out the required fields. On the optional side, use_custom_resolution unlocks custom_width/custom_height (both 256-4096px) if none of the six presets fit, and retry_indefinitely offers the same "keep hammering on transient failure" behavior as this pack's other Fal nodes.

Outputs: images, image_urls, seed (returned as a string - useful for logging exactly what Seedream used, since with num_images above 1 the outputs in a batch may not all share one), and status_msg.

Installing it

ComfyUI Manager: search Fill-Nodes, install, restart. Manually: cd ComfyUI/custom_nodes && git clone https://github.com/filliptm/ComfyUI_Fill-Nodes, then restart.

Where people get burned

image_size and use_custom_resolution are effectively mutually exclusive: set custom_width/custom_height but forget to toggle use_custom_resolution on, and the node falls back to whatever preset is selected in image_size - your custom dimensions get silently ignored.

And because this is a closed API model with no local equivalent to fall back on for comparison, if an edit doesn't land right, the fix space is entirely in prompt and reference-image choice. There's no CFG scale or sampler to blame it on - Seedream's own instruction-following is the whole mechanism. If you're trying to decide between this and the Fal Kontext or Gemini Image Edit nodes elsewhere in this pack for a compositing task, Seedream's ten-reference ceiling is the highest of the three, which matters if you're combining several distinct product or garment shots into one scene rather than editing a single subject.

Category🏵️Fill Nodes/AI

Inputs (22)

NameTypeDefaultDescription
api_keySTRING
promptSTRINGDress the model in the clothes and shoes.
image_sizeCOMBOsquare_hd6 options: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
num_imagesINT11–4
seedINT00–2147483647
sync_modeBOOLEANfalse
max_retriesINT31–5
image_1optIMAGE
image_2optIMAGE
image_3optIMAGE
image_4optIMAGE
image_5optIMAGE
image_6optIMAGE
image_7optIMAGE
image_8optIMAGE
image_9optIMAGE
image_10optIMAGE
retry_indefinitelyoptBOOLEANfalse
use_custom_resolutionoptBOOLEANfalse
auto_scale_to_minimumoptBOOLEANtrue
custom_widthoptINT1280256–4096
custom_heightoptINT1280256–4096

Outputs (4)

NameTypeDescription
imagesIMAGE
image_urlsSTRING
seedSTRING
status_msgSTRING