Skip to main content

​
节点概述

节点标识： artsmcp-seedream
技术栈： Doubao Seedream
功能： 调用豆包 Seedream API 进行文生图、图生图、多图融合与组图生成

​
支持的生成模式

  • ✅ 文生图 (Text-to-Image)
  • ✅ 图生图 (Image-to-Image)
  • ✅ 多图融合 (双图输入)
  • ✅ 图生组图（一次生成多张相关图片）
  • ✅ 批量生成（分行提示词 + 并发）

​
节点界面

Seedream 节点配置与运行界面

​
请求示例

{
  "model": "doubao-seedream-4-0-250828",
  "prompt": "星际穿越，黑洞，黑洞里冲出一辆快支离破碎的复古列车",
  "size": "2048x2048",
  "sequential_image_generation": "disabled",
  "stream": false,
  "response_format": "url",
  "watermark": false
}

​
参数说明

​
核心参数

参数类型说明可选值
提示词STRING图片生成的文本描述（支持多行）支持中英文
API密钥STRINGAPI 身份验证密钥sk-xxx
API地址STRINGAPI 服务端点默认：https://api.openai.com 或兼容网关
模型ENUM选择模型doubao-seedream-4-0-250828 / doubao-seedream-4-5-251128
宽度INT生成图片的宽度（像素）512-4096，步长 64
高度INT生成图片的高度（像素）512-4096，步长 64
输入图片1-2IMAGE可选输入图片用于图生图/多图融合
最大图片数量INT最大生成图片数量0=禁用组图，1-10=生成对应数量
水印BOOLEAN是否添加水印默认 False
响应格式ENUM响应格式url / b64_json
超时秒数INTAPI 请求超时时间（秒）30-600，默认 120
详细日志BOOLEAN输出完整 API 请求和响应默认 False
并发请求数INT并发请求的数量1-10，默认 1
最大重试次数INTAPI 请求失败时的最大重试次数0-10，默认 3
启用分行提示词BOOLEAN是否按行拆分提示词默认 False
  • 当 最大图片数量 > 0 时，会在单次请求内生成组图；
  • 并发请求数 控制同时发起的请求数量，可与 启用分行提示词 组合使用。

​
图片尺寸与像素限制

​
模型版本像素范围

不同模型版本有不同的总像素要求，设置尺寸时需遵守范围，否则会返回“像素不足”等错误。
模型版本总像素范围最小分辨率最大分辨率宽高比范围
doubao-seedream-4-5-2511283,686,400 - 16,777,2162560x14404096x4096[1/16, 16]
doubao-seedream-4-0-250828921,600 - 16,777,2161280x7204096x4096[1/16, 16]

​
有效尺寸示例

2560x1440 - 总像素=3,686,400, 比例=16/9 ✅
3024x1296 - 总像素=3,919,104, 比例=21/9 ✅
2048x2048 - 总像素=4,194,304, 比例=1/1 ✅

​
推荐尺寸速查表

宽高比推荐像素值适用场景总像素
1:12048x2048方形图片，社交媒体4,194,304
4:32304x1728传统屏幕，横屏图片3,981,312
3:41728x2304竖屏图片，手机壁纸3,981,312
16:92560x1440宽屏显示，视频封面3,686,400
9:161440x2560竖屏视频，短视频3,686,400
3:22496x1664相机标准比例4,153,344
2:31664x2496竖版相机比例4,153,344
21:93024x1296超宽屏，电影比例3,919,104
  • 社交媒体/头像：推荐 1:1 (2048x2048)；
  • 手机壁纸/竖屏：推荐 9:16 (1440x2560)；
  • 桌面壁纸/横向海报：推荐 16:9 (2560x1440) 或 21:9 (3024x1296)。

​
功能模式

  1. 文生图
    • 只填提示词，不提供输入图片；
    • 适合从零构图、概念设计、封面创作。
  2. 图生图
    • 提供 1 张输入图片（输入图片1）；
    • 提示词描述需要如何改造该图片，例如风格转换、细节增强。
  3. 多图融合
    • 提供 2 张输入图片（输入图片1 & 输入图片2）；
    • 提示词中说明第一张/第二张图片各自的作用，如“第一张为人物，第二张为背景”。
  4. 图生组图
    • 设置 最大图片数量 > 0；
    • 同一提示词下生成多张相关图片，方便挑选最佳结果。
  5. 批量生成（分行提示词 + 并发）
    • 启用 启用分行提示词；
    • 提示词每行一个独立描述；
    • 配合 并发请求数，实现多提示词 × 多并发的组合生成。

​
并发和分行提示词

​
并发请求说明

