publisher/comfyui_o1key
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3a05bb627748fcb6940f6c467993c78430e41d4f
comfyui_o1key/README.md
T

5.9 KiB
Raw Blame History

Comfyui_o1key

通过 api.o1key.com 调用 AI 模型的 ComfyUI 自定义节点集合。

功能特性

  • 🎨 文生图 / 图生图
  • 🔄 批量并发生成（最多 1000 张）
  • 📐 10 种宽高比
  • 🎯 3 种分辨率（1K / 2K / 4K）
  • 🌱 可控随机种子

📦 安装

通过公开 Gitea 仓库安装（无需登录）

cd ComfyUI/custom_nodes
git clone https://git.o1key.com/publisher/comfyui_o1key.git
cd comfyui_o1key
python -m pip install -r requirements.txt

请在 ComfyUI 使用的 Python 环境中运行安装命令，然后重启 ComfyUI。之后可直接使用左侧功能栏的「更新」按钮。

已通过 GitHub 安装的用户

在节点包目录中把更新地址切换到 Gitea，即可继续保留现有安装和本地配置：

cd ComfyUI/custom_nodes/comfyui_o1key
git remote set-url origin https://git.o1key.com/publisher/comfyui_o1key.git
git pull --ff-only origin main

仓库公开读取，无需为用户配置 Gitea 账号或令牌。

⚙️ 配置

获取 API 密钥

  1. 访问 vip.o1key.com
  2. 注册并获取 API 密钥

配置方式

配置 API 密钥（必需）

方法一：快捷脚本配置（最简单）⭐

我们提供了一键配置脚本，自动创建配置文件：

Windows 用户： 双击运行 设置API密钥(win).bat，按提示输入 API 密钥即可。

Linux/Mac 用户：

# 添加执行权限（仅首次需要）
chmod +x 设置API密钥(mac).sh

# 运行配置脚本
./设置API密钥(mac).sh

按提示输入 API 密钥，配置完成后重启 ComfyUI。

方法二：环境变量（推荐）

Windows 用户：

  1. 右键 "此电脑" → 属性 → 高级系统设置 → 环境变量
  2. 在"用户变量"中新建：
    • 变量名：O1KEY_API_KEY
    • 变量值：你的 API 密钥
  3. 重启 ComfyUI

Linux/Mac 用户：

在 ~/.bashrc 或 ~/.zshrc 中添加：

export O1KEY_API_KEY="你的API密钥"

然后执行 source ~/.bashrc 并重启 ComfyUI。

方法三：手动创建配置文件

在插件目录下创建 .config 文件（参考 .config.example）：

O1KEY_API_KEY=你的API密钥

⚠️ 安全提示

.config 文件包含敏感信息，已添加到 .gitignore 中，不会被提交到版本控制。 请妥善保管你的 API 密钥，不要分享给他人。

配置 API 地址（可选）

默认使用 https://vip.o1key.com，通常无需修改。

如需自定义 API 地址，可通过以下方式：

  1. 环境变量（推荐）：

    # Windows
set O1KEY_API_BASE_URL=https://your-api-domain.com

# Linux/Mac
export O1KEY_API_BASE_URL=https://your-api-domain.com

  2. 配置文件：在 .config 中添加：

    O1KEY_API_BASE_URL=https://your-api-domain.com

  3. 修改默认值：编辑 utils/config.py 中的 DEFAULT_API_BASE_URL 常量

🔄 更新插件

界面更新

在本机 ComfyUI 左侧功能栏点击「更新」（位于「重启」下方）。按钮会从当前 Git 仓库的 origin/main 拉取最新版本；依赖列表有变化时，会在 ComfyUI 当前 Python 环境中自动安装。完成后点击「重启」使新版本生效。

界面更新需要通过 Git 安装、处于 main 分支，且节点包文件没有本地修改。更新仅允许快进，不会覆盖本地修改或删除配置。ZIP 安装、分支分叉或网络连接失败时，界面会显示原因，需要手动处理。 为了防止其他网站或局域网设备触发本机的软件管理操作，「更新」和「重启」按钮只能在本机打开的 ComfyUI 页面使用。

手动更新

cd ComfyUI/custom_nodes/comfyui_o1key
git pull --ff-only origin main
python -m pip install -r requirements.txt

更新保留环境变量中配置的 API 密钥。启动时仍会检查是否有新版本。

📚 节点说明

Nano Banana Pro

高性能图像生成节点，支持文生图和图生图。

参数：

  • 提示词：描述你想生成的图像
  • 模型：选择使用的 AI 模型
  • 分辨率：1K / 2K / 4K
  • 宽高比：1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21, 3:2, 2:3, 16:10
  • 批次大小：单次生成的图像数量（1-1000）
  • 随机种子：控制生成的随机性（-1 为随机）
  • 输入图像（可选）：用于图生图模式

Batch Nano Banana Pro

批量并发生成节点，适合大量图像生成。

Google Gemini

Google Gemini 模型节点，支持更多模型选择。

📝 更新日志

查看 CHANGELOG.md 了解详细的版本更新记录。

📄 许可证

本项目采用 Apache License 2.0 许可证。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

⚠️ 开发者注意事项

维护者：发布流程

git.o1key.com 是插件的公开发布仓库，用户的「更新」按钮从安装目录的 origin/main 获取版本。开发电脑首次切换发布地址并同步服务器已有更新：

git remote set-url origin https://git.o1key.com/publisher/comfyui_o1key.git
git pull --ff-only origin main

每次发布：

git push origin main

推送需要发布者的 Gitea 凭据；普通用户匿名拉取和界面更新无需登录。

文件编码要求

所有文本文件必须使用 UTF-8 编码（无 BOM）！

如果你在仓库网页上看到中文乱码，说明文件编码有问题。请使用以下方法修复：

Windows 用户：

.\fix_encoding.ps1

Linux/Mac 用户：

chmod +x fix_encoding.sh
./fix_encoding.sh

详细说明请查看 编码修复指南.md

📮 联系方式

当前版本：v1.10.1

Reference in New Issue View Git Blame Copy Permalink