Zhenzhen Seedream V5 Lite Edit Fal
Seedream V5 Lite editing with up to 10 reference images, via fal
- image1
- image2
- image3
- image4
- image5
- image6
- image7
- image8
- image9
- image10
- images
- image_urls
- response
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.image1–image10- the reference images. Up to ten, wired in asIMAGEtensors. 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 fromauto_2K(default) throughauto_4K, plus square and portrait/landscape 4:3/16:9 options.enable_safety_checker- on by default.image_way-image_url(default) orbase64for 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.
Inputs (21)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | — | |
| image1opt | IMAGE | — | |
| image2opt | IMAGE | — | |
| image3opt | IMAGE | — | |
| image4opt | IMAGE | — | |
| image5opt | IMAGE | — | |
| image6opt | IMAGE | — | |
| image7opt | IMAGE | — | |
| image8opt | IMAGE | — | |
| image9opt | IMAGE | — | |
| image10opt | IMAGE | — | |
| api_keyopt | STRING | — | |
| num_imagesopt | INT | 11–4 | — |
| max_imagesopt | INT | 11–4 | Max images per generation. Total output = num_images * max_images. |
| image_sizeopt | COMBO | auto_2K | 9 options: auto_2K, auto_3K, auto_4K, square_hd, square, portrait_4_3, +3 |
| enable_safety_checkeropt | BOOLEAN | true | — |
| image_wayopt | COMBO | image_url | 2 options: image_url, base64 |
| poll_intervalopt | INT | 31–30 | — |
| max_poll_attemptsopt | INT | 120010–3600 | Default 1200*3s = 1 hour timeout. |
| skip_erroropt | BOOLEAN | false | 开启后,节点失败时不报错、返回默认空结果。 |
| seedopt | INT | 00–18446744073709550000 | Execution 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)
| Name | Type | Description |
|---|---|---|
| images | IMAGE | — |
| image_urls | STRING | — |
| response | STRING | — |