Nodes/Comfyui-zhenzhen/Zhenzhen Seedream V5 Lite Edit Fal
ComfyUI Node

Zhenzhen Seedream V5 Lite Edit Fal

Seedream V5 Lite editing with up to 10 reference images, via fal

By T8mars·Created about a year ago·Updated 2 days ago· 740
Zhenzhen Seedream V5 Lite Edit Fal
  • image1
  • image2
  • image3
  • image4
  • image5
  • image6
  • image7
  • image8
  • image9
  • image10
  • images
  • image_urls
  • response
prompt
api_key
num_images1
max_images1
image_sizeauto_2K
enable_safety_checkertrue
image_wayimage_url
poll_interval3
max_poll_attempts1200
skip_errorfalse
seed0

The display name calls it "Seedream V5 Lite Edit Fal," and that's a fair summary: it's ByteDance's Seedream V5 Lite edit model routed through the fal queue, taking up to ten reference images and producing edited images that respect them. Where the seedream-v5-pro nodes in this pack are about generating (or editing) at scale, this one is the lighter, faster edit path - think "here's my product shot and ten context images, keep it consistent, change this thing."

Category-wise the pack files it under zhenzhen/Google, which is a leftover from the pack's history and definitely doesn't mean this is a Google model - it's ByteDance. Don't let the menu placement confuse you.

It's a FAL node, so the token lives in the node's own api_key field and traffic runs through the zhenzhen proxy (https://ai.t8star.org/fal in front of queue.fal.run). The endpoint is fal-ai/bytedance/seedream/v5/lite/edit.

The inputs that matter

  • prompt - required. For an edit, describe the change; reference images are matched positionally.
  • image1image10 - the reference images. Up to ten, wired in as IMAGE tensors. More isn't always better - consistency degrades once you overload the context.
  • num_images - how many output images (1–4).
  • max_images - per-generation cap; the tooltip notes total output = num_images × max_images. Mind that multiplication if you're metered per image.
  • image_size - presets from auto_2K (default) through auto_4K, plus square and portrait/landscape 4:3/16:9 options.
  • enable_safety_checker - on by default.
  • image_way - image_url (default) or base64 for how references are shipped to the API. Keep the default unless you're chasing a specific failure.

Outputs: images (tensor list), image_urls, and response. Poll defaults here are a bit longer than the pack's standard - 3s interval with a 1-hour cap by default, which reflects how slow Seedream edits can be.

Installing it

cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/Comfyui-zhenzhen

or ComfyUI Manager (search "Comfyui-zhenzhen"), restart. No models to download; paste a zhenzhen token (overseas https://ai.t8star.org) into api_key. FAL routes are prepaid - credits are held up front and the difference refunded after the job.

Common issues

  • Edits ignore the references - double-check image_way. If references are being sent as URLs and your images aren't uploaded, the model sees nothing. Also re-verify your image wiring order.
  • Cost creep from num_images × max_images - this is metered per output image, and the combination multiplies fast. Keep both at 1 until you need batches.
  • Slow or timed-out edits - the default timeout is already an hour, but multi-reference edits at 4K can still push it. The job may finish on fal's side after the node gives up.

For "same character, ten angles, one consistent edit," this is the node - the multi-reference count is its whole reason to exist, and it's cheaper than the pro route for jobs that don't need pro's headroom.

Categoryzhenzhen/Google

Inputs (21)

NameTypeDefaultDescription
promptSTRING
image1optIMAGE
image2optIMAGE
image3optIMAGE
image4optIMAGE
image5optIMAGE
image6optIMAGE
image7optIMAGE
image8optIMAGE
image9optIMAGE
image10optIMAGE
api_keyoptSTRING
num_imagesoptINT11–4
max_imagesoptINT11–4Max images per generation. Total output = num_images * max_images.
image_sizeoptCOMBOauto_2K9 options: auto_2K, auto_3K, auto_4K, square_hd, square, portrait_4_3, +3
enable_safety_checkeroptBOOLEANtrue
image_wayoptCOMBOimage_url2 options: image_url, base64
poll_intervaloptINT31–30
max_poll_attemptsoptINT120010–3600Default 1200*3s = 1 hour timeout.
skip_erroroptBOOLEANfalse开启后,节点失败时不报错、返回默认空结果。
seedoptINT00–18446744073709550000Execution seed for ComfyUI cache control. Fixed reuses the cached result; randomize/increment/decrement requests a new run. This compatibility seed is not sent to APIs that do not expose a native seed parameter.

Outputs (3)

NameTypeDescription
imagesIMAGE
image_urlsSTRING
responseSTRING