143 lines
8.0 KiB
Markdown
143 lines
8.0 KiB
Markdown
# ComfyUI PD Comfy API Node
|
||
|
||
仓库定位：把官方 Comfy API 节点复刻成普通自定义节点，用户自己填 `comfy_api_key` 调用。
|
||
|
||
ComfyUI 自定义节点套件，集成 Gemini 和 GPT 图像生成 API，支持两种认证方式。
|
||
|
||
## ✨ 功能特性
|
||
|
||
- 🎨 **多模型支持**：Gemini 2.5 Flash Image、GPT Image 1/1.5
|
||
- 🔑 **双认证方式**：支持 API Key 和 Auth Token 两种调用方式
|
||
- 💰 **成本追踪**：实时显示 API 调用成本
|
||
- 🖼️ **图像处理**：支持文生图、图生图、图像编辑
|
||
- ⚙️ **灵活配置**：多种宽高比、质量、分辨率选项
|
||
|
||
## 📦 安装方法
|
||
|
||
```bash
|
||
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，简单直接。
|
||
|
||
**获取方法**：
|
||
1. 访问 [ComfyUI API](https://www.comfy.org/api-keys)
|
||
2. 登录并创建 API Key
|
||
3. 复制 Key 并粘贴到节点中
|
||
|
||
## 📝 更新日志
|
||
|
||
### 2026-10-11 - Grok Video
|
||
- 新增 `PD- grok video comfyapi`（`PDGrokVideoAPIKey`），位于 `PD_Tools/Video_Generation`，手动填写 Comfy.org API Key。
|
||
- 支持 `grok-imagine-video` / `grok-imagine-video-1.5` / `grok-imagine-video-1.5-lite`，文生视频或单张起始图生视频，1–15 秒；参数与当前官方 Grok Video 节点一致。普通版不支持 1080p，1.5 系列有起始图时可省略提示词，seed 不保证输出复现。
|
||
- 输出 `VIDEO` 可直接连接 Save Video，`info` 包含任务 ID、模型、服务返回的 usage，以及响应提供的实际 credits。费用角标明确标为估算。
|
||
- 一次执行只提交一次生成请求；轮询、下载期间每秒显示耗时，每 0.1 秒检查取消，整次执行限时 600 秒，不自动重试付费请求。取消不保证退还已受理任务费用。
|
||
- 验证：`python custom_nodes/comfyui-PD_comfy-api-node/tests/test_grok_video.py`。离线覆盖三个模型文/图生视频、MP4 输出可解码、任务/费用信息、提交/轮询/下载取消、超时不重试及请求前校验。本次没有真实付费生成。
|
||
|
||
### 2026-10-11 - Grok 文生图
|
||
- 新增 `PDGrokImageAPIKey` 文生图节点，复用现有 Grok 模型列表；API Key 由节点输入提供。同步更新 Grok 编辑节点的取消检查与失败状态。
|
||
|
||
### 2026-10-11 - OpenAI ChatGPT / GPT Image 2.5
|
||
- 新增 `PD: OpenAI ChatGPT Latest (ComfyUI Key)`（`PDOpenAIChatLatestAPIKey`），在 `PD_Tools/Text_Generation`。模型列表复用本地官方节点的 18 个选项，支持批量图片、`OPENAI_INPUT_FILES` 文件输入及 `OPENAI_CHAT_CONFIG` 高级设置；可连接官方 OpenAI ChatGPT Input Files / Advanced Options 节点。输出文字。
|
||
- 新增 `PD: OpenAI GPT Image 2.5 (ComfyUI Key)`（`PDOpenAIGPTImage25APIKey`），在 `PD_Tools/Image_Generation`。支持 `gpt-image-2.5-flare` / `gpt-image-2.5-sunburst` / `gpt-image-2` / `gpt-image-1.5` / `gpt-image-1`；动态尺寸、质量、背景、最多 16 张参考图、单图遮罩和 1–8 张输出。保留 RGBA 透明度，自动对齐同批输出尺寸。seed 沿用官方控件，当前后端未实现。
|
||
- 两者手动填写 Comfy.org API Key，复用本地官方价格估算角标；完成状态显示服务返回的 usage，估算角标不代表实际扣费。旧 ChatGPT/GPT Image 节点保留，需包含上述官方模型节点的新版 ComfyUI。
|
||
- ChatGPT 每次独立请求；官方 `persist_context` 已废弃且无效，因此新节点省略该开关，不在本地保存历史。Responses 格式参考 [OpenAI Docs](https://developers.openai.com/api/docs/guides/conversation-state)，Comfy.org 代理契约以本地 `comfy_api_nodes/nodes_openai.py` 为准。
|
||
- 请求/轮询/下载期间每秒显示耗时，每 0.1 秒检查取消，整次执行限时 600 秒；仅一次生成 POST，不自动重试。取消不保证退还远端已产生的费用。
|
||
- 离线测试：`python custom_nodes/comfyui-PD_comfy-api-node/tests/test_openai_latest.py`。覆盖全部模型、文件/高级设置、异步轮询、RGBA/尺寸对齐、遮罩、慢请求取消、超时不重试及请求前校验；本次未提交真实付费请求。
|
||
|
||
### 2026-10-11 - Nano Banana 2.1
|
||
- 新增 `PD: Nano Banana 2.1 (ComfyUI Key)`（`PDGeminiNanoBanana21`），位于 `PD_Tools/Image_Generation`；旧 Nano Banana 2 节点保留。
|
||
- 复用当前官方节点的动态模型参数：Nano Banana 2.1、Nano Banana 2、Nano Banana 2 Lite；Lite 仅支持 1K，2.1 支持 MINIMAL/MEDIUM/HIGH。支持最多 14 张参考图及 `GEMINI_INPUT_FILES`，输出成品图、文字、第一张思考图；无思考图时与官方节点一样输出空白占位图。
|
||
- 手动填写 Comfy.org API Key；无需通过官方节点的登录入口。需包含 `GeminiNanoBanana2V2` 的新版 ComfyUI，本机已验证版本为 0.39.0。费用角标沿用官方估算，实际扣费以账户账单为准。
|
||
- 按官方请求契约，2.1 不发送 temperature/top_p；所有三个模型当前都不发送 seed。控件提示已注明，固定 seed 不保证复现。
|
||
- 等待期间每秒显示耗时，取消检查间隔 0.1 秒；单次执行只提交一次生成请求，不自动重试。取消后不继续轮询、下载或返回部分结果；已受理的远端请求不保证取消扣费。
|
||
- 离线模拟验证：`python custom_nodes/comfyui-PD_comfy-api-node/tests/test_nano_banana21.py`，覆盖三个模型请求、思考图分离、慢生成/下载取消、超时不重试及请求前校验；不产生 API 费用。
|
||
|
||
### v2.0.1 - 2026.0424
|
||
- 修复 `PD_comfyplus_image (Multi-Size Pack)` -> GPT Image 2 `files` 输入不兼容的问题。
|
||
- 在发送 OpenAI 兼容的 multipart 请求前，对打包图片的 MIME type 做归一化处理，确保 `GeminiMimeType.image_png` / `image_png` 会以 `image/png` 发送。
|
||
- 仅影响 GPT Image 2 编辑模式的 `files` 输入路径；普通单图 `image` 输入路径行为保持不变。
|
||
|
||
### v2.0.0 -2026.0422
|
||
- 更新chatgpt image2 节点
|
||
- PD: Nano Banana 2 (ComfyUI Key) 节点更新，增加重试3次机制，放置出黑图，稳定性增加。
|
||
### v2.0.0 -2026.0112
|
||
- 新增 Auth Token 认证方式
|
||
- 新增 GPT Image 节点
|
||
- 优化成本计算
|
||
- 改进错误处理
|
||
|
||
### v1.0.0
|
||
- 初始版本
|
||
- 支持 Gemini 图像生成
|
||
- 支持 API Key 认证
|
||
|
||
### 节点介绍
|
||
#### PD: GPT Image 2 (comfyui_apikey)
|
||
- 支持输入多图参考
|
||
- 支持单图输入，GPT image2 节点comfyui 格式。
|
||
|
||
|
||
#### PD: Gemini Image (ComfyUI Key)
|
||
|
||
|
||
#### PD: Gemini Pro Image (ComfyUI Key)
|
||
|
||
#### PD: Nano Banana 2 (ComfyUI Key)
|
||
|
||
|
||
|
||
### 方式二：Auth Token
|
||
|
||
使用浏览器 Auth Token，适合高级用户。
|
||
|
||
**获取方法**：
|
||
1. 安装油猴脚本（Tampermonkey）：具体B站有教程：小熊猫pandy
|
||
2. 安装 Token 抓取脚本 脚本: \comfyui-PD_comfy api node\temperay\PD_comfyui_token_grabber.user.js
|
||
3. 访问 ComfyUI 网站并登录
|
||
4. 脚本会自动抓取 Token
|
||
5. 复制 Token 并粘贴到节点中
|
||
|
||
|
||
|
||
|
||
**优点**：
|
||
- ✅ 无需申请 API Key
|
||
- ✅ 使用现有账号权限
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. **API Key 安全**：请妥善保管 API Key，不要分享给他人
|
||
2. **成本控制**：注意查看成本信息，控制 API 调用次数
|
||
3. **网络连接**：需要稳定的网络连接
|
||
4. **生成时间**：高质量图像可能需要较长时间
|
||
|
||
## 🐛 故障排除
|
||
|
||
### 节点未显示
|
||
- 检查是否正确安装到 `custom_nodes` 目录
|
||
- 重启 ComfyUI
|
||
- 查看控制台错误信息
|
||
|
||
### API 调用失败
|
||
- 验证 API Key 或 Auth Token 是否正确
|
||
- 检查网络连接
|
||
- 查看控制台详细错误信息
|
||
|
||
### 图像格式错误
|
||
- 确保输入图像格式为 ComfyUI 标准格式（B H W C）
|
||
- 检查图像通道数是否为 3 (RGB)
|
||
|
||
|
||
## 🤝 贡献
|
||
欢迎提交 Issue 和 Pull Request！
|
||
---
|