ComfyUI Volcengine SeeDream V3 Node

这是一个用于ComfyUI的自定义节点，可以调用火山引擎通用3.0文生图模型API来生成图像。

功能特性

• 调用火山引擎SeeDream V3文生图API
• 支持所有官方API参数
• 自动处理API签名验证
• 支持URL和Base64图像响应格式
• 完整的错误处理机制

安装

1. 将此项目克隆到ComfyUI的custom_nodes目录下：

cd ComfyUI/custom_nodes/
git clone [your-repo-url] ComfyUI-JM-Volcengine-API

2. 安装依赖：

cd ComfyUI-JM-Volcengine-API
pip install -r requirements.txt

3. 重启ComfyUI

使用方法

节点参数

必需参数

• access_key: 火山引擎API访问密钥
• secret_key: 火山引擎API秘钥
• prompt: 图像生成提示词（支持中英文）

可选参数

• use_pre_llm: 是否开启文本扩写（默认：False）
• seed: 随机种子，用于生成可重复的结果（默认：-1为随机）
• guidance_scale: 文本描述的影响程度（默认：2.5，范围：1.0-10.0）
• aspect_ratio: 图像宽高比，支持1.5K分辨率预设（默认：1:1）
• return_url: 是否返回图片URL链接（默认：True）

支持的图像分辨率 (1.5K)

节点支持以下预设的1.5K分辨率比例选项：

• 1:1 → 1536×1536 (正方形)
• 4:3 → 1472×1104 (传统照片比例)
• 3:2 → 1584×1056 (经典摄影比例)
• 16:9 → 1664×936 (宽屏比例)
• 9:16 → 936×1664 (竖屏比例，适合手机wallpaper)
• 21:9 → 2016×864 (超宽屏比例)

提示词优化技巧

1. 画面描述: 使用连贯的自然语言描述画面内容（主体+行为+环境等）
2. 美学描述: 用短词语描述画面美学（风格、色彩、光影、构图等）
3. 专业词汇: 推荐使用英文描述专业词汇，获得更精准效果
4. 图像用途: 说明图像用途和类型，如"PPT封面背景图"、"广告海报设计"等
5. 文字排版: 将文字内容置于双引号""内，并描述文字的大小、字体、颜色、风格和位置

示例提示词

【风格：漫画风格】【镜头视角：特写】一个可爱的机器人在花园里浇花，阳光明媚，色彩鲜艳，卡通风格

参数说明对照表

节点参数名	API参数名	说明
access_key	-	火山引擎API访问密钥
secret_key	-	火山引擎API密钥
prompt	prompt	图像生成提示词
use_pre_llm	use_pre_llm	文本扩写增强
seed	seed	随机种子
guidance_scale	scale	引导强度
aspect_ratio	width/height	自动设置宽高比
return_url	return_url	返回图片URL

节点位置

在ComfyUI中，您可以在以下位置找到该节点： Add Node → JM-MiniMax-API/Video → volcengine-seedream-v3

API配置

1. 登录火山引擎控制台
2. 获取您的access_key和secret_key
3. 确保您的账户有足够的API调用额度

错误处理

节点包含完整的错误处理机制：

• API密钥验证
• 网络请求超时处理
• 图像下载失败处理
• API响应错误处理

如果生成失败，节点会返回一个空白图像并在控制台输出错误信息。

注意事项

• 图像链接有效期为24小时
• 建议使用1.3K-1.5K分辨率获得最佳画质
• 请合理使用API避免超出配额限制
• 网络环境需要能够访问火山引擎API服务

技术支持

如果您遇到任何问题，请检查：

1. API密钥是否正确
2. 网络连接是否正常
3. ComfyUI控制台的错误信息
4. 火山引擎API配额是否充足

许可证

本项目基于MIT许可证开源。