MeteorAndyandClaude
6f2aa13575
Rewrite each node to faithfully mirror the official comfy_api_nodes/
contract (apis/*.py + Comfy-Org/embedded-docs). The ComfyOrg proxy
forwards the body verbatim, so the official request/response models
ARE the real vendor API.
- Video nodes now return VIDEO (InputImpl.VideoFromFile), not file paths
- Audio nodes now return AUDIO ({waveform, sample_rate}), not file paths
- Request/response bodies match official pydantic models field-for-field
- Model ids, options, defaults, ranges match official + embedded docs
- Every node exposes api_key + base_url (overridable for relays/proxies)
- utils.py: add ComfyUI-native helpers — video_from_bytes,
download_video_output, audio_from_bytes, download_audio_output,
poll_until, validate_prompt, tensor_to_data_uri
- Rewrite nodes_minimax.py (submit -> poll -> retrieve -> download VIDEO)
- nodes_extra.py: base_url on all three, poll_until, validate_prompt
- Clean __init__.py (drop duplicate grok import/keys); 37 nodes total
- README: output-type alignment, node list, relay examples
Co-Authored-By: Claude <noreply@anthropic.com>
ComfyUI BYOKey — Bring Your Own Key
直接用自己的 API Key 调用 AI 服务，支持自定义中转站地址，输入/输出类型与官方节点 100% 兼容。
ComfyUI 官方 API 节点强制所有请求走 api.comfy.org 代理：用户无法使用自己的 API Key，也无法指定第三方中转站。
本项目提供 37 个轻量替代节点，覆盖所有主流官方 API 提供商。每个节点都有 api_key 和 base_url 输入框：
- 填自己的 Key，直连官方 API
- 改
base_url，走第三方中转站（对国内用户尤其重要） - 输出类型与官方节点完全一致（
VIDEO/AUDIO/IMAGE/STRING），可直接替换官方工作流中的节点
与 comfy-api-liberation 的区别
| comfy-api-liberation | BYOKey（本项目） | |
|---|---|---|
| 实现方式 | Monkey-patch 官方节点的请求 | 独立替代节点 |
| 自定义 URL | ❌ 不支持（硬编码官方地址） | ✅ 每个节点都有 base_url |
| 中转站支持 | 无 | 完整支持 |
| 稳定性 | 依赖官方内部实现，升级易失效 | 独立实现，不受官方更新影响 |
输出类型对齐官方
本项目的请求/响应格式以 官方 comfy_api_nodes/apis/*.py 的 pydantic 模型 + Comfy-Org/embedded-docs 为基准（官方代理 api.comfy.org 对 body 做透明转发，所以官方模型即真实厂商 API 契约）。
| 类型 | 官方 | BYOKey |
|---|---|---|
| 视频 | VIDEO |
✅ VIDEO（comfy_api.latest.InputImpl.VideoFromFile） |
| 音频 | AUDIO |
✅ AUDIO（{"waveform","sample_rate"}，PyAV 解码） |
| 图像 | IMAGE |
✅ IMAGE（torch tensor，BHWC） |
| 文本 | STRING |
✅ STRING |
安装
cd ComfyUI/custom_nodes
git clone https://github.com/MeteorAndy/comfyui-byokey.git
重启 ComfyUI，节点出现在 api/byokey/... 分类下。
Node List
文本 / LLM → STRING
| 节点 | 提供商 | Vision |
|---|---|---|
| BYOKey LLM (OpenAI Compatible) | OpenAI / DeepSeek / 通义千问等 | ✅ |
| BYOKey Claude (Anthropic) | Anthropic | ✅ |
| BYOKey Gemini (Google) | ✅ | |
| BYOKey OpenRouter LLM | OpenRouter（200+ 模型） | ✅ |
| BYOKey ByteDance Seed LLM | ByteDance / Doubao（火山方舟） | ✅ |
图像生成 → IMAGE
| 节点 | 提供商 |
|---|---|
| BYOKey GPT Image (OpenAI) | OpenAI GPT Image 2 / DALL·E 3 |
| BYOKey Gemini Image (Google) | Google Gemini / Nano Banana |
| BYOKey Flux (BFL) | Black Forest Labs Flux Pro |
| BYOKey Stability AI Image | Stability AI (SD3.5 / Ultra) |
| BYOKey Grok Image (xAI) | xAI |
| BYOKey Ideogram Image | Ideogram V3 |
| BYOKey Recraft Image | Recraft V3 |
| BYOKey Reve Image | Reve |
| BYOKey Bria Image | Bria |
| BYOKey Runway Text to Image | Runway Gen4 Image |
图像超分 → IMAGE
| 节点 | 提供商 |
|---|---|
| BYOKey Magnific Upscale | Magnific AI |
| BYOKey WaveSpeed Upscale | WaveSpeed (AuraSR) |
视频生成 → VIDEO
| 节点 | 提供商 |
|---|---|
| BYOKey Seedance 2.0 Text/Image to Video | ByteDance |
| BYOKey Kling Text/Image to Video | Kling |
| BYOKey MiniMax Text/Image to Video | MiniMax / Hailuo |
| BYOKey Runway Image to Video | Runway Gen4 Turbo |
| BYOKey Luma Text/Image to Video | Luma Dream Machine |
| BYOKey Google Veo Video | Google Veo 3 |
| BYOKey Wan Text/Image to Video | Wan |
| BYOKey PixVerse Text to Video | PixVerse |
| BYOKey Vidu Text/Image to Video | Vidu |
| BYOKey LTXV Text to Video | LTX Video |
| BYOKey Grok Video (xAI) | xAI |
| BYOKey Video Gen (Generic) | 任意 submit+poll API |
音频 → AUDIO
| 节点 | 提供商 |
|---|---|
| BYOKey ElevenLabs TTS | ElevenLabs |
| BYOKey ElevenLabs Sound Effects | ElevenLabs |
使用示例
用中转站访问 OpenAI
base_url 填你的中转站地址即可（适用于所有节点）：
api_key: sk-xxxx
base_url: https://your-proxy.com/v1
model: gpt-4o
用 DeepSeek（OpenAI 兼容）
api_key: sk-your-deepseek-key
base_url: https://api.deepseek.com/v1
model: deepseek-chat
用通义千问（OpenAI 兼容）
api_key: sk-xxxx
base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
model: qwen-max
GPT Image 2 生图
api_key: sk-xxxx
base_url: https://api.openai.com/v1
model: gpt-image-2
size: 1536x1024
quality: high
依赖
仅需 ComfyUI 自带的依赖（torch、aiohttp、PIL、numpy、av），无额外安装。
验证与已知限制
- 请求/响应格式、模型 id、参数范围均以官方
comfy_api_nodes/源码与Comfy-Org/embedded-docs为基准对齐。 - 直连模式下，需图片输入的节点把图像作为 inline base64 data URI 发送（官方走代理时上传到 ComfyAPI 存储）；MiniMax 等 API 原生接受该格式。
- 部分厂商（如 Bria）官方仅提供 edit 类节点，本项目按其公开 text-to-image endpoint 实现。
License
MIT