Seedream / Dola Seedream 图像生成/编辑
Seedream v5 Pro with a domestic/overseas switch — one node, two closed models
- image1
- image2
- image3
- image4
- image5
- image6
- image7
- image8
- image9
- image10
- api_config
- image
- image_url
- task_id
- response
Seedream / Dola Seedream 图像生成/编辑 is the pack's text-to-image / image-edit workhorse, and its neat trick is that it actually bundles two different closed models behind one dropdown. ByteDance's Seedream v5 Pro is a closed image model you cannot run locally - it sits on the official ComfyUI Partner Nodes roster too, so this isn't an obscure endpoint, it's the real deal accessed through this pack's reseller gateway. The model_family selector flips between the domestic seedream-v5-pro and the overseas dola-seedream-5.0-pro routes, each of which branches into a text-to-image and an image-edit variant depending on what you connect.
The mode-switching is the part to internalize: no reference image connected = text-to-image; any reference image connected = image editing. You don't flip a mode toggle, you just connect or disconnect image1. The node submits the matching model (...-t2i vs ...-i2i) automatically.
Inputs that matter:
prompt- required, 5 to 2,000 characters.model_family-seedream-v5-pro (domestic)ordola-seedream-5.0-pro (overseas). Defaults to domestic.resolution-1k,2k, orcustom. Pickcustomand thewidth/heightfields (240–8192) take over; the presets ignore them.output_format-pngorjpeg. PNG if you might edit further, JPEG if you're shipping to a chat box.image1…image10- optional editing references. Connect any of them and you've switched to edit mode; the model follows all ten in slot order.
Outputs are the pack's standard image quartet: image (the real IMAGE tensor), image_url, task_id, and response.
How it works
Same upload → submit → poll → download pipeline as every node in this pack. Your reference images (if any) get uploaded to the api.seedance.nz gateway, the request is built with the right t2i/i2i model name, the remote job runs, and the finished picture streams down and decodes into a ComfyUI IMAGE. There's a seed control, but note the tooltip: it's a ComfyUI cache key - models without documented seed support don't receive it. That's the pack's universal seed behavior, not a Seedream quirk.
Installing it
The whole pack installs together: ComfyUI Manager → search ComfyUI Seedance, or:
cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/ComfyUI_Seedance.git
python -m pip install -r ComfyUI_Seedance/requirements.txt
Restart, look under Seedance. There's nothing to download for this one - the dependency list is a single requests line and the model runs on the vendor's machines. You supply an API key from api.seedance.nz, either through the Seedance API Config node or the SEEDANCE_API_KEY env var.
Where people get burned
- Forgetting which mode you're in. You connect a reference image and expect a clean text-to-image render; instead the model obediently edits the reference. Or the reverse - you meant to edit but left all ten slots unconnected and got a fresh generation. The behavior is predictable; you just have to remember the rule.
- Overseas vs domestic isn't cosmetic. The routes go through different infrastructure, which can mean different pricing, latency, and moderation posture. If a prompt gets refused on domestic, the overseas route is the pack's documented escape hatch - the README's example set even includes "宽审核" (looser-audit) workflows.
- The
api_keybox vs thepromptbox. Paste the prompt intoprompt. The key field validates and rejects non-ASCII, but the error is friendlier if you just don't do it.
Standard fine print for the pack applies: results links expire, so save the image output, and your prompt plus reference images go to a third-party endpoint. Cost is per call, so do your resolution experiments at 1k.
Inputs (19)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | Prompt, 5-2000 characters. | 提示词,长度 5-2000 字符。 | |
| resolution | COMBO | 2k | 1k/2k use the API preset; custom uses width and height. | 1k/2k 使用预设,custom 使用宽高。 |
| width | INT | 1024240–8192 | Used only when resolution is custom. | 仅 custom 分辨率时生效。 |
| height | INT | 1024240–8192 | Used only when resolution is custom. | 仅 custom 分辨率时生效。 |
| output_format | COMBO | png | Result file format. | 输出图片格式。 |
| model_family | COMBO | seedream-v5-pro (domestic) | Domestic uses seedream-v5-pro-t2i/i2i; overseas uses dola-seedream-5.0-pro-t2i/i2i. | 国内使用 seedream-v5-pro;海外使用 dola-seedream-5.0-pro。 |
| image1opt | IMAGE | Optional editing reference image 1 of 10. | 可选编辑参考图 1。 | |
| image2opt | IMAGE | Optional editing reference image 2 of 10. | 可选编辑参考图 2。 | |
| image3opt | IMAGE | Optional editing reference image 3 of 10. | 可选编辑参考图 3。 | |
| image4opt | IMAGE | Optional editing reference image 4 of 10. | 可选编辑参考图 4。 | |
| image5opt | IMAGE | Optional editing reference image 5 of 10. | 可选编辑参考图 5。 | |
| image6opt | IMAGE | Optional editing reference image 6 of 10. | 可选编辑参考图 6。 | |
| image7opt | IMAGE | Optional editing reference image 7 of 10. | 可选编辑参考图 7。 | |
| image8opt | IMAGE | Optional editing reference image 8 of 10. | 可选编辑参考图 8。 | |
| image9opt | IMAGE | Optional editing reference image 9 of 10. | 可选编辑参考图 9。 | |
| image10opt | IMAGE | Optional editing reference image 10 of 10. | 可选编辑参考图 10。 | |
| api_configopt | SEEDANCE_CONFIG | Connect Seedance API Config; otherwise SEEDANCE_API_KEY is used. | |
| skip_erroropt | BOOLEAN | false | On failure return a placeholder image instead of stopping the workflow. | 失败时输出占位图片而不中断工作流。 |
| seedopt | INT | 00–18446744073709550000 | ComfyUI cache seed. Fixed reuses the cached result while all other inputs stay unchanged; randomize/increment/decrement starts a new execution. This value is not sent to models without documented seed support. | ComfyUI 缓存种子;Fixed 在其他输入不变时复用缓存,随机、递增或递减会触发新任务。未声明支持 seed 的模型不会收到此参数。 |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| image | IMAGE | — |
| image_url | STRING | — |
| task_id | STRING | — |
| response | STRING | — |