# ComfyUI-GQCH-Online

**Repository Path**: bosima/ComfyUI-GQCH-Online

## Basic Information

- **Project Name**: ComfyUI-GQCH-Online
- **Description**: No description available
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-10
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ComfyUI-GQCH-Online

ComfyUI插件，用于调用"高清重绘Online"API进行图片处理。

## 功能特性

- 🎯 **高清重绘** - 图片高清放大与重绘（支持1-8倍放大，多种模型和风格）
- 📥 **下载矢量图** - 下载矢量图文件到本地（.eps格式）
- 🎨 **改图任务** - AI智能编辑图片（支持v1/v2模型）
- 📐 **扩图任务** - 图片智能扩展（支持四个方向独立控制）
- 🧵 **移除布纹** - 去除布料纹理
- 💎 **移除烫钻** - 去除烫钻效果
- 💧 **去水印** - 智能去除水印

## 安装

1. 将此插件克隆到ComfyUI的`custom_nodes`目录：
```bash
cd ComfyUI/custom_nodes
git clone https://github.com/yourusername/ComfyUI-GQCH-Online.git
```

2. 安装依赖：
```bash
cd ComfyUI-GQCH-Online
pip install -r requirements.txt
```

3. 重启ComfyUI

## 配置

在使用前，需要配置用户密钥。在插件目录下创建`config.json`文件：

```json
{
  "user_key": "your_user_key_here",
  "api_base_url": "https://gqch.haoee.com/api"
}
```

或者复制示例配置文件：
```bash
cp config.json.example config.json
# 然后编辑config.json，填入你的user_key
```

**注意：** `user_key`需要联系客服或进群获取。

## 使用方法

所有节点都会**自动提交任务并等待完成**，无需手动轮询状态，使用非常简单！

### 节点说明

#### 1. GQCH 高清重绘
对图片进行高清放大与重绘处理，支持多种模型和风格，自动等待完成并返回结果。

**输入：**
- `image`: 输入图片
- `sdxl_model`: 处理模型选择
  - `通用模型`: 适用于大多数图片类型
  - `真实模型`: 适用于真实照片
- `style`: 处理风格选择（15种风格可选）
  - `通用风格`: 通用处理风格
  - `花卉风格`: 适合花卉图案
  - `水彩风格`: 水彩画效果
  - `3D立体风格`: 3D立体效果
  - `绣花刺绣`: 刺绣纹理效果
  - `牛仔纹路`: 牛仔布料效果
  - `卡通人物`: 卡通动画风格
  - `油画风格`: 油画艺术效果
  - `豹纹风格`: 豹纹图案效果
  - `抽象艺术`: 抽象艺术风格
  - `几何图案`: 几何图形风格
  - `皮带链条`: 皮革链条效果
  - `条纹风格`: 条纹图案效果
  - `风景照片`: 自然风景效果
  - `矢量图风格`: 矢量图形效果
- `upscale`: 图像放大倍数（1.0-8.0，默认2.0）
- `s_noise`: 噪声强度参数（1.0-1.1，默认1.003，值越大细节越丰富）
- `steps`: 采样步数（20-40，默认30，值越大质量越高但速度越慢）
- `high_fidelity`: 高保真度处理开关（开启后更接近原图）
- `strong_inpaint`: 强力修复功能开关（开启后修复效果更强）
- `strong_inpaint_intensity`: 强力修复强度（0.0-1.0，默认0.5，仅在开启强力修复时有效）
- `prompt`: 正面提示词（可选，用于引导生成方向）
- `neg_prompt`: 负面提示词（可选，用于避免不想要的效果）
- `vector_switch`: 是否生成矢量图（默认关闭，仅适用于颜色简单的图形）
- `color_count`: 矢量图颜色数量（2-16，默认5，仅在开启矢量图时有效）
- `auto_generate_prompt`: 是否自动生成提示词（默认关闭）
- `user_key`: 用户密钥（可选，覆盖配置文件）
- `max_wait_time`: 最大等待时间（秒，默认600秒）

