> ## Documentation Index
> Fetch the complete documentation index at: https://api-doc.vncps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream 图片生成节点

> 在 ComfyUI 中使用豆包 Seedream API 生成高质量图片（支持文生图、图生图、多图融合与组图）

## 节点概述

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

### 支持的生成模式

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

***

## 节点界面

<img src="https://mintcdn.com/shihuo/ksPaHu-gA636miQn/images/seedream_run.png?fit=max&auto=format&n=ksPaHu-gA636miQn&q=85&s=797ae1262ee916d3a583f928d8580819" alt="Seedream 节点配置与运行界面" width="2184" height="1100" data-path="images/seedream_run.png" />

***

## 请求示例

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

***

## 参数说明

### 核心参数

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

<Info>
  * 当 `最大图片数量 > 0` 时，会在单次请求内生成组图；
  * `并发请求数` 控制同时发起的请求数量，可与 `启用分行提示词` 组合使用。
</Info>

***

## 图片尺寸与像素限制

### 模型版本像素范围

<Warning>
  不同模型版本有不同的总像素要求，设置尺寸时需遵守范围，否则会返回“像素不足”等错误。
</Warning>

| 模型版本                           | 总像素范围                  | 最小分辨率       | 最大分辨率       | 宽高比范围        |
| ------------------------------ | ---------------------- | ----------- | ----------- | ------------ |
| **doubao-seedream-4-5-251128** | 3,686,400 - 16,777,216 | `2560x1440` | `4096x4096` | `[1/16, 16]` |
| **doubao-seedream-4-0-250828** | 921,600 - 16,777,216   | `1280x720`  | `4096x4096` | `[1/16, 16]` |

### 有效尺寸示例

<CodeGroup>
  ```text Seedream 4.5 ✅ theme={null}
  2560x1440 - 总像素=3,686,400, 比例=16/9 ✅
  3024x1296 - 总像素=3,919,104, 比例=21/9 ✅
  2048x2048 - 总像素=4,194,304, 比例=1/1 ✅
  ```

  ```text Seedream 4.5 ❌ theme={null}
  1600x900  - 总像素=1,440,000 ❌ (低于最小值 3,686,400)
  1920x1080 - 总像素=2,073,600 ❌ (低于最小值 3,686,400)
  ```

  ```text Seedream 4.0 ✅ theme={null}
  1280x720  - 总像素=921,600, 比例=16/9 ✅
  1600x900  - 总像素=1,440,000, 比例=16/9 ✅
  1920x1080 - 总像素=2,073,600, 比例=16/9 ✅
  ```

  ```text Seedream 4.0 ❌ theme={null}
  800x800   - 总像素=640,000 ❌ (低于最小值 921,600)
  ```
</CodeGroup>

### 推荐尺寸速查表

| 宽高比      | 推荐像素值       | 适用场景      | 总像素       |
| -------- | ----------- | --------- | --------- |
| **1:1**  | `2048x2048` | 方形图片，社交媒体 | 4,194,304 |
| **4:3**  | `2304x1728` | 传统屏幕，横屏图片 | 3,981,312 |
| **3:4**  | `1728x2304` | 竖屏图片，手机壁纸 | 3,981,312 |
| **16:9** | `2560x1440` | 宽屏显示，视频封面 | 3,686,400 |
| **9:16** | `1440x2560` | 竖屏视频，短视频  | 3,686,400 |
| **3:2**  | `2496x1664` | 相机标准比例    | 4,153,344 |
| **2:3**  | `1664x2496` | 竖版相机比例    | 4,153,344 |
| **21:9** | `3024x1296` | 超宽屏，电影比例  | 3,919,104 |

<Info>
  * 社交媒体/头像：推荐 1:1 (2048x2048)；
  * 手机壁纸/竖屏：推荐 9:16 (1440x2560)；
  * 桌面壁纸/横向海报：推荐 16:9 (2560x1440) 或 21:9 (3024x1296)。
</Info>

***

## 功能模式

1. **文生图**
   * 只填提示词，不提供输入图片；
   * 适合从零构图、概念设计、封面创作。

2. **图生图**
   * 提供 1 张输入图片（输入图片1）；
   * 提示词描述需要如何改造该图片，例如风格转换、细节增强。

3. **多图融合**
   * 提供 2 张输入图片（输入图片1 & 输入图片2）；
   * 提示词中说明第一张/第二张图片各自的作用，如“第一张为人物，第二张为背景”。

4. **图生组图**
   * 设置 `最大图片数量 > 0`；
   * 同一提示词下生成多张相关图片，方便挑选最佳结果。

5. **批量生成（分行提示词 + 并发）**
   * 启用 `启用分行提示词`；
   * 提示词每行一个独立描述；
   * 配合 `并发请求数`，实现多提示词 × 多并发的组合生成。

***

## 并发和分行提示词

### 并发请求说明

<ParamField path="并发请求数" type="integer" default="1">
  控制同一批任务中并发发起的请求数量。

  * 范围：`1-10`；
  * 并发数越大，总体生成耗时越短，但对 API QPS 和额度消耗越高；
  * 建议先在小并发下验证提示词，再逐步放大。
</ParamField>

### 启用分行提示词说明

