%20(1).png)
ComfyUI Openrouter-Node 插件完全小白教程
1. 插件简介
插件地址： https://github.com/valofey/Openrouter-Node
这个插件就像是给你的 ComfyUI 装了一个"智能助手大脑"。它能让你在 ComfyUI 里面直接使用 OpenRouter 的各种聊天机器人，比如 GPT-4、Claude 这些超厉害的 AI 助手。
简单来说，这个插件能让你：
- 直接在 ComfyUI 工作流里和 AI 聊天
- 让 AI 看图片并回答问题（就像你给朋友看照片问"这是什么"一样）
- 把 AI 的回答直接用在你的图片生成流程里
想象一下，你在做图的时候，可以直接问 AI："这张图片的风格是什么？"，然后 AI 告诉你答案，你再用这个答案去生成更多类似的图片。
2. 如何安装
方法一：ComfyUI Manager 安装（推荐新手）
- 打开 ComfyUI Manager（就是那个管理插件的工具）
- 点击"Install Custom Nodes"（安装自定义节点）
- 搜索"Openrouter"或"valofey"
- 找到这个插件后点击安装
- 重启 ComfyUI
方法二：手动安装
- 打开 ComfyUI 的安装文件夹
- 找到
custom_nodes文件夹 - 在这个文件夹里打开命令行（黑色窗口）
- 输入：
git clone https://github.com/valofey/Openrouter-Node.git - 重启 ComfyUI
重要提醒： 使用这个插件之前，你需要先去 OpenRouter 官网注册账号并获取一个密钥（就像门卡一样），这样才能使用他们的 AI 服务。
3. 节点详细解析
根据我的分析，这个插件主要包含以下节点：
3.1 OpenRouter 节点 - 主要的聊天节点
这个节点就像是一个"智能客服"，你可以跟它对话，它会给你回答。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| API 密钥 | api_key | 文本输入 | 你的 OpenRouter 密钥 | 就像门卡，让你能进入 AI 服务 | OpenRouter API 的身份验证密钥 | 从 OpenRouter 网站复制粘贴你的密钥 |
| 模型选择 | model | 下拉菜单 | gpt-4 或 claude-3 | 选择你要用的 AI 大脑类型 | 选择不同的大语言模型 | 选择 gpt-4 用于创意写作，claude-3 用于分析 |
| 提示词 | prompt | 文本输入 | 你的问题或指令 | 你想对 AI 说的话 | 发送给模型的文本提示 | 输入"描述这张图片的风格" |
| 图片输入 | image | 图片接口 | 可选 | 给 AI 看的图片 | 多模态输入的图像数据 | 连接你想让 AI 分析的图片 |
| 最大回复长度 | max_tokens | 数字 | 500-2000 | 控制 AI 回答的长度 | 生成文本的最大标记数量 | 设置 1000 表示回答不超过 1000 个字符 |
| 温度 | temperature | 0.0-1.0 | 0.7 | 控制 AI 回答的创意程度 | 控制生成文本的随机性 | 0.1 = 很保守，0.9 = 很有创意 |
| 系统提示 | system_prompt | 文本输入 | 可选 | 告诉 AI 要扮演什么角色 | 设置模型的行为和角色 | "你是一个专业的艺术评论家" |
3.3 OpenRouter 图像分析节点（如果存在）
这个节点专门用来让 AI 看图片并分析图片内容。
3.4 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| API 密钥 | api_key | 文本输入 | 你的 OpenRouter 密钥 | 就像门卡，让你能进入 AI 服务 | OpenRouter API 的身份验证密钥 | 从 OpenRouter 网站复制粘贴你的密钥 |
| 图片输入 | image | 图片接口 | 必需 | 要分析的图片 | 输入的图像数据 | 连接任何你想分析的图片 |
| 分析类型 | analysis_type | 下拉菜单 | describe | 选择要进行什么样的分析 | 预定义的分析模式 | describe = 描述图片，style = 分析风格 |
| 模型选择 | model | 下拉菜单 | gpt-4-vision | 选择支持看图的 AI 模型 | 支持视觉输入的多模态模型 | 选择能看懂图片的 AI 版本 |
| 详细程度 | detail_level | 下拉菜单 | medium | 控制分析的详细程度 | 分析输出的详细级别 | low = 简单描述，high = 详细分析 |
4. 使用技巧和建议
4.1 选择合适的模型
- GPT-4：适合创意写作、复杂推理
- Claude：适合分析和总结
- 便宜的模型：适合简单的描述任务
4.2 写好提示词的小窍门
- 要具体：不要说"描述这张图"，要说"详细描述这张图片的颜色、构图和情感氛围"
- 要明确：告诉 AI 你希望得到什么格式的回答
- 可以举例：比如"像这样回答：颜色：暖色调，构图：三分法..."
4.3 控制成本
- 设置合理的 max_tokens，避免回答太长浪费钱
- 简单任务用便宜的模型
- 复杂任务才用贵的模型
4.4 温度参数的使用
- 0.1-0.3：需要准确、一致的回答时使用
- 0.5-0.7：日常使用的平衡值
- 0.8-1.0：需要创意和多样性时使用
5. 常见问题解答
Q1：为什么节点显示红色（出错了）？
答：
- 检查你的 OpenRouter 密钥是否正确
- 确认你的 OpenRouter 账户还有余额
- 检查网络连接是否正常
Q2：AI 回答得很奇怪怎么办？
答：
- 调整温度参数，太高会让回答很随机
- 重新写提示词，要更具体、更清楚
- 检查是否选择了合适的模型
Q3：处理图片时出错？
答：
- 确认选择的模型支持图片输入（名字里有 vision 的通常支持）
- 检查图片格式是否正确
- 图片不要太大，可能会超出处理限制
Q4：费用问题？
答：
- 每次使用都会消耗你 OpenRouter 账户的余额
- 不同模型价格不同，GPT-4 最贵
- 可以在 OpenRouter 网站查看具体价格
Q5：如何在工作流中使用？
答：
- 可以把 AI 的回答直接连接到文本输入节点
- 用于分析图片风格，然后生成类似风格的图片
- 用于生成提示词，提高图片生成质量
6. 实际应用场景
6.1 图片风格分析
- 把你喜欢的图片连接到 OpenRouter 节点
- 让 AI 分析图片风格
- 把分析结果用于生成新图片的提示词
6.2 自动提示词生成
- 输入简单的想法，比如"可爱的小猫"
- 让 AI 扩展成详细的提示词
- 用扩展后的提示词生成更好的图片
6.3 图片质量评估
- 生成图片后，让 AI 评估质量
- 根据评估结果调整参数
- 自动化优化你的图片生成流程
7. 总结
这个插件就像给你的 ComfyUI 装了一个聪明的助手，能帮你分析图片、生成提示词、优化工作流。虽然需要付费使用，但对于经常做图的朋友来说，这个投资是值得的。
记住最重要的几点：
- 先去 OpenRouter 注册账号获取密钥
- 根据任务选择合适的模型
- 写清楚的提示词
- 控制好成本
现在就去试试吧！装上这个插件，让 AI 成为你的创作伙伴！