comfyui-PD_comfy-api-node
ComfyUI custom node suite integrating multiple AI image generation APIs (Gemini, Flux.1 Kontext Pro) with unified authentication via ComfyUI API Key and real-time cost tracking. (Description by CC)
Nodes (20)
PD 阿里云换脸（双图）
The pack helper that stuffs up to 9 reference images into one input
The PD Gemini text node
Gemini 2.5 Flash Image, wired straight into your ComfyUI graph
The Gemini image node for people who don't want to mint an API key
Nano Banana 2 in ComfyUI, retries and all
Nano Banana 2.1 (ComfyUI Key) — the official Gemini image node with the login gate removed
Gemini Pro Image — the 'thinking' flagship, inside your graph
Gemini Pro Image without an API key — the token-powered twin
The api_key field is a Comfy key, not an xAI key
XAI image editing through your Comfy key
Run Krea 2 in your ComfyUI graph without downloading a 12B model
Feed Krea 2 a style image — the reference node the open weights never got
ChatGPT models in a ComfyUI graph, billed through your Comfy key
GPT Image 2 in ComfyUI — multi-image editing without a GPU
GPT Image 2 with a session token — multi-image editing, no key management
GPT Image 1 & 1.5 through your ComfyUI key — the Ghibli-era engine, on tap
GPT Image 1 & 1.5 via session token — the no-new-key option
Seedance 2.0 text-to-video in ComfyUI, without the VRAM meltdown
Seedream 5.0 layer separation via your Comfy key
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，简单直接。
获取方法：
- 访问 ComfyUI API
- 登录并创建 API Key
- 复制 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 2files输入不兼容的问题。 - 在发送 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，适合高级用户。
获取方法：
- 安装油猴脚本（Tampermonkey）：具体B站有教程：小熊猫pandy
- 安装 Token 抓取脚本 脚本: \comfyui-PD_comfy api node\temperay\PD_comfyui_token_grabber.user.js
- 访问 ComfyUI 网站并登录
- 脚本会自动抓取 Token
- 复制 Token 并粘贴到节点中
优点：
- ✅ 无需申请 API Key
- ✅ 使用现有账号权限
⚠️ 注意事项
- API Key 安全：请妥善保管 API Key，不要分享给他人
- 成本控制：注意查看成本信息，控制 API 调用次数
- 网络连接：需要稳定的网络连接
- 生成时间：高质量图像可能需要较长时间
🐛 故障排除
节点未显示
- 检查是否正确安装到
custom_nodes目录 - 重启 ComfyUI
- 查看控制台错误信息
API 调用失败
- 验证 API Key 或 Auth Token 是否正确
- 检查网络连接
- 查看控制台详细错误信息
图像格式错误
- 确保输入图像格式为 ComfyUI 标准格式（B H W C）
- 检查图像通道数是否为 3 (RGB)