nodes/Semonxue-Comfyui-flexai
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
dev
Semonxue-Comfyui-flexai/README-zh.md
T

6.5 KiB
Raw Permalink Blame History

English | 中文 / Chinese

ComfyUI FlexAI 插件

版本 许可

现代化的统一 ComfyUI 插件，支持 OpenAI 兼容 API，具备增强调试功能和双模式图像处理能力。

写这个插件主要为了简化自己的工作，通过标准化的openai接口就可是接入llm或图片生成，最近用这个节点主要在玩 gemini-2.5-flash-image 的生成（没测过gemini官方接口，我接的是openai兼容端点），效果还不错。

最近更新

  • 2025-11-21 1.0.7 支持新模型与尺寸比例：为图像节点添加了对 nano-banana、nano-banana-pro 等模型的支持，并允许在非兼容模式下使用宽高比设置尺寸。
  • 2025-9-13 1.0.6 图片节点接收图像uri内容时支持jpg类型，以支持部分seedream4的接口请求。
  • 2025-9-3 1.0.5 新增模型记忆功能：为图像和文本节点提供独立的模型记忆功能，并对代码结构进行了重构优化。
  • 2025-9-3 1.0.4 实现多图返回：图像节点现在可以一次性处理和输出多张图片，并解决了在此过程中出现的尺寸不匹配和数据类型错误。
  • 2025-9-3 1.0.3 修复了流式响应处理中的一个错误，并改进了调试日志记录。
  • 2025-9-3 1.0.2 加入对openrouter的支持（支持流式），debug信息单独合并到debug.log
  • 2025-9-2 1.0.1 优化debug模式下的出错提示，加入对openrouter上的免费模型的支持
  • 2025-9-2 1.0发布,亲测接入tuzi和GB一点没毛病
  • 2025-8-31 插件初始化

✨ 核心特性

🌐 多API来源支持

  • 灵活配置：通过 .env 文件支持多个 API 提供商，这样如果有多个token的渠道就不用切来切去了，可以共用。
  • 动态切换：无需重启 ComfyUI 即可切换提供商
  • 模型记忆与管理: 可通过下拉菜单选择常用模型，或在 custom_model 输入框中填入新模型，运行一次后即可自动保存并供未来选用。

🖼️ OpenAI 图片节点 (flexai:openai_image)

双模式运行：

  • 编辑模式：提供 1-4 张图片 → 使用 images.edit API ，即 /v1/images/edits 接口
  • 生成模式：无图片输入 → 使用 images.generate API，即 /v1/images/generations 接口

兼容模式：通过chat端点实现图像生成，兼容OpenRouter等第三方Openai兼容接口，流式支持,即常规的 /v1/chat/completions 接口

模型支持扩展：

  • 目前接口已支持 nano-banana、nano-banana-pro 等新模型。
  • 您可以通过 custom_model 字段直接调用，例如，在使用 api.tu-zi.com 服务时，可以填入 gemini-3-pro-image-preview 来使用。
  • 这些模型同时支持标准的生图模式和兼容模式。

💬 OpenAI 文本节点 (flexai:openai_text)

多模态支持：

  • 纯文本模式：标准文本生成
  • 视觉模式：支持图片输入进行视觉问答
  • 混合模式：文本+图片结合分析

多模态文本生成：

  • 纯文本或视觉语言理解
  • 支持 1-4 张参考图片，自动缩放
  • 流式和非流式模式
  • 调试模式：所有操作的完整 JSON 日志记录

快速开始

安装

  1. 克隆到 ComfyUI 自定义节点目录：

    cd ComfyUI/custom_nodes
git clone https://github.com/Semonxue/Comfyui-flexai.git

  2. 安装依赖：

    cd Comfyui-flexai
pip install -r requirements.txt

  3. 配置提供商（见配置章节）

  4. 重启 ComfyUI

配置

在插件根目录创建 .env 文件,或复制 .env.example 文件并重命名。

单一提供商

OPENAI_API_KEY=your_openai_api_key_here
OPENAI_API_BASE=https://api.openai.com/v1  # 可选

多提供商（推荐）

# 定义提供商列表
OPENAI_PROVIDERS=openai,anthropic,custom

# OpenAI
OPENAI_API_KEY_openai=sk-your-openai-key
OPENAI_API_BASE_openai=https://api.openai.com/v1

# Anthropic（通过 OpenAI 兼容端点）
OPENAI_API_KEY_anthropic=sk-your-anthropic-key  
OPENAI_API_BASE_anthropic=https://api.anthropic.com/v1

# 自定义端点
OPENAI_API_KEY_custom=your-custom-key
OPENAI_API_BASE_custom=https://your-api.example.com/v1

节点参数

图片节点 (flexai:openai_image)

参数 类型 描述
provider 选择 API 提供商选择
model 字符串 模型名称 (如 dall-e-3, dall-e-2)
prompt 字符串 生成/编辑提示词
image_1-4 图片 可选图片（提供任意张则进入编辑模式）
size 字符串 输出尺寸 (如 1024x1024)

宽高比支持：对于 nano-banana 和 nano-banana-pro 等特定模型，在非兼容模式下，此字段可以直接输入宽高比。支持的比例与对应的分辨率如下：
1x1 → 1024x1024
2x3 → 832x1248
3x2 → 1248x832
3x4 → 864x1184
4x3 → 1184x864
4x5 → 896x1152
5x4 → 1152x896
9x16 → 768x1344
16x9 → 1344x768
21x9 → 1536x672
compatibility_mode 布尔 兼容模式：启用后通过chat端点实现图像生成，兼容OpenRouter等第三方服务
stream 布尔 启用流式模式
debug 布尔 启用详细调试日志

文本节点 (flexai:openai_text)

参数 类型 描述
provider 选择 API 提供商选择
model 字符串 模型名称 (如 gpt-4o, gpt-3.5-turbo)
system_prompt 字符串 系统消息
user_prompt 字符串 用户消息
image_1-4 图片 可选参考图片
max_tokens 整数 最大响应令牌数
temperature 浮点 采样温度 (0.0-1.0)
stream 布尔 启用流式模式
debug 布尔 启用详细调试日志

示例工作流

产品放置 (Product Placement)

产品放置工作流缩略图 下载工作流

手办换装 (Figure Redress)

手办换装工作流缩略图 下载工作流

为 ComfyUI 社区用 ❤️ 构建

Reference in New Issue View Git Blame Copy Permalink