ComfyUI

​

概述

​

使用前准备

​

获取 EvoLink API Key

1. 登录 EvoLink 控制台
2. 进入 API Keys 管理页，点击”创建新 Key”并复制（以 sk- 开头）

​

确认账户有余额

​

第一步：安装 EvoLink 官方插件

• 方式 A：ComfyUI 官方 Desktop
• 方式 B：秋叶整合包
• 方式 C：git 安装
• 方式 D：下载 ZIP

1. 打开 ComfyUI Desktop → 点击顶部工具栏的 Manager → 打开节点管理器
2. 搜索 evolink → 选择 Created By 为 evolink 的 EvoLink → 点 Install
3. 按提示重启 ComfyUI

已上架 ComfyUI 官方 Registry（registry.comfy.org/nodes/evolink-nodes），Desktop / 浏览器版 / 秋叶包内置的 Manager 均可直接搜到。

1. 绘世启动器「一键启动」后，在浏览器打开的 ComfyUI 里点顶部工具栏 Manager → Custom Nodes Manager（自定义节点管理）

2. 搜索框输入 evolink → 找到 Author 为 evolink 的 EvoLink → 点 Install

3. Action 列变为 Restart Required 即安装成功 → 绘世启动器「终止进程」再「一键启动」→ 刷新浏览器

安装过程若弹出 Neither 'pip' nor 'uv' are available for package management 报错，可以忽略：本插件唯一依赖 requests，秋叶包环境已自带，不影响任何功能。只要 Action 列显示 Restart Required，就说明安装已成功。

在 ComfyUI/custom_nodes 目录下执行：

git clone https://github.com/deeplearning-goethe/comfyui-evolink.git

秋叶整合包用户：custom_nodes 在你的 ComfyUI-aki-vX.X 安装文件夹里；可以用秋叶启动器的终端，或在该目录打开 PowerShell 执行上面命令。

1. 打开 插件页面 → 绿色 Code 按钮 → Download ZIP，解压
2. 把解压出的文件夹放进 ComfyUI/custom_nodes/
3. 防嵌套检查（必做）：打开 custom_nodes/comfyui-evolink/，应直接看到 __init__.py；如果看到的是又一层同名文件夹（ZIP 解压常见问题），把内层文件夹移出来放到 custom_nodes 下，删掉外面的空壳

正确结构示例：

ComfyUI-aki-v3.7\
  └─ custom_nodes\
       ├─ ComfyUI-Manager\
       └─ comfyui-evolink\
            ├─ __init__.py
            └─ ...其他文件

方式 A / B 点 Install 报错 only custom nodes from the default channel can be installed？点开看解决方法

出现这个报错，是因为插件版本正在 ComfyUI 官方仓库做安全复核（云 API 类节点的常见流程），期间 Manager 的默认安全级别会拦截安装。可以临时调整 Manager 安全级别解决，装完再改回来：第 1 步：完全关闭 ComfyUI

• 秋叶整合包：绘世启动器 → 终止进程
• 官方 Desktop / 便携版 / 手动安装：完全退出应用，包括黑色控制台窗口

第 2 步：修改 Manager 配置文件 config.ini按你的安装方式找到文件（找不到就在 ComfyUI 安装文件夹里搜索 config.ini，选路径里带 manager 字样的那一个）：

环境	config.ini 位置
秋叶整合包	你的下载路径\ComfyUI-aki-vX.X\ComfyUI-aki-vX.X\ComfyUI\user\__manager\config.ini
官方版（Desktop / 便携 / 手动）	ComfyUI 安装目录\user\default\ComfyUI-Manager\config.ini

用记事本打开，找到 security_level 这一行，把 normal 改成 weak：

security_level = weak

保存并关闭。

第 3 步：重启 ComfyUI，重新安装启动 ComfyUI → Manager → 搜 evolink → Install。这次会开始下载；若弹 Neither 'pip' nor 'uv'... 报错按上文说明忽略。看到 Restart Required 后再完全重启一次并刷新浏览器。第 4 步：验证并恢复安全级别

• 按下方「验证安装是否成功」确认节点已加载
• ⚠️ 装完后建议把 security_level 改回 normal（按第 1、2 步再操作一次），恢复 Manager 的默认安全防护

​

验证安装是否成功

​

第二步：生成第一张图（文生图，5 分钟）

1. 在画布空白处双击（或右键 → Add Node）→ 搜索 EvoLink → 添加 EvoLink GPT Image 2 (Official) 节点（上一步验证时已见过）
2. 填写参数：
   • api_key：粘贴你的 sk- Key。只需填这一次——首次运行后自动保存到本机配置文件，之后这个框留空即可（分享工作流前请确认已清空）
   • prompt：画面描述，支持中文，例如 一只戴红色围巾的柴犬坐在雪地里，扁平插画风格
   • 其余参数保持默认（quality=low 最省钱，适合调试）
3. 连接显示节点（必做）：鼠标按住节点右侧的 image 输出圆点，拖一条线到空白处松开，在弹出菜单里选 预览图像（Preview Image）；想把图存到本地就再连一个 保存图像（Save Image）（图片会写入 ComfyUI 的 output 文件夹）

4. 点右上角 运行（Queue Prompt）。节点自动完成”提交任务 → 轮询进度 → 取回图片”，进度条实时显示，结果直接显示在预览节点里（如上图）。

​

第三步：图生图（3 步搞定）

1. 添加 加载图像（Load Image） 节点，选择你的本地图片
2. 把它的图像输出连到 EvoLink 节点的 image1 口
3. prompt 里写修改要求 → 运行

• 多参考图：image1～image4 四个口都可以接图，还可以在 image_urls 文本框里每行贴一个公网图片 URL，两种方式可混用，合计最多 16 张
• 组装复杂工作流：插件另附 EvoLink Upload Image (Official) 节点，可把本地图批量换成 URL 文本输出（普通图生图用不到它）
• 现成工作流：example_workflows 提供文生图 / 图生图 / 多参考图三个示例。每个示例的 PNG 效果图内嵌了完整工作流——下载图片直接拖进画布即可还原全部节点和连线（ComfyUI 原生能力）；也可以用同名 JSON 文件导入

​

参数详解

​

计费与自查

• 按用量计费，无订阅：提交任务时预扣（credits_reserved），完成后按实际结算
• 失败 / 超时任务不扣费，积分自动退回
• 缓存不扣费：参数不变重复运行是 ComfyUI 本地缓存复用，不发起新请求
• 每一笔可查：任务日志页 按 task_id（节点的输出之一）查看状态与扣费；对某笔扣费有疑问，把 task_id 发给客服即可核查

​

常见问题

​

附录：不装插件，直接调用 API

curl.exe -s -H "Authorization: Bearer sk-你的Key" https://api.evolink.ai/v1/models

curl.exe -s -X POST https://api.evolink.ai/v1/images/generations -H "Authorization: Bearer sk-你的Key" -H "Content-Type: application/json" -d "{\"model\":\"gpt-image-2\",\"prompt\":\"a cute cat, watercolor style\",\"size\":\"1:1\",\"resolution\":\"1K\",\"quality\":\"low\",\"n\":1}"

curl.exe -s -H "Authorization: Bearer sk-你的Key" https://api.evolink.ai/v1/tasks/任务ID