Nodes/ComfyUI Seedance/Seedream / Dola Seedream 图像生成/编辑
ComfyUI Node

Seedream / Dola Seedream 图像生成/编辑

Seedream v5 Pro with a domestic/overseas switch — one node, two closed models

By T8mars·Created 2 months ago·Updated 3 days ago· 31
Seedream / Dola Seedream 图像生成/编辑
  • image1
  • image2
  • image3
  • image4
  • image5
  • image6
  • image7
  • image8
  • image9
  • image10
  • api_config
  • image
  • image_url
  • task_id
  • response
prompt
resolution2k
width1024
height1024
output_formatpng
model_familyseedream-v5-pro (domestic)
skip_errorfalse
seed0

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) or dola-seedream-5.0-pro (overseas). Defaults to domestic.
  • resolution - 1k, 2k, or custom. Pick custom and the width/height fields (240–8192) take over; the presets ignore them.
  • output_format - png or jpeg. PNG if you might edit further, JPEG if you're shipping to a chat box.
  • image1image10 - 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_key box vs the prompt box. Paste the prompt into prompt. 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.

CategorySeedance

Inputs (19)

NameTypeDefaultDescription
promptSTRINGPrompt, 5-2000 characters. | 提示词,长度 5-2000 字符。
resolutionCOMBO2k1k/2k use the API preset; custom uses width and height. | 1k/2k 使用预设,custom 使用宽高。
widthINT1024240–8192Used only when resolution is custom. | 仅 custom 分辨率时生效。
heightINT1024240–8192Used only when resolution is custom. | 仅 custom 分辨率时生效。
output_formatCOMBOpngResult file format. | 输出图片格式。
model_familyCOMBOseedream-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。
image1optIMAGEOptional editing reference image 1 of 10. | 可选编辑参考图 1。
image2optIMAGEOptional editing reference image 2 of 10. | 可选编辑参考图 2。
image3optIMAGEOptional editing reference image 3 of 10. | 可选编辑参考图 3。
image4optIMAGEOptional editing reference image 4 of 10. | 可选编辑参考图 4。
image5optIMAGEOptional editing reference image 5 of 10. | 可选编辑参考图 5。
image6optIMAGEOptional editing reference image 6 of 10. | 可选编辑参考图 6。
image7optIMAGEOptional editing reference image 7 of 10. | 可选编辑参考图 7。
image8optIMAGEOptional editing reference image 8 of 10. | 可选编辑参考图 8。
image9optIMAGEOptional editing reference image 9 of 10. | 可选编辑参考图 9。
image10optIMAGEOptional editing reference image 10 of 10. | 可选编辑参考图 10。
api_configoptSEEDANCE_CONFIGConnect Seedance API Config; otherwise SEEDANCE_API_KEY is used.
skip_erroroptBOOLEANfalseOn failure return a placeholder image instead of stopping the workflow. | 失败时输出占位图片而不中断工作流。
seedoptINT00–18446744073709550000ComfyUI 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)

NameTypeDescription
imageIMAGE
image_urlSTRING
task_idSTRING
responseSTRING