Seedream4.5-comfyui-doubao4.5-comfyui

ComfyUI Seedream 4.5 插件

用于在 ComfyUI 中调用火山引擎的 Seedream 4.5 模型进行文生图和图生图。

⚠️⚠️⚠️注意，这一版本进入comfyui时，请首先设置timeout（控制网络请求超时时间），30秒到100秒之间都不错。

功能特点

• 🚀 文生图 (Text-to-Image): 纯文本提示词生成图像
• 🎨 图生图 (Image-to-Image): 基于参考图像进行图像生成
• 🔐 API 密钥安全: 密码输入字段保护您的密钥
• 🖼️ 多图输入支持: 图生图节点支持最多 4 张输入图片，API 支持多图参考生成
• ⏱️ 可配置超时: 网络请求超时时间可自定义（1-300秒）
• 🖼️ 多图输出支持: 支持生成多张序列图像（最多8张）
• ⚡ 稳定可靠: 完善的错误处理和超时机制

安装方法

1. 安装插件

 将插件文件夹复制到 ComfyUI 的 custom_nodes 目录
cp -r ComfyUI-Seedream /path/to/your/ComfyUI/custom_nodes/

2. 安装依赖

cd /path/to/your/ComfyUI
pip install -r custom_nodes/ComfyUI-Seedream/requirements.txt

3. 重启 ComfyUI 重启 ComfyUI 使插件生效。

获取 API 密钥

1. 访问 火山引擎方舟平台
2. 注册/登录账户
3. 创建 API 密钥
4. 确保账户有足够的额度

节点说明

🚀 Seedream 4.5 Text2Image (文生图)

输入参数:

• prompt: 生成提示词（多行文本）
• api_key: 火山引擎 API 密钥（密码输入）
• model: 模型名称（默认：doubao-seedream-4-5-251128）
• size: 输出尺寸（1K, 2K, 720x1280, 1280x720）
• watermark: 是否添加水印（布尔值）
• timeout: 网络请求超时时间（秒，1-300，默认30）
• sequential_image_generation: 序列图像生成模式（disabled/auto/enabled，默认disabled）
• max_images: 最大生成图像数量（1-8，默认1，仅在序列生成启用时有效）

输出:

• IMAGE: 生成的图像张量

🚀 Seedream 4.5 Image2Image (图生图)

必需参数:

• image: 输入图像（ComfyUI 图像张量，至少一张）
• prompt: 生成提示词（多行文本）
• api_key: 火山引擎 API 密钥（密码输入）
• model: 模型名称（默认：doubao-seedream-4-5-251128）
• size: 输出尺寸（1K, 2K, 720x1280, 1280x720）
• watermark: 是否添加水印（布尔值）
• timeout: 网络请求超时时间（秒，1-300，默认30）
• sequential_image_generation: 序列图像生成模式（disabled/auto/enabled，默认disabled）
• max_images: 最大生成图像数量（1-8，默认1，仅在序列生成启用时有效）

可选参数:

• image2, image3, image4: 额外输入图像（最多 4 张）

注意: 火山引擎 API 支持多图参考生成，最多可输入4张图片。所有图片都会发送到 API 进行综合参考。

输出:

• IMAGE: 生成的图像张量

使用示例

文生图工作流

1. 在节点菜单中找到 Seedream 类别
2. 选择 🚀 Seedream 4.5 Text2Image
3. 输入您的 API 密钥和提示词
4. 连接输出到图像显示或保存节点

图生图工作流

1. 选择 🚀 Seedream 4.5 Image2Image
2. 连接至少一张输入图片到 image 端口
3. 可选：连接额外图片到 image2、image3、image4 端口
4. 填写提示词和其他参数
5. 运行工作流

文件结构

ComfyUI-Seedream/
├── __init__.py           节点注册
├── seedream_node.py      核心节点实现
├── requirements.txt      依赖列表
├── .gitignore           Git 忽略文件
└── README.md            本文档

常见问题

Q: 插件安装后节点不显示 A: 确保已重启 ComfyUI，并检查控制台是否有错误信息。

Q: API 调用失败 A: 检查 API 密钥是否正确、账户是否有额度、网络连接是否正常。

Q: 多图输入如何处理？ A: 节点支持最多 4 张输入，所有图片都会转换为 Base64 Data URLs 并发送到 API 进行多图参考生成。

Q: 输出图像尺寸不符 A: 确保 size 参数设置正确，API 会根据设置调整输出尺寸。

技术细节

• API 端点: https://ark.cn-beijing.volces.com/api/v3/images/generations
• 图像格式: 输入图像自动转换为 Base64 Data URL
• 超时设置: 请求超时可配置（1-300秒）
• 序列生成: 支持生成多张序列图像（最多8张）
• 错误处理: API 失败时返回原图或黑色占位图

更新日志

v1.1.0 (2025-12-20)

• 添加可配置超时时间（1-300秒）
• 添加序列图像生成支持（最多8张）
• 优化多图输入处理

v1.0.0 (2025-12-20)

• 初始版本发布
• 支持文生图和图生图
• 支持最多 4 张图片输入

许可证

MIT License

免责声明

本插件仅为第三方集成工具，与火山引擎官方无关。使用本插件需要遵守火山引擎的服务条款和使用政策。