comfyui-artsmcp

KO | EN

gitlite — search

#react #ai #android #rust #linux #docker #macos #awesome #cli #vue #awesome-list #mcp #ios #openai

comfyui-artsmcp

(★ 3)

comfyui的插件,适配seedream和seedream

comfyui-artsmcp 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

ComfyUI 插件，集成多种 AI API 进行专业的图像生成：
- **Gemini Banana**: Google Gemini 3 Pro 图像生成（支持文生图、图生图、多图融合）
- **Gemini 3.1 Image**: Google Gemini 3.1 图像生成（支持文生图、图生图、多图融合）
- **Doubao Seedream**: AI 图像生成（文生图、图生图、图生组图、多图融合）

## 功能特性

### � Gemini Banana（推荐）
- ✅ **文生图**：根据文本提示生成高质量图片
- ✅ **图生图**：单图输入生成新图片
- ✅ **多图融合**：融合多张图片生成新图片（最多4张）
- ✅ **分行提示词**：支持多行提示词批量生成，每行独立处理
- ✅ **并发请求**：真正的并发API请求和图片下载，显著提升性能
- ✅ **匹配参考尺寸**：图生图模式下自动匹配参考图尺寸（智能缩放+居中裁剪）
- ✅ **企业级稳定性**：智能尺寸归一化、Session连接池复用、异常自动抛出
- ✅ **日志分级控制**：支持详细/精简两种日志模式
- ✅ 支持 Gemini 3 Pro Image 模型（1K/2K/4K）
- ✅ 支持 10 种宽高比（1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9）
- ✅ 支持 URL 和 Base64 两种响应格式（自动兼容 Data URI）
- ✅ 自动重试机制（智能错误处理）
- ✅ 独立配置管理
- ✅ 参数自动保存，下次使用更便捷
- ✅ 中文参数界面，更友好的用户体验

### ✨ Gemini 3.1 Image（推荐）
- ✅ **文生图**：根据文本提示生成高质量图片
- ✅ **图生图**：单图输入生成新图片
- ✅ **多图参考**：融合多张图片生成新图片（最多14张）
- ✅ **分行提示词**：支持多行提示词批量生成，每行独立处理
- ✅ **并发请求**：真正的并发API请求和图片下载，显著提升性能
- ✅ **日志分级控制**：支持详细/精简两种日志模式
- ✅ 支持 gemini-3.1-flash-image-preview 和 gemini-3-pro-image-preview 模型
- ✅ 支持 14 种宽高比（1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1）
- ✅ 支持 0.5K/1K/2K/4K 分辨率选择
- ✅ 使用 Gemini 原生 API 格式（contents + parts + inline_data）
- ✅ 自动重试机制（智能错误处理）
- ✅ Session 连接池复用，性能优化
- ✅ 独立配置管理
- ✅ 参数自动保存，下次使用更便捷

###  Doubao Seedream（推荐）
- ✅ **文生图**：根据文本提示生成图片
- ✅ **图生图**：单图输入生成新图片
- ✅ **图生组图**：生成多张相关图片
- ✅ **多图融合**：融合多张图片生成新图片
- ✅ **分行提示词**：支持多行提示词批量生成，每行独立处理
- ✅ **并发请求**：真正的并发API请求和图片下载，显著提升性能
- ✅ **可调重试**：自定义最大重试次数(0-10次)，灵活控制容错策略
- ✅ 支持多种图片尺寸和质量选项

## 安装

1. 将插件文件夹复制到ComfyUI的`custom_nodes`目录
2. 安装依赖：
```bash
pip install -r requirements.txt
```

## 使用方法

### 🎨 Gemini Banana（推荐）

**请求示例**：
```json
{
  "model": "gemini-3-pro-image-preview-2k",
  "prompt": "星际穿越，黑洞，电影大片，超现实主义",
  "size": "1:1",
  "n": 1,
  "response_format": "url"
}
```

**参数说明**：

| 参数 | 类型 | 说明 | 可选值 |
|------|------|------|--------|
| `提示词` | STRING | 图片生成的文本描述（支持多行） | 支持中英文 |
| `API密钥` | STRING | API 身份验证密钥 | sk-xxx |
| `API地址` | STRING | API 服务端点 | 默认：https://api.xxx.com |
| `模型` | ENUM | 选择模型 | gemini-3-pro-image-preview / 2k / 4k |
| `宽高比` | ENUM | 图片宽高比 | 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 |
| `响应格式` | ENUM | 返回格式 | URL / Base64 |
| `超时秒数` | INT | API 请求超时时间 | 30-600，默认120 |
| `最大重试次数` | INT | 失败后重试次数 | 1-10，默认3 |
| `并发请求数` | INT | 一次生成的图片数量 | 1-10，默认1 |
| `启用分行提示词` | BOOLEAN | 是否按行拆分提示词 | 默认False |
| `匹配参考尺寸` | BOOLEAN | 是否将输出图片调整为参考图尺寸 | 默认False |
| `详细日志` | BOOLEAN | 是否显示详细调试信息 | 默认False |
| `参考图片1-4` | IMAGE | 可选输入图片 | 用于图生图/多图融合 |

