> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ByteDanceSeedreamNodeV3 - ComfyUI Built-in Node Documentation

> ByteDance Seedream 4.5 & 5.0 可使用 ByteDance Seedream 4.0、4.5 和 5.0 模型，通过文本提示词生成图像（文生图），或在可选参考图像的引导下生成/编辑图像，分辨率最高可达 4K。

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"<br />"seedream 5.0 flash"<br />"seedream 5.0 lite"<br />"seedream-4-5-251128"<br />"seedream-4-0-250828" |

### Seedream 5.0 Pro 输入 (seedream 5.0 pro)

| 参数 | 描述 | 数据类型 | 必填 | 取值范围 |
| - | - | - | - | - |
| `size_preset` | 选择推荐的尺寸。选择 `Custom` 以使用下方的宽度和高度。默认：此模型的第一个推荐预设。 | COMBO | 否 | 模型专属推荐尺寸预设<br />"Custom" |
| `width` | 图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时该值才会生效。默认：2048。 | INT | 否 | 1024 到 4514 （步长：2） |
| `height` | 图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时该值才会生效。默认：2048。 | INT | 否 | 1024 到 4514 （步长：2） |
| `prompt_optimization` | 提供参考图像时的提示词优化模式：'standard' 质量更高，'fast' 生成时间更短。默认："standard"。 | COMBO | 否 | "standard"<br />"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 Flash 输入 (seedream 5.0 flash)

| 参数 | 描述 | 数据类型 | 必填 | 取值范围 |
| - | - | - | - | - |
| `size_preset` | 选择推荐的尺寸。选择 `Custom` 以使用下方的宽度和高度。默认：此模型的第一个推荐预设。 | COMBO | 否 | 模型专属推荐尺寸预设<br />"Custom" |
| `width` | 图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时该值才会生效。默认：2048。 | INT | 否 | 1024 到 4514 （步长：2） |
| `height` | 图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时该值才会生效。默认：2048。 | INT | 否 | 1024 到 4514 （步长：2） |
| `seed` | 用于生成的随机种子。默认：42。 | INT | 否 | 0 到 2147483647 |
| `watermark` | 是否为图像添加 “AI generated” 水印。默认：false。 | BOOLEAN | 否 | true / false |

### Seedream 5.0 Lite 输入 (seedream 5.0 lite)

| 参数 | 描述 | 数据类型 | 必填 | 取值范围 |
| - | - | - | - | - |
| `size_preset` | 选择推荐的尺寸。选择 `Custom` 以使用下方的宽度和高度。默认：此模型的第一个推荐预设。 | COMBO | 否 | 模型专属推荐尺寸预设<br />"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 | 否 | 模型专属推荐尺寸预设<br />"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 | 否 | 模型专属推荐尺寸预设<br />"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 5.0 Flash, Seedream 4.5, Seedream 4.0)<br />0 到 14 (Seedream 5.0 Lite) |

**说明：**

* 去除空白字符后，`prompt` 不能为空。
* 参考图像的最大数量：Seedream 5.0 Pro、Seedream 5.0 Flash、Seedream 4.5 和 Seedream 4.0 为 10；Seedream 5.0 Lite 为 14。
* 每张参考图像的宽高比必须在 1:16 到 16:1 之间。
* 当 `max_images` 大于 1 时（Seedream 5.0 Pro 或 Seedream 5.0 Flash 不支持），参考图像总数加上生成的图像数不能超过 15。
* `thinking` 只能在文生图时禁用。提供参考图像时，必须启用 `thinking`。Seedream 5.0 Flash 没有 `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 和 Seedream 5.0 Flash 始终只请求一张图像。
* 分辨率要求（宽 x 高）：
  * Seedream 5.0 Pro 和 Seedream 5.0 Flash：介于 0.92MP（921,600 像素）和 4.62MP（4,624,220 像素）之间。
  * Seedream 5.0 Lite 和 Seedream 4.5：至少 3.68MP（3,686,400 像素）。
  * Seedream 4.0：至少 0.92MP（921,600 像素）。
  * Seedream 5.0 Lite、Seedream 4.5 和 Seedream 4.0：最多 16.78MP（16,777,216 像素）。

## 输出

| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `image` | 生成的图像张量。生成多张图像时，它们会被拼接成一个批次化的 IMAGE 张量。 | IMAGE |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh.md)

***

**Source fingerprint (SHA-256):** `1c1f40b202ccbb3e0f73cd072170e1c16b833e007f26e63505b54c42b004a8a6`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.