120 lines
3.6 KiB
Markdown
120 lines
3.6 KiB
Markdown
# ComfyUI Volcengine SeeDream V3 Node
|
||
|
||
这是一个用于ComfyUI的自定义节点，可以调用火山引擎通用3.0文生图模型API来生成图像。
|
||
|
||
## 功能特性
|
||
|
||
- 调用火山引擎SeeDream V3文生图API
|
||
- 支持所有官方API参数
|
||
- 自动处理API签名验证
|
||
- 支持URL和Base64图像响应格式
|
||
- 完整的错误处理机制
|
||
|
||
## 安装
|
||
|
||
1. 将此项目克隆到ComfyUI的custom_nodes目录下：
|
||
```bash
|
||
cd ComfyUI/custom_nodes/
|
||
git clone [your-repo-url] ComfyUI-JM-Volcengine-API
|
||
```
|
||
|
||
2. 安装依赖：
|
||
```bash
|
||
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许可证开源。 |