ByteDanceSeedreamNodeV3 - ComfyUI Built-in Node Documentation

ByteDance Seedream 4.5 与 5.0 可根据文本提示词生成图像（文生图），或在可选参考图像的引导下生成/编辑图像，使用 ByteDance Seedream 4.0、4.5 和 5.0 模型，分辨率最高可达 4K。此节点会将提示词和任何参考图像发送到 ByteDance API，等待生成任务完成，并返回生成的图像张量（一个或多个）。

输入

通用输入

参数	描述	数据类型	必需	范围
`提示词`	用于创建或编辑图像的文本提示词。去除空白字符后不能为空。	STRING	是	多行文本
`模型`	选择要使用的 Seedream 模型。每个模型在下方有其自己的一组子参数和限制。	DYNAMIC_COMBO	是	”seedream 5.0 pro" "seedream 5.0 lite" "seedream-4-5-251128" "seedream-4-0-250828”

Seedream 5.0 Pro 输入 (seedream 5.0 pro)

参数	描述	数据类型	必需	范围
`size_preset`	选择推荐尺寸。选择 Custom 可使用下方的宽度和高度。默认：此模型的第一个推荐预设。	COMBO	否	模型特定的推荐尺寸预设 ”Custom”
`width`	图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时该值才生效。默认：2048。	INT	否	1024 到 3136（步长 2）
`height`	图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时该值才生效。默认：2048。	INT	否	1024 到 2496（步长 2）
`prompt_optimization`	提供参考图像时的提示词优化模式：‘standard’ 提供更高质量，‘fast’ 缩短生成时间。默认：“standard”。	COMBO	否	”standard" "fast”
`seed`	用于生成的种子。默认：42。	INT	否	0 到 2147483647
`watermark`	是否向图像添加“AI generated”水印。默认：false。	BOOLEAN	否	true / false
`thinking`	启用模型的提示词优化推理（“thinking”）以获得更好的遵循。可能大幅增加生成时间——在 Seedream 5.0 Pro 上尤其明显。仅可在文生图时禁用（提供参考图像时不可禁用）。默认：true。	BOOLEAN	否	true / false

Seedream 5.0 Lite 输入 (seedream 5.0 lite)

参数	描述	数据类型	必需	范围
`size_preset`	选择推荐尺寸。选择 Custom 可使用下方的宽度和高度。默认：此模型的第一个推荐预设。	COMBO	否	模型特定的推荐尺寸预设 ”Custom”
`width`	图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时该值才生效。默认：2048。	INT	否	1024 到 6240（步长 2）
`height`	图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时该值才生效。默认：2048。	INT	否	1024 到 4992（步长 2）
`max_images`	要生成的最大图像数量。设为 1 时，仅生成一张图像。设为 >1 时，模型生成 1 到 `max_images` 张相关图像（例如故事场景、角色变体）。图像总数（输入 + 生成）不能超过 15。默认：1。	INT	否	1 到 14
`fail_on_partial`	如果启用，当任何请求的图像缺失或返回错误时中止执行。默认：false。	BOOLEAN	否	true / false
`seed`	用于生成的种子。默认：42。	INT	否	0 到 2147483647
`watermark`	是否向图像添加“AI generated”水印。默认：false。	BOOLEAN	否	true / false
`thinking`	启用模型的提示词优化推理（“thinking”）以获得更好的遵循。可能大幅增加生成时间——在 Seedream 5.0 Pro 上尤其明显。仅可在文生图时禁用（提供参考图像时不可禁用）。默认：true。	BOOLEAN	否	true / false

Seedream 4.5 输入 (seedream-4-5-251128)

参数	描述	数据类型	必需	范围
`size_preset`	选择推荐尺寸。选择 Custom 可使用下方的宽度和高度。默认：此模型的第一个推荐预设。	COMBO	否	模型特定的推荐尺寸预设 ”Custom”
`width`	图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时该值才生效。默认：2048。	INT	否	1024 到 6240（步长 2）
`height`	图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时该值才生效。默认：2048。	INT	否	1024 到 4992（步长 2）
`max_images`	要生成的最大图像数量。设为 1 时，仅生成一张图像。设为 >1 时，模型生成 1 到 `max_images` 张相关图像（例如故事场景、角色变体）。图像总数（输入 + 生成）不能超过 15。默认：1。	INT	否	1 到 10
`fail_on_partial`	如果启用，当任何请求的图像缺失或返回错误时中止执行。默认：false。	BOOLEAN	否	true / false
`seed`	用于生成的种子。默认：42。	INT	否	0 到 2147483647
`watermark`	是否向图像添加“AI generated”水印。默认：false。	BOOLEAN	否	true / false
`thinking`	启用模型的提示词优化推理（“thinking”）以获得更好的遵循。可能大幅增加生成时间——在 Seedream 5.0 Pro 上尤其明显。仅可在文生图时禁用（提供参考图像时不可禁用）。默认：true。	BOOLEAN	否	true / false