<ParamField path="启用分行提示词" type="boolean" default="false">
  将提示词按行拆分，每行作为一个独立任务处理。

  **行为说明：**

  * 启用后：按行切分提示词，自动过滤空行；
  * 每行会调用一次 API，再结合 `并发请求数` 扩展为多张图片；
  * 总图片数 ≈ `行数 × 并发请求数 × (最大图片数量 或 默认数量)`。

  **示例：**

  ```text theme={null}
  提示词：
  星际穿越，黑洞，复古列车
  赛博朋克风格，未来城市
  海洋深处，神秘生物
  并发请求数：3
  ```

  →三行提示词 × 3 并发 = 9 组请求，每组生成若干张图片。
</ParamField>

***

## 重试机制

<ParamField path="最大重试次数" type="integer" default="3">
  当调用返回服务端错误（5xx）时的自动重试次数。

  * `0`：不重试；
  * `1-10`：重试对应次数，采用指数退避策略。
</ParamField>

<Info>
  **重试策略（与 README 一致）：**

  * 自动重试：遇到 5xx 服务器错误时触发；
  * 指数退避：2 秒 → 4 秒 → 8 秒递增等待，最长不超过约 30 秒；
  * 智能判断：4xx 客户端错误不会重试（避免浪费额度），但 429（限流）可在实现中视为可重试。
</Info>

***

## 输出说明

<ResponseField name="images" type="array">
  生成的图片数组，自动保存到 ComfyUI 输出目录。

  **文件信息：**

  * 文件格式：`.png`；
  * 命名规则：`ComfyUI_[序号].png`；
  * 默认保存路径：`ComfyUI/output/`；
  * 数量：由 `最大图片数量`、分行提示词和并发共同决定。
</ResponseField>

***

## 使用示例

### 示例 1：文生图

<Steps>
  <Step title="配置提示词">
    ```
    星际穿越，黑洞，电影大片风格，
    黑洞里冲出一辆即将支离破碎的复古列车，
    高对比度光影，细节丰富，8K 高清。
    ```
  </Step>

  <Step title="设置尺寸">
    * 模型：`doubao-seedream-4-0-250828`
    * 宽度：`2048`
    * 高度：`2048`
    * 最大图片数量：`3`
  </Step>

  <Step title="执行生成">
    运行节点，得到 3 张不同结果的方形图片。
  </Step>
</Steps>

### 示例 2：图生图

<Steps>
  <Step title="连接输入图片">
    将一张照片连接到 `输入图片1`。
  </Step>

  <Step title="配置提示词">
    ```
    将这张图片转换为水彩画风格，
    色调柔和，保留原有构图和主体元素。
    ```
  </Step>

  <Step title="设置参数">
    * 模型：`doubao-seedream-4-5-251128`
    * 宽度：`2560`
    * 高度：`1440`（16:9 比例）
    * 最大图片数量：`4`
  </Step>
</Steps>

### 示例 3：多图融合

<Steps>
  <Step title="连接两张图片">
    * 输入图片1：人物照片；
    * 输入图片2：场景背景。
  </Step>

  <Step title="配置提示词">
    ```
    将第一张图片中的人物自然融入第二张图片的场景中，
    保持光线方向一致，整体风格偏电影感，高质量渲染。
    ```
  </Step>

  <Step title="设置高质量参数">
    * 模型：`doubao-seedream-4-5-251128`
    * 宽度：`3024`
    * 高度：`1296`（21:9 超宽屏）
    * 最大图片数量：`2`
  </Step>
</Steps>

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

<Steps>
  <Step title="配置多行提示词">
    ```
    森林小屋，阳光洒落
    赛博朋克风格，未来城市
    海洋深处，神秘生物
    ```
  </Step>

  <Step title="设置并发与数量">
    * 启用分行提示词：`True`
    * 并发请求数：`3`
    * 最大图片数量：`1`
  </Step>

  <Step title="执行生成">
    将生成 `3 行 × 3 并发 = 9` 张图片，覆盖 3 个主题的多种变体。
  </Step>
</Steps>

***

## 常见问题

<AccordionGroup>
  <Accordion title="如何选择合适的模型版本？">
    * **Seedream 4.5（doubao-seedream-4-5-251128）** 适合：
      * 高质量大图、商用项目；
      * 对细节和质感要求高的场景；
      * 打印、海报等高分辨率用途。

    * **Seedream 4.0（doubao-seedream-4-0-250828）** 适合：
      * 快速预览、调参；
      * 生成小尺寸图片；
      * 对画质要求相对不高的场景。
  </Accordion>

  <Accordion title="为什么会提示像素不足？">
    这是因为设置的 `宽度 × 高度` 不满足模型的最小总像素要求：

    * 4.5：最小总像素 3,686,400，如 `2560x1440`；
    * 4.0：最小总像素 921,600，如 `1280x720`。

    **解决方案：**

    1. 使用上面的推荐尺寸速查表；
    2. 或切换到 Seedream 4.0 并使用较小尺寸。
  </Accordion>

  <Accordion title="生成的图片质量不理想怎么办？">
    * 优化提示词：增加细节、风格、光线、分辨率等描述；
    * 提高分辨率或更换到 4.5 模型；
    * 使用参考图片作为风格/构图参考；
    * 通过组图和并发多生成几张，从中挑选最佳结果。
  </Accordion>

  <Accordion title="批量生成的图片差异大吗？">
    是的，即使提示词完全相同，每次生成仍然会有随机性：

    * 同一批次会围绕提示词产生多种变化；
    * 生成数量越多，选择空间越大；
    * 可以通过固定种子在一定程度上稳定风格（视具体实现）。
  </Accordion>
</AccordionGroup>