%20(1).png)
ComfyUI-Runware 插件完全教程 - 云端AI绘画神器！
1. 插件简介
插件地址： https://github.com/Runware/ComfyUI-Runware
这个插件就像给你的ComfyUI装了一个"云端超级大脑"！它把所有复杂的AI计算都放到云端服务器上处理，你的电脑只需要发送指令和接收结果就行了。就像点外卖一样简单 - 你不需要自己做饭（不需要强力显卡），只要下单（发送指令）就能吃到美食（得到精美图片）！
能给你带来什么好处：
- 🚀 无需强力显卡，普通电脑也能生成高质量图片
- ☁️ 所有计算在云端完成，本地零负担
- 🎨 支持多种AI模型：Flux、SDXL、SD1.5等
- 🖼️ 丰富功能：图片生成、背景移除、图片放大、人脸一致性等
- 💰 按使用量付费，比买显卡更经济
2. 如何安装
方法一：ComfyUI Manager安装（推荐）
- 在ComfyUI界面点击"Manager"
- 搜索"Runware"
- 点击安装
- 重启ComfyUI
方法二：手动安装
- 打开你的ComfyUI安装目录
- 进入
custom_nodes文件夹 - 在这里打开命令行（终端）
- 输入以下命令：
git clone https://github.com/Runware/ComfyUI-Runware.git
- 安装依赖包：
pip install -r requirements.txt
- 重启ComfyUI
获取API密钥
- 访问 https://my.runware.ai/keys
- 注册账号并获取API密钥
- 在ComfyUI中使用"Runware API Manager"节点设置密钥
3. 节点详细解析
3.1 Runware API Manager 节点（设置管家）
这个节点就像你家的"总管家"，负责管理所有的设置和配置。就像你要用任何家电前，先要插电源、调设置一样。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| API Key | API Key | 文本字符串 | 你的密钥 | 这是你的"身份证"，告诉云端服务器你是谁 | Runware服务的身份验证密钥 | 从官网获取后粘贴到这里 |
| Max Timeout | Max Timeout | 5-99秒 | 90 | 等待云端回应的最长时间，就像外卖最多等多久 | API请求超时时间设置 | 网络慢的话可以调到90秒 |
| Image Output Quality | Image Output Quality | 20-99 | 85 | 图片压缩质量，就像调节照片清晰度 | 输出图像的压缩质量设置 | 85是质量和文件大小的平衡点 |
| Image Output Format | Image Output Format | WEBP/PNG/JPEG | WEBP | 图片保存格式，就像选择文件类型 | 图像输出格式选择 | WEBP文件小质量好，PNG无损但大 |
| Enable Images Caching | Enable Images Caching | True/False | True | 是否保存图片缓存，就像浏览器缓存网页 | 图像缓存功能开关 | 开启可以加快重复操作速度 |
| Min Image Cache Size | Min Image Cache Size | 30-4096KB | 100 | 多大的图片才缓存，就像设置垃圾桶大小 | 图像缓存的最小文件大小阈值 | 太小的图不值得缓存 |
3.2 Runware Image Inference 节点（图片生成器）
这个节点就像一个"万能画师"，你告诉它要画什么，它就能画出来。就像有个超级厉害的画家朋友，你说"画个猫"，他就能画出各种风格的猫。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Model | Model | RUNWAREMODEL类型 | - | 选择哪个AI画师来画画，就像选择不同风格的画家 | 连接的AI模型对象 | 从Model Search节点连过来 |
| positivePrompt | positivePrompt | 文本字符串 | "a cute cat" | 告诉AI要画什么，就像给画家下订单 | 正向提示词，指导图像生成内容 | "一只可爱的小猫在花园里玩耍" |
| negativePrompt | negativePrompt | 文本字符串 | "blurry, ugly" | 告诉AI不要画什么，就像说"别画得太丑" | 负向提示词，避免不想要的内容 | "模糊的，丑陋的，变形的" |
| Multi Inference Mode | Multi Inference Mode | True/False | False | 是否只准备不执行，就像先列菜单不下单 | 多任务推理模式开关 | 配合Multi Inference节点使用 |
| Prompt Weighting | Prompt Weighting | Disabled/sdEmbeds/Compel | Disabled | 调节描述词的重要程度，就像调音量大小 | 提示词权重控制方式 | 想强调某些词时开启 |
| dimensions | dimensions | 预设尺寸选项 | Square (512x512) | 选择图片大小，就像选择画布尺寸 | 图像尺寸预设选项 | 手机壁纸选9:16，电脑壁纸选16:9 |
| width | width | 128-2048像素 | 512 | 图片宽度，就像画布的宽 | 图像宽度像素值 | 必须是64的倍数 |
| height | height | 128-2048像素 | 512 | 图片高度，就像画布的高 | 图像高度像素值 | 必须是64的倍数 |
| steps | steps | 1-100 | 4 | AI画画的步骤数，就像画家修改的次数 | 扩散模型的迭代步数 | 步数越多越精细但越慢 |
| scheduler | scheduler | 多种选项 | Default | 选择AI的画画方式，就像选择画画技法 | 采样调度器类型 | 一般用默认就行 |
| cfgScale | cfgScale | 1.0-30.0 | 6.5 | AI听话程度，就像调节画家的创意自由度 | 分类器自由引导强度 | 数值越高越听话，越低越有创意 |
| seed | seed | 随机数 | 随机 | 随机种子，就像掷骰子的结果 | 随机数种子，控制生成的随机性 | 相同种子会生成相似图片 |
| clipSkip | clipSkip | 0-2 | 0 | 跳过某些理解步骤，就像快速阅读 | CLIP层跳过设置 | 一般保持0 |
| strength | strength | 0.0-1.0 | 0.8 | 参考图片的影响力，就像临摹时看原图的程度 | 图像到图像转换强度 | 数值越高变化越大 |
| Mask Margin | Mask Margin | True/False | False | 是否扩大遮罩范围，就像画画时留白边 | 遮罩边缘扩展开关 | 修图时开启效果更自然 |
| maskMargin | maskMargin | 32-128像素 | 32 | 遮罩扩大的像素数，就像白边的宽度 | 遮罩边缘扩展像素数 | 数值越大融合越自然 |
| batchSize | batchSize | 1-10 | 1 | 一次生成几张图，就像一次订几份外卖 | 批量生成图像数量 | 需要多张变化时增加 |
3.3 Runware Background Removal 节点（背景橡皮擦）
这个节点就像一个"魔法橡皮擦"，能把图片背景完全擦掉，只留下主体。就像用PS的魔棒工具，但比人工抠图快100倍！
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Image | Image | IMAGE类型 | - | 要去背景的图片，就像要处理的照片 | 输入的图像数据 | 连接Load Image节点 |
| Model | Model | 多种模型选项 | RemBG 1.4 | 选择去背景的AI工具，就像选择不同的橡皮擦 | 背景移除模型选择 | RemBG 1.4适合大部分情况 |
| Post Process Mask | Post Process Mask | True/False | False | 是否进一步优化边缘，就像用细橡皮擦修边 | 遮罩后处理开关 | 边缘不够干净时开启 |
| Return Only Mask | Return Only Mask | True/False | False | 是否只要遮罩不要图片，就像只要模板 | 仅返回遮罩开关 | 需要遮罩做其他用途时开启 |
| Alpha Matting | Alpha Matting | True/False | False | 高级边缘处理，就像专业修图师的手法 | Alpha抠图算法开关 | 处理复杂边缘时开启 |
| Alpha Matting Foreground Threshold | Alpha Matting Foreground Threshold | 1-255 | 240 | 前景识别敏感度，就像调节识别主体的严格程度 | 前景阈值设置 | 数值越高越严格 |
| Alpha Matting Background Threshold | Alpha Matting Background Threshold | 1-255 | 10 | 背景识别敏感度，就像调节识别背景的严格程度 | 背景阈值设置 | 数值越低越严格 |
| Alpha Matting Erode Size | Alpha Matting Erode Size | 1-255 | 10 | 边缘腐蚀大小，就像橡皮擦的粗细 | 边缘腐蚀像素大小 | 数值越大边缘越平滑 |
3.4 Runware Image Upscaler 节点（图片放大镜）
这个节点就像一个"超级放大镜"，能把小图片放大而不失真。就像CSI电影里那样，模糊的监控录像也能放大看清细节！
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Image | Image | IMAGE类型 | - | 要放大的图片，就像要用放大镜看的照片 | 输入的图像数据 | 连接任何图片输出 |
| upscaleFactor | upscaleFactor | 2-4 | 2 | 放大倍数，就像放大镜的倍率 | 图像放大倍数 | 2倍够用，4倍文件会很大 |
3.5 Runware Model Search 节点（模型商店）
这个节点就像一个"AI模型商店"，你可以在这里挑选不同的AI画师。每个模型都有自己的特长，就像有的画师擅长画人物，有的擅长画风景。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Model Search | Model Search | 文本字符串 | "Juggernaut" | 搜索模型名称，就像在商店里找特定商品 | 模型搜索关键词 | 输入模型名称或代码 |
| Model Architecture | Model Architecture | 多种架构选项 | All | 选择模型类型，就像选择画师的流派 | AI模型架构筛选 | FLUX最新，SDXL平衡，SD1.5经典 |
| ModelType | ModelType | Base Model/Inpainting Model | Base Model | 选择模型用途，就像选择画师的专长 | 模型类型筛选 | 一般图片用Base，修图用Inpainting |
| ModelList | ModelList | 模型列表 | Flux Schnell | 从搜索结果中选择，就像从商品列表中挑选 | 可用模型列表 | 根据需要选择合适的模型 |
| Use Search Value | Use Search Value | True/False | False | 是否直接使用搜索词，就像直接说商品名而不选列表 | 使用搜索值开关 | 知道确切模型代码时开启 |
4. 使用技巧和建议
4.1 新手推荐设置
- 首先设置API Manager：输入密钥，其他保持默认
- 选择模型：新手推荐Flux Schnell（快速）
- 图片尺寸：先用512x512测试，满意后再用大尺寸
- 提示词：用简单英文，如"a cat in garden"
4.2 成本控制建议
- 测试阶段：使用小尺寸和少步数
- 批量生成：确定参数后再批量处理
- 缓存利用：开启图片缓存减少重复计算
- 模型选择：Flux Schnell最便宜，Flux Dev质量更好
4.3 质量优化技巧
- 提示词优化：详细描述想要的效果
- 负面提示词：添加不想要的元素
- CFG Scale调节：6-8之间效果最好
- 步数设置：4-8步通常够用
5. 常见问题解答
Q1: 为什么提示"API Key无效"？
A: 检查以下几点：
- 确保从官网正确复制了密钥
- 检查账户是否有余额
- 确认密钥没有过期
Q2: 生成图片很慢怎么办？
A: 可能的原因和解决方案：
- 网络问题：检查网络连接
- 服务器繁忙：稍后重试
- 参数设置：减少步数和尺寸
Q3: 如何节省使用成本？
A: 省钱小技巧：
- 先用小图测试参数
- 开启图片缓存
- 选择合适的模型
- 避免不必要的高分辨率
Q4: 生成的图片不满意怎么办？
A: 优化建议：
- 调整提示词描述
- 修改CFG Scale值
- 尝试不同的模型
- 增加负面提示词
6. 总结
ComfyUI-Runware插件就像给你的电脑装了一个"云端超级大脑"，让普通电脑也能享受高端AI绘画的乐趣。无论是新手还是专业用户，都能通过这个插件轻松创作出精美的图片。
核心优势：
- 无需高端硬件，人人都能用
- 丰富的功能和模型选择
- 按需付费，经济实惠
- 简单易用，上手快速
现在就去注册账号，开始你的云端AI绘画之旅吧！🎨✨