Seedream 4.0 输入 (seedream-4-0-250828)

参数	描述	数据类型	必需	范围
`size_preset`	选择推荐尺寸。选择 Custom 可使用下方的宽度和高度。默认：此模型的第一个推荐预设。	COMBO	否	模型特定的推荐尺寸预设 ”Custom”
`width`	图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时该值才生效。默认：2048。	INT	否	1024 到 6240（步长 2）
`height`	图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时该值才生效。默认：2048。	INT	否	1024 到 4992（步长 2）
`max_images`	要生成的最大图像数量。设为 1 时，仅生成一张图像。设为 >1 时，模型生成 1 到 `max_images` 张相关图像（例如故事场景、角色变体）。图像总数（输入 + 生成）不能超过 15。默认：1。	INT	否	1 到 10
`fail_on_partial`	如果启用，当任何请求的图像缺失或返回错误时中止执行。默认：false。	BOOLEAN	否	true / false
`seed`	用于生成的种子。默认：42。	INT	否	0 到 2147483647
`watermark`	是否向图像添加“AI generated”水印。默认：false。	BOOLEAN	否	true / false
`thinking`	启用模型的提示词优化推理（“thinking”）以获得更好的遵循。可能大幅增加生成时间——在 Seedream 5.0 Pro 上尤其明显。仅可在文生图时禁用（提供参考图像时不可禁用）。默认：true。	BOOLEAN	否	true / false

参考输入

参数	描述	数据类型	必需	范围
`images`	可扩展槽位：用于图生图或多参考生成的可选参考图像。连接 1..N 张图像（例如 `image_1`、`image_2`、…）；数量限制因模型而异（见下方说明）。如果连接的图像包含一个图像批次，批次中的每张图像都计入限制。	IMAGE	否	0 到 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0) 0 到 14 (Seedream 5.0 Lite)

注意事项：

prompt 在去除空白字符后不能为空。
最大参考图像数量：Seedream 5.0 Pro、Seedream 4.5 和 Seedream 4.0 为 10；Seedream 5.0 Lite 为 14。
每张参考图像的宽高比必须在 1:3 到 3:1 之间。
当 max_images 大于 1 时（Seedream 5.0 Pro 不支持），参考图像数量加上生成图像总数不能超过 15。
thinking 仅可在文生图生成时禁用。提供参考图像时，必须启用 thinking。
仅当 size_preset 设置为 “Custom” 时，才会使用 width 和 height。
prompt_optimization 仅在 Seedream 5.0 Pro 上可用。
max_images 和 fail_on_partial 仅在 Seedream 5.0 Lite、Seedream 4.5 和 Seedream 4.0 上可用；Seedream 5.0 Pro 始终只请求一张图像。
分辨率要求（宽 x 高）：
- Seedream 5.0 Pro：介于 0.92MP（921,600 像素）和 4.19MP（4,194,304 像素）之间。
- Seedream 5.0 Lite 和 Seedream 4.5：至少 3.68MP（3,686,400 像素）。
- Seedream 4.0：至少 0.92MP（921,600 像素）。
- 所有非 Pro 模型：最多 16.78MP（16,777,216 像素）。

输出

输出名称	描述	数据类型
`image`	生成的图像张量。当生成多张图像时，它们会被拼接成单个批处理的 IMAGE 张量。	IMAGE

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): 68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac

​输入

​通用输入

​Seedream 5.0 Pro 输入 (seedream 5.0 pro)

​Seedream 5.0 Lite 输入 (seedream 5.0 lite)

​Seedream 4.5 输入 (seedream-4-5-251128)

​Seedream 4.0 输入 (seedream-4-0-250828)

​参考输入

​输出

输入