> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/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 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 至 3136（步长 2）         |
| `height`              | 自定义图像高度。仅当 `size_preset` 设置为 `Custom` 时，该值才生效。默认值：2048。                                                       | INT     | 否    | 1024 至 2496（步长 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 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 4.5、Seedream 4.0）<br />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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh.md)

***

**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac`