Bytedance Seedream V4 Edit Sequential
Edit up to 10 images, emit a consistent batch
- client
- images
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
imagesoutput 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.
Inputs (11)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | Text description of desired modifications. The node automatically appends the image count to your prompt. | |
| max_images | INT | 41–15 | Number of images to generate (1-15). Automatically added to prompt for API compliance. |
| size_preset | COMBO | Custom | Recommended resolution presets. Select 'Custom' to use manual width/height. |
| seed | INT | -1-1–2147483647 | Seed for cache control. Randomizes by default. |
| clientopt | WAVESPEED_AI_API_CLIENT | WaveSpeed API client (optional if API key is configured in Settings) | |
| image_urlopt | STRING | Image URL(s) to edit (optional). Accepts single URL (string) or multiple URLs (array). Max 10 images. | |
| widthopt | INT | 1408320–4096 | Custom width (only used when size_preset is 'Custom') |
| heightopt | INT | 1408320–4096 | Custom height (only used when size_preset is 'Custom') |
| show_aspect_ratioopt | BOOLEAN | true | Show aspect ratio in node title |
| enable_sync_modeopt | BOOLEAN | false | Wait for result generation before returning response |
| enable_base64_outputopt | BOOLEAN | false | Return BASE64 encoded output instead of URLs |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| images | IMAGE | — |