使用 ComfyUI 调用胜算云 API
一个强大的 ComfyUI 集群节点集合,提供 4 个专用节点访问 banana pro、SeeDream 4.5 等多个胜算云图像生成和处理模型。
主要特性
SSY Google Generator
支持 Gemini 2.5 Flash Image、Gemini 3 Pro Image
SSY Doubao Generator
支持 Doubao SeeDream 4.5/4.0/3.0、SeedEdit 3.0
SSY OpenAI Generator
支持 GPT Image 1
SSY Bytedance Processor
支持 Image Enhance、Image Upscale
核心能力:专用节点设计、智能参数隔离、API 密钥密文管理、精确 API 适配、灵活参数控制、批量生成、多种格式支持。
安装
方式一:ZIP 安装
下载 zip 插件节点文件,然后复制粘贴到 ComfyUI\custom_nodes 文件夹。
方式二:Git 安装
- 导航到自定义节点目录
cd ComfyUI/custom_nodes - 克隆仓库
git clone https://github.com/SSYCloud/comfyui-ssy-syncapi - 安装依赖
pip install -r requirements.txt
API 密钥配置
从 胜算云 获取 API 密钥。三种配置方式:
- 在节点中直接在
api_key参数中输入(输入时自动显示为 ***)。 - 环境变量设置
SSY_API_KEY环境变量。 - 配置文件首次使用后自动保存到
config.json。
SSY Google Generator 节点
| model | 选择 Gemini 模型 |
|---|---|
| prompt | 生成提示词(必需) |
| input_image ~ input_image11 | 输入图像(最多 12 张,可选) |
| api_key | API 密钥 |
| aspect_ratio | 图片比例(1:1、16:9 等) |
| size | 图像尺寸(1K/2K/4K,仅 gemini-3-pro 支持) |
| response_modalities | 响应模态(IMAGE 或 TEXTIMAGE) |
支持模型:google/gemini-2.5-flash-image-preview、google/gemini-3-pro-image-preview
SSY Doubao Generator 节点
| model | 选择 Doubao 模型 |
|---|---|
| prompt | 生成提示词(必需) |
| input_image ~ input_image9 | 输入图像(最多 10 张,可选) |
| size | 图片尺寸(1024x1024 等) |
| n | 生成数量(1-4) |
| quality | 图像质量(standard/hd) |
| seed | 随机种子(仅 3.0 系列支持) |
| guidance_scale | CFG 引导比例(仅 3.0 系列支持) |
| watermark | 添加 AI 生成水印 |
| response_format | 返回格式(b64json/url) |
支持模型:bytedance/doubao-seedream-4.5、bytedance/doubao-seedream-4-0、bytedance/doubao-seedream-3.0-t2i、bytedance/doubao-seededit-3-0-i2i
SSY OpenAI Generator 节点
| model | 选择 OpenAI 模型 |
|---|---|
| prompt | 生成提示词(必需) |
| size | 图像尺寸(auto、1024x1024 等) |
| n | 生成数量(1-10) |
| quality | 图像质量(auto/high/medium/low) |
| background | 背景透明度(auto/transparent/opaque) |
| output_format | 输出格式(png/jpeg/webp) |
| moderation | 内容审核级别(auto/low) |
支持模型:openai/gpt-image-1
SSY Bytedance Processor 节点
| model | 选择处理模型 |
|---|---|
| input_image | 输入图像(必需) |
| model_quality | 超分模型质量(HQ/MQ/LQ,upscale 必需) |
| resolution_boundary | 目标分辨率(144p 到 2k) |
| result_format | 输出格式(0=png, 1=jpeg) |
支持模型:bytedance/image_enhance、bytedance/image_upscale
模型能力对照表
| 节点 | 模型 | 文生图 | 图生图 | 特殊功能 |
|---|---|---|---|---|
| Gemini 2.5 Flash | ✅ | ✅ | 多模态 | |
| Gemini 3 Pro | ✅ | ✅ | 4K 输出 | |
| Doubao | SeeDream 4.5 | ✅ | ✅ | 组图功能 |
| Doubao | SeeDream 4.0 | ✅ | ✅ | 组图功能 |
| Doubao | SeeDream 3.0 T2I | ✅ | - | 种子控制 |
| Doubao | SeedEdit 3.0 I2I | - | ✅ | 种子控制 |
| OpenAI | GPT Image 1 | ✅ | - | 透明背景 |
| Processor | Image Enhance | - | - | AI 增强 |
| Processor | Image Upscale | - | - | 高清放大 |
故障排除
| "未提供 API 密钥" | 确保在任一节点中设置了 API 密钥,密钥会自动保存供所有节点共享。 |
|---|---|
| "模型需要输入图像" | 图生图模型需要连接输入图像,图像处理节点必须提供输入图像。 |
| "找不到节点" | 确保已重启 ComfyUI,检查节点分类:SSY Cloud/Google、SSY Cloud/Doubao 等。 |