企业官网建设流程全解析

ComfyUI Gemini API密钥怎么配才不泄露？一篇文章讲清两种写法与三个防泄露动作

【免费下载链接】ComfyUI-GeminiUsing Gemini in ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Gemini

ComfyUI-Gemini 是一套把 Google Gemini 大模型接进 ComfyUI 的自定义节点，能帮你生成提示词、描述图片甚至陪你聊天。可一旦接入，API 密钥就成了你的"付款密码"——本文从一场真实的翻车现场讲起，把 ComfyUI Gemini API 密钥配置的两种写法彻底讲透，再送你三个马上就能用的防泄露动作。

一个翻车现场：密钥是怎么跟着工作流一起"离家出走"的

朋友小周第一次用这套插件时，直接在 ✨Gemini_API_Zho 节点的 api_key 输入框里贴上了自己的密钥，跑通后很兴奋，顺手把工作流截图和 JSON 文件一起丢进了交流群。

三个小时后，他的 Google 账户多出一长串陌生的调用记录。

问题不在操作本身，而在于一个很容易忽略的事实：工作流 JSON 文件会原样保存节点里填过的所有参数。你输入的密钥、提示词、模型名，全都躺在那个文本文件里。谁拿到工作流文件，谁就等于拿到了你的钥匙。

记住这条线：节点里填的每一串字符，都会写进工作流文件；而工作流文件，天生就是用来导出、用来分享的。

保险箱与随身钥匙：两种 API 密钥写法的本质区别

ComfyUI-Gemini 提供两套节点，前缀不同，读取密钥的方式也完全不同：

• ㊙️ 开头的隐式节点：不需要你填任何密钥，运行时自动去项目里的config.json读取，密钥从头到尾不进入工作流文件。
• ✨ 开头的显式节点：需要你在 api_key 输入框手动贴密钥，适合单机自测，但输入内容会沉淀在工作流文件里。

把前者想象成保险箱：钥匙锁在箱里，出门时你带的是门禁卡，别人看了你的门禁卡也猜不到保险箱密码；把后者想象成揣在兜里的家门钥匙：用起来顺手，可只要外套一脱手，钥匙就跟着跑了。

只用看懂一小段逻辑：密钥到底从哪里读

担心隐式节点太神秘？其实它的读取逻辑写在核心源码 GeminiAPINode.py 里，核心就一句话：启动时打开同目录下的config.json，取出GEMINI_API_KEY字段交给 Gemini SDK 初始化。

换句话说，只要config.json写得对，㊙️ 系列节点会自动完成"取钥匙、开门"的流程，你连节点的 api_key 参数都看不到。显式节点则相反，它把填密钥的责任交给你，风险也就一并交了过来。

三步把密钥锁进保险箱：隐式节点配置实操

还没装插件的话，先在 ComfyUI 的custom_nodes目录下执行git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Gemini，装好依赖并重启 ComfyUI。之后跟着下面三步走，五分钟内就能跑通隐式节点：

1. 定位配置文件：进入custom_nodes/ComfyUI-Gemini/，找到config.json。首次安装时插件会自动生成模板，里面默认写着"your key"。
2. 填入真实密钥：把"your key"替换成你在 Google AI Studio 申请的 Gemini API 密钥，注意保留英文引号、别误删逗号——JSON 对格式相当挑剔。
3. 重启并验证：重启 ComfyUI，拖一个 ㊙️Gemini_Zho 节点，随便输入一句 prompt 跑一次。能正常返回文本，就说明密钥读取成功。

（此处建议补充实际操作截图：config.json 填入密钥后，与 ㊙️Gemini_Zho 节点跑通一次对话的画面）

顺带提醒：Gemini 免费档有速率限制（约每分钟 2 次、每天 1000 次）。首次测试失败不一定是配错了，也可能是被限流，稍等片刻再试即可。

什么场景才轮到显式节点

显式节点并非一无是处，它有两个真正擅长的地方：

• 临时调试：只想快速验证某个模型参数是否生效，贴一次密钥比改配置文件更顺手；
• 演示环境：在来不及建配置文件的临时机器上快速出效果。

但它有一条绝对底线——任何会被导出的工作流，都不能用显式节点。

⚠️ 警告：一旦发现含密钥的工作流文件已经发出去，别指望"撤回"能救场。密钥泄露没有回滚按钮，唯一补救是立刻去 Google AI Studio 撤销旧密钥、生成新密钥，再重新配置所有引用它的地方。

三个高频误区，越早纠正越省钱

• 误区一：以为密钥写进 config.json 就万事大吉。配置文件只解决"不进工作流"的问题。可如果你把整个custom_nodes/ComfyUI-Gemini目录打包发人、同步到云端，密钥照样会跟着走。它应该被写进.gitignore，而不是被当资源分享出去。
• 误区二：以为只在自己电脑上用就没有风险。恶意软件扫描、泄露的云同步账号、误备份到公共网盘的目录，都是绕过"个人使用"这条边界的通道。
• 误区三：以为密钥"改一下就能继续用"。密钥一旦暴露，旧密钥就始终是悬在头顶的风险。正确动作是作废重发，而不是修修补补继续复用。

分享与轮换：两条随时可执行的检查清单

分享工作流前，花 3 分钟做一次体检：

• 全文搜索工作流 JSON，确认不含AIza开头的密钥片段
• 确认所有 Gemini 节点都是 ㊙️ 前缀，而非 ✨ 前缀
• 确认config.json不在分享目录内，且已加入忽略清单

给密钥定一个"保质期"，养成轮换习惯：

• 每月查一次 Gemini 用量账单，盯住异常调用
• 每季度在 Google AI Studio 生成新密钥，更新 config.json
• 发现任何可疑记录：先撤销、再换新、后查调用日志

写在最后：从今天起只做一件事

把全文浓缩成一句行动指南：公开场景走保险箱，私人场景才带身上。

你的下一步很简单——现在就去custom_nodes/ComfyUI-Gemini/config.json填入密钥，把正在用的工作流从 ✨ 节点换成 ㊙️ 节点，再跑通一次验证，顺手把密钥轮换记进日历提醒。

钥匙安全了，创作才能真正放开手脚。花五分钟把配置理顺，换回的是往后每一天的安心出图。

【免费下载链接】ComfyUI-GeminiUsing Gemini in ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Gemini