# 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许可证开源。