**功能模式**：
1. **文生图**：只填提示词，不提供输入图片
2. **图生图**：提供 1 张输入图片
3. **多图融合**：提供 2-4 张输入图片
4. **批量生成**：启用分行提示词，每行独立处理

**使用示例**：
```
Gemini Banana
  ├─ 提示词: "星际穿越，黑洞，电影大片"
  ├─ 模型: gemini-3-pro-image-preview-2k
  ├─ 宽高比: 16:9
  ├─ 并发请求数: 1
  ├─ 响应格式: URL
  └─ 图片输出 ──→ SaveImage
```

**批量生成示例**：
```
Gemini Banana
  ├─ 提示词: "星际穿越，黑洞
             赛博朋克风格，未来城市
             海洋深处，神秘生物"
  ├─ 启用分行提示词: True ☑
  ├─ 并发请求数: 3
  └─ 图片输出 ──→ SaveImage (输出9张图片: 3行×3并发)
```

**图生图示例**：
```
Load Image ──→ 参考图片1 (1600×2848)
                 ↓
Gemini Banana
  ├─ 提示词: "将这张图片转换为油画风格"
  ├─ 匹配参考尺寸: True ☑
  ├─ 参考图片1: <connected>
  └─ 图片输出 ──→ SaveImage (输出1600×2848)
```

**多图融合示例**：
```
Load Image ──→ 图片1
Load Image ──→ 图片2
                 ↓
Gemini Banana
  ├─ 提示词: "融合这两张图片的风格"
  ├─ image1: <connected>
  ├─ image2: <connected>
  └─ 图片输出 ──→ SaveImage
```

**匹配参考尺寸功能**：
- ✅ **触发条件**：启用该开关 + 有输入参考图片
- ✅ **处理方式**：使用第一张参考图的尺寸作为目标，对所有输出图片进行智能缩放+居中裁剪
- ✅ **适用场景**：确保输出图片与参考图尺寸完全一致，便于后续处理
- ✅ **技术细节**：使用 LANCZOS 高质量重采样算法 + ImageOps.fit 居中裁剪
- ⚠️ **注意**：API 请求的 `宽高比` 参数不受影响，仍按选择的比例让模型构图，仅在本地对输出进行调整

**重试机制说明**：
- ✅ **自动重试**：遇到 503/429 等错误自动重试
- ✅ **指数退避**：2秒、4秒、8秒递增等待
- ✅ **智能判断**：4xx 客户端错误（除429）直接失败不浪费重试
- ✅ **详细日志**：显示每次重试的详细信息

---

### ✨ Gemini 3.1 Image（推荐）

**请求示例（Gemini 原生格式）**：
```json
{
  "contents": [
    {
      "parts": [
        {"text": "请为黑客帝国设计一张高品质的3D海报"},
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "&lt;base64_encoded_image&gt;"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}
```

**参数说明**：

| 参数 | 类型 | 说明 | 可选值 |
|------|------|------|--------|
| `提示词` | STRING | 图片生成的文本描述（支持多行） | 支持中英文 |
| `API密钥` | STRING | API 身份验证密钥 | sk-xxx |
| `生成API地址` | STRING | API 服务端点 | 默认：https://ai.artsapi.com/ |
| `模型` | ENUM | 选择模型 | gemini-3.1-flash-image-preview / gemini-3-pro-image-preview |
| `宽高比` | ENUM | 图片宽高比 | 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 / 1:4 / 4:1 / 1:8 / 8:1 |
| `分辨率` | ENUM | 图像分辨率 | 0.5K / 1K / 2K / 4K |
| `超时秒数` | INT | API 请求超时时间 | 10-600，默认120 |
| `最大重试次数` | INT | 失败后重试次数 | 1-10，默认3 |
| `并发请求数` | INT | 一次生成的图片数量 | 1-10，默认1 |
| `启用分行提示词` | BOOLEAN | 是否按行拆分提示词 | 默认False |
| `参考图片1-14` | IMAGE | 可选参考图片 | 用于图生图/多图参考 |

**功能模式**：
1. **文生图**：只填提示词，不提供参考图片
2. **图生图**：提供 1 张参考图片
3. **多图参考**：提供 2-14 张参考图片
4. **批量生成**：启用分行提示词，每行独立处理

**使用示例**：
```
Gemini 3.1 Image
  ├─ 提示词: "请为黑客帝国设计一张高品质的3D海报"
  ├─ 模型: gemini-3.1-flash-image-preview
  ├─ 宽高比: 16:9
  ├─ 分辨率: 2K
  ├─ 并发请求数: 2
  └─ 图片 ──→ SaveImage (批次格式)
```

**批量生成示例**：
```
Gemini 3.1 Image
  ├─ 提示词: "请为黑客帝国设计一张高品质的3D海报
             请为阿凡达设计一张高品质的3D海报
             请为星际穿越设计一张高品质的3D海报"
  ├─ 启用分行提示词: True ☑
  ├─ 并发请求数: 2
  └─ 图片 ──→ SaveImage (输出6张图片: 3行×2并发)
```