**输出：**
- `image`: 处理后的高清图片（放大后的图片）
- `image_1m`: 1倍原始尺寸的图片（如果API返回）
- `vector_url`: 矢量图URL（如果启用了矢量图生成，.eps格式）
- `info`: 任务信息（任务ID、剩余次数、剩余金额、生成的提示词等）

**使用建议：**
- 对于照片类图片，建议使用"真实模型"
- 对于设计图案，建议使用"通用模型"并选择合适的风格
- 放大倍数越大，处理时间越长
- 开启高保真模式可以更好地保留原图细节
- 矢量图功能仅适用于颜色较少、线条简单的图形
- 如需下载矢量图文件，可将 `vector_url` 连接到"GQCH 下载矢量图"节点

**工作流示例：**
```
LoadImage → GQCH 高清重绘 → SaveImage (保存高清图)
                        ↓
                   image_1m → SaveImage (保存1倍图)
                        ↓
                   vector_url → GQCH 下载矢量图 (可选)
```

#### 2. GQCH 下载矢量图
下载矢量图文件到本地，将URL转换为本地文件路径。

**输入：**
- `vector_url`: 矢量图URL（必需，通常从"GQCH 高清重绘"节点获取）
- `filename`: 自定义文件名（可选，不填则使用时间戳，自动添加.eps后缀）

**输出：**
- `vector_path`: 本地矢量图文件路径（.eps格式）

**使用说明：**
- 矢量图文件保存在插件目录的 `output/vectors/` 文件夹中
- 可以使用 Adobe Illustrator、CorelDRAW 等软件打开 .eps 文件
- 如果 `vector_url` 为空，则返回空字符串

**工作流示例：**
```
GQCH 高清重绘 → vector_url → GQCH 下载矢量图 → vector_path
```

#### 3. GQCH 改图 (AI编辑)
根据文本指令对图片进行AI编辑，自动等待完成并返回结果。

**输入：**
- `image`: 输入图片
- `prompt`: AI编辑指令（例如："将这张图片转换为水彩画风格"）
- `model_version`: 模型版本（v1/v2，v2质量更高）
- `user_key`: 用户密钥（可选，覆盖配置文件）
- `max_wait_time`: 最大等待时间（秒，默认600秒）

**输出：**
- `image`: 处理后的图片
- `info`: 任务信息（任务ID、剩余次数、剩余金额）

**工作流示例：**
```
LoadImage → GQCH 改图 (AI编辑) → SaveImage
```

#### 4. GQCH 扩图
在图片四周进行智能扩展，自动等待完成并返回结果。

**输入：**
- `image`: 输入图片
- `expand_top/bottom/left/right`: 各方向扩图比例（0.0-0.3）
- `prompt`: AI生成扩展部分的提示词（可选）
- `user_key`: 用户密钥（可选）
- `max_wait_time`: 最大等待时间（秒，默认300秒）

**输出：**
- `image`: 处理后的图片
- `info`: 任务信息

**注意：** 扩展比例表示在该方向上增加原图相应边长的百分比，例如0.2表示增加20%。

**工作流示例：**
```
LoadImage → GQCH 扩图 → SaveImage
```

#### 5. GQCH 移除布纹
移除图像中的布纹理，自动等待完成并返回结果。

**输入：**
- `image`: 输入图片
- `user_key`: 用户密钥（可选）
- `max_wait_time`: 最大等待时间（秒，默认300秒）

**输出：**
- `image`: 处理后的图片
- `info`: 任务信息

**注意：** 文件大小不能超过16MB。

#### 6. GQCH 移除烫钻
移除图片中的水钻、烫钻和闪光装饰，自动等待完成并返回结果。

**输入/输出：** 同"移除布纹"

#### 7. GQCH 去水印
智能移除图片中的水印元素，自动等待完成并返回结果。

**输入/输出：** 同"移除布纹"

**注意：** 文件大小不能超过16MB。