​
并发请求数
integer
default:"1"
控制同一批任务中并发发起的请求数量。
  • 范围：1-10；
  • 并发数越大，总体生成耗时越短，但对 API QPS 和额度消耗越高；
  • 建议先在小并发下验证提示词，再逐步放大。

​
启用分行提示词说明

​
启用分行提示词
boolean
default:"false"
将提示词按行拆分，每行作为一个独立任务处理。行为说明：
  • 启用后：按行切分提示词，自动过滤空行；
  • 每行会调用一次 API，再结合 并发请求数 扩展为多张图片；
  • 总图片数 ≈ 行数 × 并发请求数 × (最大图片数量 或 默认数量)。
示例：
提示词：
星际穿越，黑洞，复古列车
赛博朋克风格，未来城市
海洋深处，神秘生物
并发请求数：3
→三行提示词 × 3 并发 = 9 组请求，每组生成若干张图片。

​
重试机制

​
最大重试次数
integer
default:"3"
当调用返回服务端错误（5xx）时的自动重试次数。
  • 0：不重试；
  • 1-10：重试对应次数，采用指数退避策略。
重试策略（与 README 一致）：
  • 自动重试：遇到 5xx 服务器错误时触发；
  • 指数退避：2 秒 → 4 秒 → 8 秒递增等待，最长不超过约 30 秒；
  • 智能判断：4xx 客户端错误不会重试（避免浪费额度），但 429（限流）可在实现中视为可重试。

​
输出说明

​
images
array
生成的图片数组，自动保存到 ComfyUI 输出目录。文件信息：
  • 文件格式：.png；
  • 命名规则：ComfyUI_[序号].png；
  • 默认保存路径：ComfyUI/output/；
  • 数量：由 最大图片数量、分行提示词和并发共同决定。

​
使用示例

​
示例 1：文生图

1

配置提示词

星际穿越，黑洞，电影大片风格，
黑洞里冲出一辆即将支离破碎的复古列车，
高对比度光影，细节丰富，8K 高清。
2

设置尺寸

  • 模型：doubao-seedream-4-0-250828
  • 宽度：2048
  • 高度：2048
  • 最大图片数量：3
3

执行生成

运行节点，得到 3 张不同结果的方形图片。

​
示例 2：图生图

1

连接输入图片

将一张照片连接到 输入图片1。
2

配置提示词

将这张图片转换为水彩画风格，
色调柔和，保留原有构图和主体元素。
3

设置参数

  • 模型：doubao-seedream-4-5-251128
  • 宽度：2560
  • 高度：1440（16:9 比例）
  • 最大图片数量：4

​
示例 3：多图融合

1

连接两张图片

  • 输入图片1：人物照片；
  • 输入图片2：场景背景。
2

配置提示词

将第一张图片中的人物自然融入第二张图片的场景中，
保持光线方向一致，整体风格偏电影感，高质量渲染。
3

设置高质量参数

  • 模型：doubao-seedream-4-5-251128
  • 宽度：3024
  • 高度：1296（21:9 超宽屏）
  • 最大图片数量：2

​
示例 4：分行提示词 + 并发

1

配置多行提示词

森林小屋，阳光洒落
赛博朋克风格，未来城市
海洋深处，神秘生物
2

设置并发与数量

  • 启用分行提示词：True
  • 并发请求数：3
  • 最大图片数量：1
3

执行生成

将生成 3 行 × 3 并发 = 9 张图片，覆盖 3 个主题的多种变体。

​
常见问题

  • Seedream 4.5（doubao-seedream-4-5-251128） 适合：
    • 高质量大图、商用项目；
    • 对细节和质感要求高的场景；
    • 打印、海报等高分辨率用途。
  • Seedream 4.0（doubao-seedream-4-0-250828） 适合：
    • 快速预览、调参；
    • 生成小尺寸图片；
    • 对画质要求相对不高的场景。
这是因为设置的 宽度 × 高度 不满足模型的最小总像素要求：
  • 4.5：最小总像素 3,686,400，如 2560x1440；
  • 4.0：最小总像素 921,600，如 1280x720。
解决方案：
  1. 使用上面的推荐尺寸速查表；
  2. 或切换到 Seedream 4.0 并使用较小尺寸。
  • 优化提示词：增加细节、风格、光线、分辨率等描述；
  • 提高分辨率或更换到 4.5 模型；
  • 使用参考图片作为风格/构图参考；
  • 通过组图和并发多生成几张，从中挑选最佳结果。
是的，即使提示词完全相同，每次生成仍然会有随机性：
  • 同一批次会围绕提示词产生多种变化；
  • 生成数量越多，选择空间越大；
  • 可以通过固定种子在一定程度上稳定风格（视具体实现）。