Hhhapi

通用 ComfyUI API 节点包,当前包含文本 API 与柏拉图图片 API 两部分:

• OpenAI Chat Completions 兼容文本模型
• 供应商和模型配置持久化
• 供应商级 API Key 保存与前端掩码
• 服务商、接口地址、模型的新增、修改、删除
• 独立前端管理面板
• MiniMax 图片理解通道
• 思考链独立输出
• 繁忙错误自动重试(最多 3 次)
• 柏拉图图片平台独立管理面板
• 柏拉图 GPT-Image 专用生图节点
• 柏拉图 Nano 专用生图节点

仓库地址:

• GitHub

• Hhh 文本API
• Hhh 文本API服务商管理
• Hhh 柏拉图图片API管理
• Hhh 柏拉图 GPT-Image
• Hhh 柏拉图 Nano

将仓库克隆到 ComfyUI 的 custom_nodes 目录:

git clone https://github.com/Hhh2178/comfyui-Hhhapi.git

如果你的 ComfyUI Python 环境没有安装依赖,再执行:

pip install -r requirements.txt

当前仓库已经补齐面向 Registry/Manager 的元信息。
如果后续提交到 ComfyUI Manager 列表或发布到 Comfy Registry,就可以直接在 Manager 中检索安装。

1. 刷新 ComfyUI 前端。
2. 在画布右键菜单中打开 Hhh 文本API服务商管理。
3. 新建服务商,填写服务商 ID、显示名称、接口地址、接口路径、API 密钥。
4. 在面板中新增一个或多个模型并保存。
5. 添加 Hhh 文本API。
6. 在节点顶部选择 服务商 和 模型。
7. 填写 系统提示词 和 用户提示词。
8. 运行工作流,读取 文本 输出。

Hhh 文本API 不显示 API 密钥和接口地址;这些只在 Hhh 文本API服务商管理 中维护。

柏拉图图片节点独立放在:

• Hhh / 柏拉图图片API

当前提供三个节点:

• Hhh 柏拉图图片API管理
• Hhh 柏拉图 GPT-Image
• Hhh 柏拉图 Nano

设计原则:

• 图片节点不暴露 API Key
• 文本配置与图片配置完全分离
• 文本服务商列表不会被图片节点污染
• 图片平台使用独立配置文件保存模型列表和基础地址

打开方式:

• 在 ComfyUI 画布右键菜单中选择 Hhh 柏拉图图片API管理
• 或添加 Hhh 柏拉图图片API管理 节点后点击按钮

管理面板支持:

• 设置柏拉图基础地址
• 保存柏拉图图片 API Key
• 维护 GPT 模型列表
• 维护 Nano 模型列表

适用于柏拉图平台中的 gpt-image-* 系列模型。

当前参数:

说明:

• 不再暴露"像素尺寸"控件,避免与比例选择冲突。
• 画幅比例=9:16 等场景会自动映射到对应尺寸,而不是固定退回 1:1。
• 节点输出是 IMAGE batch,多图返回时不会只保留第一张。

适用于柏拉图平台中的 nano-banana / nano-banana-pro / nano-banana-2 等模型。

当前参数:

说明:

• Nano 节点和 GPT 节点共用同一份柏拉图图片平台密钥。
• 但它们的模型列表与参数模板是分开的。

输出:

节点右上角会显示当前实际调用通道:

• 文本通道
• 视觉文本通道
• MiniMax识图通道

文本节点当前策略:

• 仅当主模型返回空文本类结果时,才会切到备用服务商 / 备用模型。
• 如果主模型和备用模型最终都没有返回文本,节点会直接报错,避免静默输出空字符串。

图片节点当前策略:

• 仅当主模型返回空图时,才会切到备用模型。
• 如果最终仍然没有图像返回,节点会输出空 IMAGE batch 并继续工作流,不再用 blocker 中断整条任务。

推荐使用真正的管理面板,不再通过节点手填 JSON。

打开方式:

• 在 ComfyUI 画布右键菜单中选择 Hhh 文本API服务商管理
• 或在设置里点击 Hhh 文本API服务商管理

管理面板支持:

• 新建服务商
• 修改服务商名称
• 修改接口地址
• 修改接口路径
• 保存 API 密钥
• 测试连接
• 新增/删除模型
• 删除服务商

模型能力配置支持:

• 视觉
• JSON
• 思考链
• MiniMax识图

密钥只会保存到 hhhapi_secrets.json,不会写入 hhhapi_config.json。

建议:

• 服务商ID 使用英文 ID,例如 aliyun_bailian、moonshot、openai_proxy。
• 显示名称 再使用中文,例如 阿里云百炼、月之暗面。
• 接口地址 只填基础地址,例如 https://dashscope.aliyuncs.com/compatible-mode/v1。
• 接口路径 默认用 /chat/completions,只有供应商协议不同才改。

• 管理面板当前优先使用 /api/hhhapi/panel/... 独立接口,避开部分热更新环境下旧路由残留的问题。
• 文本节点前端仍使用 /api/hhhapi/v1/... 获取服务商和模型列表。
• 测试连接 会使用已保存的 API 密钥,对选中服务商和第一个模型发起一次短文本请求。

• 修复 输出为空时替代服务商 切换后,输出为空时替代模型 仍显示上一个服务商模型的问题。
• 清理 ComfyUI custom_nodes 中会重复注册 HhhapiText 的备份副本,避免旧节点和旧前端脚本混载。
• 文本节点仅在空文本输出时触发备用服务商 / 备用模型;最终仍为空时直接报错,避免静默空结果。
• 新增 hhhapi_text_fallback_fix.js 作为前端兜底刷新脚本,兼容旧字段名 失败时替代服务商 / 失败时替代模型。

MiniMax 接入时分成两类:

• 不接图片:走普通文本聊天通道
• 接入图片且模型能力包含 MiniMax识图:自动切换到 MiniMax 官方图片理解通道

这样可以避免把 MiniMax 的图片理解错误地塞进普通 OpenAI 兼容图片输入协议。

如果遇到下列繁忙类错误,节点会自动重试,最多 3 次:

• 429
• 529
• rate limit
• 服务繁忙
• 访问繁忙
• 稍后重试

• 你当前这台 ComfyUI 的 comfyui_lg_hotreload 插件正在高频热更新很多节点,并在日志中出现 dictionary changed size during iteration。
• 这会导致 Hhhapi 的 Python 路由偶尔只热加载一部分,出现前端 JS 已更新、但 /hhhapi/providers 和 /hhhapi/models 仍然跑旧逻辑的情况。
• 已通过独立面板接口和兼容接口组合方式绕过这个问题。
• 如果个别旧节点仍表现异常,通常刷新前端并重新创建节点即可恢复。

• Hhh 文本API 只负责调用文本模型,不暴露接口地址和 API 密钥。
• Hhh 文本API服务商管理 负责服务商、模型、接口地址和 API 密钥的维护。
• 文本 API 节点运行时会根据所选服务商和模型,从配置文件读取接口地址,从密钥文件读取 API Key。
• 柏拉图图片节点按平台做专用节点,不放进当前通用文本 API 节点。
• 图片节点与文本节点使用独立配置中心,但共享同一个 secrets 文件保存不同作用域的 API Key。

首次加载会自动生成:

• hhhapi_config.json
• hhhapi_image_config.json
• hhhapi_secrets.json

hhhapi_config.json 存储供应商、模型、profile。
hhhapi_image_config.json 存储柏拉图图片平台基础地址、超时和图片模型列表。
hhhapi_secrets.json 存储 API Key,不建议提交或分享。