4.6 KiB
4.6 KiB
ComfyUI PD Comfy API Node
ComfyUI 自定义节点套件，集成 Gemini 和 GPT 图像生成 API，支持两种认证方式。
✨ 功能特性
- 🎨 多模型支持：Gemini 2.5 Flash Image、GPT Image 1/1.5
- 🔑 双认证方式：支持 API Key 和 Auth Token 两种调用方式
- 💰 成本追踪：实时显示 API 调用成本
- 🖼️ 图像处理：支持文生图、图生图、图像编辑
- ⚙️ 灵活配置：多种宽高比、质量、分辨率选项
📦 安装方法
cd ComfyUI/custom_nodes
git clone https://github.com/7BEII/comfyui-PD_comfy-api-node.git
pip install -r comfyui-PD_comfy-api-node/requirements.txt
重启 ComfyUI 后，在节点菜单的 PD_Tools/Image_Generation 分类中找到节点。
🔑 两种认证方式
方式一：API Key（推荐）
使用 ComfyUI 官方 API Key，简单直接。
获取方法：
- 访问 ComfyUI API
- 登录并创建 API Key
- 复制 Key 并粘贴到节点中
优点：
- ✅ 官方支持，稳定可靠
- ✅ 配置简单，一个 Key 搞定
- ✅ 支持所有模型
方式二：Auth Token
使用浏览器 Auth Token，适合高级用户。
获取方法：
- 安装油猴脚本（Tampermonkey）：具体B站有教程：小熊猫pandy
- 安装 Token 抓取脚本
- 访问 ComfyUI 网站并登录
- 脚本会自动抓取 Token
- 复制 Token 并粘贴到节点中
优点：
- ✅ 无需申请 API Key
- ✅ 使用现有账号权限
- ✅ 适合测试和开发
📝 更新日志
v2.0.0 -2026.0112
- 新增 Auth Token 认证方式
- 新增 GPT Image 节点
- 优化成本计算
- 改进错误处理
v1.0.0
- 初始版本
- 支持 Gemini 图像生成
- 支持 API Key 认证
📋 节点说明
1. PD: Gemini Image (apikey)
使用 API Key 调用 Gemini 图像生成。
主要参数：
api_key：ComfyUI API Keyprompt：图像生成提示词model：模型选择（gemini-2.5-flash-image / gemini-2.5-flash-image-preview）aspect_ratio：宽高比（auto / 1:1 / 16:9 / 9:16 等）image_ref：参考图像（可选）
输出：
image：生成的图像info：成本和状态信息
2. PD: Gemini Image (comfyui_AuthToken)
使用 Auth Token 调用 Gemini 图像生成。
主要参数：
auth_token：ComfyUI Auth Tokenprompt：图像生成提示词model：模型选择aspect_ratio：宽高比resolution：分辨率（auto / 1K / 2K / 4K）image_ref：参考图像（可选）
输出：
image：生成的图像info：成本和状态信息
3. PD: GPT Image (apikey)
使用 API Key 调用 OpenAI GPT 图像生成。
主要参数：
api_key：ComfyUI API Keyprompt：图像生成提示词model：模型选择（gpt-image-1 / gpt-image-1.5）quality：质量（low / medium / high）size：尺寸（auto / 1024x1024 / 1024x1536 / 1536x1024）background：背景（auto / opaque / transparent）image：输入图像（可选，用于编辑）mask：遮罩（可选，用于局部编辑）
输出：
image：生成的图像info：成本和状态信息
特性：
- 支持文生图
- 支持图生图编辑
- 支持遮罩局部编辑
💡 使用示例
示例 1：使用 Gemini 生成图像（API Key）
1. 添加 "PD: Gemini Image (apikey)" 节点
2. 输入 API Key
3. 输入提示词："A futuristic city with flying cars"
4. 选择宽高比：16:9
5. 连接输出到预览节点
6. 执行工作流
示例 2：使用 GPT 编辑图像
1. 添加 "PD: GPT Image (apikey)" 节点
2. 输入 API Key
3. 连接输入图像到 image 端口
4. 输入编辑提示词："Add a sunset sky"
5. 设置质量为 high
6. 执行工作流
⚠️ 注意事项
- API Key 安全：请妥善保管 API Key，不要分享给他人
- 成本控制：注意查看成本信息，控制 API 调用次数
- 网络连接：需要稳定的网络连接
- 生成时间：高质量图像可能需要较长时间
🐛 故障排除
节点未显示
- 检查是否正确安装到
custom_nodes目录 - 重启 ComfyUI
- 查看控制台错误信息
API 调用失败
- 验证 API Key 或 Auth Token 是否正确
- 检查网络连接
- 查看控制台详细错误信息
图像格式错误
- 确保输入图像格式为 ComfyUI 标准格式（B H W C）
- 检查图像通道数是否为 3 (RGB)
📄 许可证
MIT License