CloserAI Agnes 节点包 · 使用手册
AGNES AI 免费 API + ComfyUI 集成 · 版本 1.0 · 2026年6月
◆ 无限免费 5 节点 MultiImageInput 新增一、概述
CloserAI Agnes 是 ComfyUI 的自定义节点包，将 AGNES AI 的免费 API（Text / Image / Video 三大模态）接入 ComfyUI 工作流。所有 Flash 模型自 2026年6月1日起无限期免费。
1. 在 platform.agnes-ai.com 注册并申请免费 API Key
2. 将节点包放入 ComfyUI
custom_nodes/closerAI_Agnes/ 目录3. 重启 ComfyUI
| 节点 | 功能 | 分类 |
|---|---|---|
| CloserAI Agnes Text | 聊天 / 文本生成 | CloserAI/AgnesAI |
| CloserAI Agnes Image | 文生图 / 图生图 | CloserAI/AgnesAI |
| CloserAI Agnes Video | 文生视频 / 图生视频 | CloserAI/AgnesAI |
| CloserAI Agnes VideoPlayer | 视频预览 + 音频提取 | CloserAI/AgnesAI |
| CloserAI Agnes MultiImageInput | 多图合批（5口输入） | CloserAI/AgnesAI |
二、CloserAI Agnes Text — 文本生成
参数说明
https://apihub.agnes-ai.com/v1
model模型选择：agnes-2.0-flash / agnes-1.5-flash
system_prompt系统提示词（可选）
temperature温度 0.0~2.0，默认 0.7
max_tokens最大 Token 数，默认 4096
seed随机种子 0~4294967295
control_random_seedfixed（固定种子） / random（随机）
proxy代理地址（可选）
输出
三、CloserAI Agnes Image — 图像生成
参数说明
输出
四、CloserAI Agnes Video — 视频生成
参数说明
{"negative_prompt":"blurry"}）
seed随机种子 0~4294967295
control_random_seedfixed / random
proxy代理地址
输出
image_url 字段。
五、CloserAI Agnes VideoPlayer — 视频播放
参数说明
输出
soundfile 库读取，没有则回退到手动 WAV 解析。
local_path 可以是本地文件路径，也可以是远程 URL（如 Video 节点输出的 video_url）。程序会自动下载到临时文件并读取，处理完自动清理。
六、CloserAI Agnes MultiImageInput — 多图合批
参数说明
输出
七、典型工作流
工作流 1: 文生图
工作流 2: 图生图（多参考图）
[LoadImage 2]
[LoadImage 3] └──→ [CloserAI Agnes MultiImageInput] ── images ──→ [CloserAI Agnes Image]
工作流 3: 文生视频 + 播放
工作流 4: 多关键帧图生视频
[LoadImage (尾帧)] └──→ [CloserAI Agnes MultiImageInput] ── images ──→ [CloserAI Agnes Video] ── video_url ──→ [CloserAI Agnes VideoPlayer]
八、常见问题
API Key 如何获取？
访问 platform.agnes-ai.com 注册账号，在控制台申请 API Key。目前 Text、Image、Video 三个 Flash 模型均免费。
图像生成报"this model does not support image input"？
您使用的模型可能不支持图生图（如 agnes-image-2.0-flash）。解决方法：
遇到此错误时：
1. 断开 image_input 连接，改为纯文生图
2. 或尝试切换到 agnes-image-2.1-flash 等支持图生图的模型
3. 如问题持续，请确认是否使用了正确 endpoint
视频生成报"Upload all services failed"？
视频 API 需要真实的图片 URL。如果自动图床全部不可用，可以手动：
1. 上传图片到 catbox.moe 等图床
2. 复制 URL 粘贴到 Video 节点的 image_url 字段
VideoPlayer 视频播放没声音？
需要系统中安装 ffmpeg。如果 ffmpeg 未安装，音频提取会跳过。
多帧输入时图片尺寸不一致？
MultiImageInput 节点会自动缩放所有图片到第一张图的尺寸。建议使用统一的输入尺寸以获得最佳效果。
num_frames 应该填多少？
帧数必须满足 8n+1（除以 8 余 1），例如 9, 17, 25, …, 81, 121, 161, 241, 441。
九、相关链接
| 资源 | 地址 |
|---|---|
| AGNES API 控制台 | platform.agnes-ai.com |
| AGNES API 概览 | agnes-ai.com/doc/overview |
| Text API 文档 | agnes-ai.com/doc/agnes-2-flash |
| Image API 文档 | agnes-ai.com/doc/agnes-image-20-flash |
| Video API 文档 | agnes-ai.com/doc/agnes-video-v20 |
CloserAI Agnes插件节点，目前根据它提供的模型的情况，开发了四个节点，使用方法就是大家在它官方网站上生成一个密钥就行：
1、文本生成节点：目前它只支持文本生成，图片和视频分析是不支持的：
它的响应速度很快。
2、图像生成节点：支持文生图、图生图。设置多图参考生成。
配合我们之前开发的nanoprmpts的案例库节点进行文生图：
生成速度方面可以：
图生图：
多图：
3、视频生成节点：支持文生视频、图生视频
文生图倒是可以随便生成，图生视频，它需要你的图要有一个URL。同时它生成的时间有点久2~3分钟左右吧。
我测试了下视频生成：
文生视频直接输入提示词选下参数生成就行
图生视频 的话：输入一个图片的URL，也就是说你需要把图片托管一下。
我这里测试随便上网找了一个图：
直接度一张，右键它的URL：
粘贴到节点中：
主题授权提示：请在后台主题设置-主题授权-激活主题的正版授权，授权购买：RiTheme官网
评论(0)