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 12 months ago·Updated 4 days ago· 2
Bytedance Seedream V4 Edit Sequential
  • client
  • images
  • 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 erpk → ERPK 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 (12)

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, one per line or comma separated. Up to 10. Ignored when `images` is connected.
imagesoptIMAGEImages to edit as a ComfyUI IMAGE batch. Each slice is one image, up to 10. Takes precedence over `image_url`. Sent inline as base64, no upload.
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—