**图生图示例**：
```
Load Image ──→ 参考图片1
                 ↓
Gemini 3.1 Image
  ├─ 提示词: "将这张图片转换为油画风格"
  ├─ 参考图片1: <connected>
  └─ 图片 ──→ SaveImage
```

**多图参考示例**：
```
Load Image ──→ 参考图片1
Load Image ──→ 参考图片2
                 ↓
Gemini 3.1 Image
  ├─ 提示词: "融合这两张图片的风格"
  ├─ 参考图片1: <connected>
  ├─ 参考图片2: <connected>
  └─ 图片 ──→ SaveImage
```

**重试机制说明**：
- ✅ **自动重试**：遇到 5xx 服务器错误自动重试
- ✅ **指数退避**：2秒、4秒、8秒递增等待（最多20秒）
- ✅ **智能判断**：4xx 客户端错误（除429）直接失败不浪费重试
- ✅ **详细日志**：显示每次重试的详细信息

**输出格式说明**：
- ✅ **单端口批次输出**：所有生成的图片合并为一个批次 tensor
- ✅ **张量形状**：`[N, H, W, C]`，N 为图片数量
- ✅ **尺寸统一**：如果图片尺寸不一致，自动统一为最小尺寸（居中裁剪）

---

### � Doubao Seedream（推荐）

**请求示例**：
```json
{
  "model": "doubao-seedream-4-0-250828",
  "prompt": "一只可爱的猫咪，卡通风格，高清",
  "size": "1024x1024",
  "n": 1
}
```

**参数说明**：

| 参数 | 类型 | 说明 | 可选值 |
|------|------|------|--------|
| `提示词` | STRING | 图片生成的文本描述（支持多行） | 支持中英文 |
| `API密钥` | STRING | API 身份验证密钥 | sk-xxx |
| `API地址` | STRING | API 服务端点 | 默认：https://api.xxx.com |
| `模型` | ENUM | 选择模型 | doubao-seedream-4-0-250828 |
| `尺寸` | ENUM | 图片尺寸 | 512x512 / 768x768 / 1024x1024 / 1536x1536 |
| `质量` | ENUM | 图片质量 | standard / hd / ultra-hd |
| `超时秒数` | INT | API 请求超时时间 | 30-600，默认120 |
| `最大重试次数` | INT | 失败后重试次数 | 0-10，默认3 |
| `并发请求数` | INT | 一次生成的图片数量 | 1-10，默认1 |
| `启用分行提示词` | BOOLEAN | 是否按行拆分提示词 | 默认False |
| `详细日志` | BOOLEAN | 是否显示详细调试信息 | 默认False |
| `参考图片1-4` | IMAGE | 可选输入图片 | 用于图生图/多图融合 |

**功能模式**：
1. **文生图**：只填提示词，不提供输入图片
2. **图生图**：提供 1 张输入图片
3. **图生组图**：提供 1 张输入图片，设置并发请求数 > 1 生成多张相关图片
4. **多图融合**：提供 2-4 张输入图片
5. **批量生成**：启用分行提示词，每行独立处理

**使用示例**：
```
Doubao Seedream
  ├─ 提示词: "一只可爱的猫咪，卡通风格"
  ├─ 模型: doubao-seedream-4-0-250828
  ├─ 尺寸: 1024x1024
  ├─ 质量: hd
  ├─ 并发请求数: 2
  └─ 图片输出 ──→ SaveImage
```

**批量生成示例**：
```
Doubao Seedream
  ├─ 提示词: "一只可爱的猫咪，卡通风格
             赛博朋克风格的城市夜景
             海洋深处的神秘生物"
  ├─ 启用分行提示词: True ☑
  ├─ 并发请求数: 3
  └─ 图片输出 ──→ SaveImage (输出9张图片: 3行×3并发)
```

**图生组图示例**：
```
Load Image ──→ 参考图片1
                 ↓
Doubao Seedream
  ├─ 提示词: "根据这张图片生成变体"
  ├─ 并发请求数: 4
  ├─ 参考图片1: <connected>
  └─ 图片输出 ──→ SaveImage (输出4张相关图片)
```

**多图融合示例**：
```
Load Image ──→ 图片1
Load Image ──→ 图片2
                 ↓
Doubao Seedream
  ├─ 提示词: "融合这两张图片的风格"
  ├─ image1: <connected>
  ├─ image2: <connected>
  └─ 图片输出 ──→ SaveImage
```

**重试机制说明**：
- ✅ **可调重试次数**：支持 0-10 次自定义重试次数
- ✅ **自动重试**：遇到 5xx 服务器错误自动重试
- ✅ **指数退避**：2秒、4秒、8秒递增等待
- ✅ **智能判断**：4xx 客户端错误直接失败不浪费重试
- ✅ **详细日志**：显示每次重试的详细信息

comfyui-artsmcp

comfyui-artsmcp 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

comfyui-artsmcp

comfyui-artsmcp 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README