---

## 工作流示例

为了帮助您快速上手，我们在 `examples/` 目录中提供了两个完整的工作流示例：

### 1. 高清重绘示例 (`examples/高清重绘.json`)
演示如何使用高清重绘功能：
- 加载图片
- 使用GQCH高清重绘节点进行图片放大和重绘
- 保存高清图片和1倍图
- （可选）下载矢量图文件

**使用方法：**
1. 在ComfyUI中点击"Load"按钮
2. 选择 `ComfyUI-GQCH-Online/examples/高清重绘.json`
3. 加载后即可看到完整的工作流
4. 根据需要调整参数并运行

### 2. 去布纹示例 (`examples/去布纹.json`)
演示如何使用去布纹功能：
- 加载带有布纹的图片
- 使用GQCH去布纹节点移除布料纹理
- 保存处理后的图片

**使用方法：**
1. 在ComfyUI中点击"Load"按钮
2. 选择 `ComfyUI-GQCH-Online/examples/去布纹.json`
3. 加载后即可看到完整的工作流
4. 替换为您自己的图片并运行

**提示：** 您可以基于这些示例创建自己的工作流，组合使用不同的节点来实现更复杂的图片处理流程。

---

## 工作原理

### 自动轮询机制
所有节点都会自动处理任务：
1. 提交任务到API
2. 每3秒自动查询一次任务状态（符合API建议）
3. 任务完成后自动下载结果图片
4. 返回处理后的图片

### 轮询参数
- **检查间隔：** 3秒（符合API建议）
- **最大等待时间：** 默认600秒（10分钟），可通过`max_wait_time`参数调整（最长1800秒/30分钟）
- **超时处理：** 超过最大等待时间会抛出异常
- **失败处理：** 任务失败会立即抛出异常并显示错误信息

## 技术细节

### 图片格式转换
- ComfyUI使用tensor格式（shape: [B, H, W, C]，值范围0-1）
- API使用multipart/form-data上传PNG格式图片
- 插件自动处理格式转换

### 任务状态
- 任务提交后返回`task_id`
- 自动轮询`check_task_status`查询状态
- 状态为`Completed`时下载结果

## 常见问题

### Q: 如何获取user_key？
A: 请联系客服或进群咨询获取。

### Q: 任务提交后多久能完成？
A: 处理时间取决于任务类型和服务器负载，一般在几秒到几十秒之间。插件会自动等待，无需担心。

### Q: 如果任务处理时间很长怎么办？
A: 可以调整`max_wait_time`参数增加最大等待时间（默认600秒，最长1800秒/30分钟）。

### Q: 文件大小限制是多少？
A: 大部分任务支持最大16MB的图片文件。

### Q: 支持哪些图片格式？
A: 插件会自动将图片转换为PNG格式上传，ComfyUI支持的所有图片格式都可以使用。

### Q: 任务失败了怎么办？
A: 插件会自动检测任务失败并抛出异常，显示错误信息。请检查输入参数和网络连接。

### Q: 处理过程中可以看到进度吗？
A: 可以！插件会在控制台实时打印进度信息，包括检查次数、已等待时间和当前状态。

## API接口说明

本插件使用的API接口：
- 提交高清重绘任务：`POST /api/submit_task`
- 提交改图任务：`POST /api/submit_edit_image_task`
- 提交扩图任务：`POST /api/submit_expand_image_task`
- 提交移除布纹任务：`POST /api/submit_remove_fabric_task`
- 提交移除烫钻任务：`POST /api/submit_remove_diamonds_task`
- 提交去水印任务：`POST /api/submit_remove_watermark_task`
- 查询任务状态：`POST /api/check_task_status`

详细API文档请参考：https://gqch.haoee.com/api/description

## 许可证

Apache 2.0

## 贡献

欢迎提交Issue和Pull Request！

## 联系方式

- API文档：https://gqch.haoee.com/api/description
- 获取user_key：请联系客服或进群咨询