Nodes/ERPK Collection/Bytedance Seedream V4 Edit Sequential
ComfyUI Node

Bytedance Seedream V4 Edit Sequential

Edit up to 10 images, emit a consistent batch

By eRepublik-Labs·Created 11 months ago·Updated 21 days ago· 1
Bytedance Seedream V4 Edit Sequential
  • client
  • images
prompt
max_images4
size_presetCustom
seed-1
image_url
width1408
height1408
show_aspect_ratiotrue
enable_sync_modefalse
enable_base64_outputfalse

Editing is usually a one-in, one-out affair. Seedream V4 Edit Sequential flips that: you feed it up to 10 reference images and one edit instruction, and it returns a consistent batch of 1 to 15 edited images at $0.027 each. Think "give every shot in this set the same treatment" - a uniform color pass, a consistent background swap, the same character re-styled across a contact sheet - in a single billed call.

It's part of the ERPK Collection, the community pack wrapping the WaveSpeed AI API. Cloud-computed, no local model.

How it works

You provide an edit prompt, a max_images count, and optionally up to 10 image_urls. The node auto-appends the image count to your prompt (same quirk as the rest of the Sequential family), sends the batch job to WaveSpeed, and returns an images IMAGE tensor - a batch of edited frames for a batch-aware save or preview node.

The interesting asymmetry: the input is a comma-separated URL list (or an array), while the output is a proper tensor batch. So you'll usually be sourcing references from web-accessible URLs, and consuming the result through ComfyUI's native image plumbing.

The inputs that matter

  • prompt - the modification applied to the set. Keep it one coherent instruction ("change the sky to dusk, keep everything else") so the batch stays consistent.
  • max_images - 1–15, default 4. Auto-appended to the prompt; don't write the number yourself.
  • image_url - reference images to edit. Optional - a single URL or a comma-separated array, up to 10. If you leave it empty, the node edits from the prompt alone.
  • size_preset / width / height - presets or Custom (320–4096, default 1408). The edit output canvas.
  • seed - cache control, randomizes by default.

Install

cd ComfyUI/custom_nodes
git clone https://github.com/eRepublik-Labs/comfyui-nodes-erpk.git erpk
cd erpk
pip install -r requirements.txt

Or ComfyUI Manager → search erpkERPK Custom Nodes. WaveSpeed key with credits via right-click canvas > ERPK Settings (Settings > ERPK > API Keys).

Common issues

  • References not applying - the URLs must be reachable by WaveSpeed's servers. A local path from your machine won't resolve.
  • Edited set lost consistency - one instruction across many images is a lot to hold. The more uniform your source images, the more uniform the result.
  • Saving the batch - again, the images output is multi-frame; use a batch-aware saver or split first.
  • "Why is my fixed-seed batch identical?" - cache control. Randomize for a fresh billed run.

Where this shines is retouching a series - product line shots, a storyboard, a set of design mockups - with one uniform edit. Single-image edits are cheaper and simpler on the plain Seedream V4 Edit node; this is the batch-mindset version.

CategoryERPK/WaveSpeedAI

Inputs (11)

NameTypeDefaultDescription
promptSTRINGText description of desired modifications. The node automatically appends the image count to your prompt.
max_imagesINT41–15Number of images to generate (1-15). Automatically added to prompt for API compliance.
size_presetCOMBOCustomRecommended resolution presets. Select 'Custom' to use manual width/height.
seedINT-1-1–2147483647Seed for cache control. Randomizes by default.
clientoptWAVESPEED_AI_API_CLIENTWaveSpeed API client (optional if API key is configured in Settings)
image_urloptSTRINGImage URL(s) to edit (optional). Accepts single URL (string) or multiple URLs (array). Max 10 images.
widthoptINT1408320–4096Custom width (only used when size_preset is 'Custom')
heightoptINT1408320–4096Custom height (only used when size_preset is 'Custom')
show_aspect_ratiooptBOOLEANtrueShow aspect ratio in node title
enable_sync_modeoptBOOLEANfalseWait for result generation before returning response
enable_base64_outputoptBOOLEANfalseReturn BASE64 encoded output instead of URLs

Outputs (1)

NameTypeDescription
imagesIMAGE