Qwen Image 3.0 / Pro 图像生成/编辑(8 合 1)
Standard, Pro, domestic, global — T2I and I2I in one node
- image1
- image2
- image3
- api_config
- image
- image_url
- task_id
- response
Qwen Image 3.0 is Alibaba's image generation line, and this node collapses eight of its variants into one dropdown: domestic and global, standard and Pro, text-to-image and image-to-image. The Pro tier is the one people actually pay for - better prompt adherence and cleaner output - and having all four line/version combos in one node means you can A/B them without rebuilding the workflow. It's the pack's most flexible image generator, sitting alongside the Seedream nodes as the "I need quality now" option.
Everything here is the standard T8mars/ComfyUI_Seedance API-wrapper deal: key from api.seedance.nz, no local compute, requests only.
How it works
The node submits to the image endpoint with one of three sizing strategies you control via sizing_mode:
- auto - no size sent; the model picks.
- ratio - sends
metadata.ratioplusresolution(1kor2k). - custom_size - sends a top-level size like
1024*1024.
The three modes are mutually exclusive request structures, and the front end only shows the fields each mode uses. For image editing, connect image1 through image3 (1–3 references, required for I2I models, ignored by T2I). The prompt_extend toggle asks the model to expand your prompt upstream, which is a surprisingly effective fix for thin prompts.
The inputs that matter
- model - the eight-way switch (
qwen-image-3.0-{t2i,i2i}and-pro-, each with-global-twins). - prompt - 5 to 2000 characters.
- negative_prompt - optional; this model actually honors it, unlike some 2026 models.
- prompt_extend - on/off prompt expansion.
- sizing_mode -
auto/ratio/custom_size, and its dependentresolution,ratio,custom_size. - n - 1 to 6 images per call.
- seed -
-1omits the seed entirely (truly random); non-negative values forward it. The tooltip says this plainly - use-1for variety runs. - image1..image3 - I2I references.
Outputs: image, image_url, task_id, response.
Installing it
ComfyUI Manager → search "ComfyUI Seedance", or:
cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/ComfyUI_Seedance.git
cd ../..
python -m pip install -r custom_nodes/ComfyUI_Seedance/requirements.txt
Restart, key from api.seedance.nz/console, Seedance API Config into api_config.
Common issues
- I2I model ignores your reference - you connected
image1on a T2I model, or left it unconnected on an I2I model (I2I needs 1–3 references). - Size controls appear but do nothing - you're in the wrong
sizing_mode; each mode only reads its own fields. - Six images all look alike -
nmultiplies results; without a seed variation, images in one call tend to cluster. Setn=1and vary the seed, or accept the batch as intended. - Prompt limit hit - 5–2000 characters is enforced; trim.
Qwen Image 3.0 is also the rare API image model that respects a negative_prompt - worth using. And if you need looser, faster, cheaper image generation for drafts, the pack's Seedance_2_5 video node or its Seedream image nodes are the other doors; Pro-tier Qwen is where you go when the deliverable matters.
Inputs (15)
| Name | Type | Default | Description |
|---|---|---|---|
| model | COMBO | qwen-image-3.0-t2i | Qwen Image 3.0 or Pro, domestic or global, for T2I/I2I. | Qwen Image 3.0 / Pro 国内或海外文生图、图像编辑。 |
| prompt | STRING | Prompt, 5 to 2000 characters. | 提示词,5 到 2000 字符。 | |
| negative_prompt | STRING | Optional negative prompt. | 可选负面提示词。 | |
| prompt_extend | BOOLEAN | true | Enable upstream prompt expansion. | 启用上游提示词扩写。 |
| sizing_mode | COMBO | auto | auto omits size; ratio sends metadata.ratio and resolution; custom_size sends top-level size. | 自动模式省略尺寸;比例模式发送画幅和分辨率;自定义模式发送顶层 size。 |
| resolution | COMBO | 1k | Used only in ratio mode: 1k or 2k. | 仅比例模式使用:1k 或 2k。 |
| ratio | COMBO | 1:1 | Used only in ratio mode. | 仅比例模式使用。 |
| custom_size | STRING | 1024*1024 | Used only in custom_size mode, for example 1024*1024. | 仅自定义模式使用,例如 1024*1024。 |
| n | INT | 11–6 | Number of images requested, 1 to 6. | 请求图片数量,1 到 6。 |
| seed | INT | -1-1–2147483647 | -1 omits metadata.seed; non-negative values are forwarded. | -1 不发送 seed。 Fixed reuses the cached result while all inputs stay unchanged; randomize/increment/decrement starts a new execution. | Fixed 在输入不变时复用缓存;随机、递增或递减会触发新任务。 |
| image1opt | IMAGE | Qwen I2I reference image 1 of 3; ignored by T2I. | Qwen 图像编辑参考图;文生图不使用。 | |
| image2opt | IMAGE | Qwen I2I reference image 2 of 3; ignored by T2I. | Qwen 图像编辑参考图;文生图不使用。 | |
| image3opt | IMAGE | Qwen I2I reference image 3 of 3; ignored by T2I. | Qwen 图像编辑参考图;文生图不使用。 | |
| 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. | 失败时输出占位图片而不中断工作流。 |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| image | IMAGE | — |
| image_url | STRING | — |
| task_id | STRING | — |
| response | STRING | — |