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 调用成本
• 🖼️ 图像处理：支持文生图、图生图、图像编辑
• ⚙️ 灵活配置：多种宽高比、质量、分辨率选项

📦 安装方法

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
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，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！