ComfyUI-Gemini-API 插件完全教程

1. 插件简介

ComfyUI-Gemini-API 是一个让你在 ComfyUI 中使用 Google 最新的 Gemini 2.0 人工智能来生成图片的插件。这个插件就像是给你的 ComfyUI 装上了一个超级智能的画师，你只需要用文字描述你想要的图片，它就能帮你画出来！

GitHub 原地址： https://github.com/CY-CHENYUE/ComfyUI-Gemini-API

这个插件能给我们带来什么效果？

• 文字生图：就像跟画师聊天一样，你说"画一只可爱的小猫"，它就能画出来
• 参考图生图：就像给画师看样本一样，你可以上传一张或多张图片作为参考，让AI按照这个风格画新图
• 多样化控制：就像调节画师的创作风格，可以让它画得保守一点或者大胆创新一点
• 图片比例控制：可以指定要横屏、竖屏还是方形的图片
• 可重复生成：就像给画师一个固定的"灵感种子"，用同样的描述和种子能画出一样的图

2. 如何安装

方法一：使用 Git 克隆（推荐）

1. 打开终端或命令提示符
2. 进入你的 ComfyUI 安装目录下的 custom_nodes 文件夹
3. 运行以下命令：

git clone https://github.com/CY-CHENYUE/ComfyUI-Gemini-API.git

方法二：手动下载

1. 访问 https://github.com/CY-CHENYUE/ComfyUI-Gemini-API
2. 点击绿色的 "Code" 按钮，选择 "Download ZIP"
3. 解压到 ComfyUI 的 custom_nodes 文件夹中

方法三：通过 ComfyUI Manager 安装

1. 在 ComfyUI 中安装并打开 ComfyUI Manager
2. 在 Manager 中搜索 "Gemini API"
3. 点击安装按钮

安装后步骤

1. 安装所需依赖包：
   • 如果使用 ComfyUI 便携版：

   ..\\..\\..\\python_embeded\\python.exe -m pip install -r requirements.txt
   

   • 如果使用自己的 Python 环境：

   pip install -r requirements.txt
   

2. 重启 ComfyUI

获取 Google API 密钥

1. 访问 Google AI Studio
2. 创建账户或登录
3. 在 "API Keys" 部分创建一个新的 API 密钥
4. 复制 API 密钥备用

3. 节点详细解析

3.1 Gemini 2.0 image 节点 - Google AI 图片生成器

这个节点就像一个超级智能的画师，可以根据你的文字描述来画图片。它不仅能理解你说的话，还能参考你提供的图片来画出符合你要求的新图片。

参数详解

4. 使用技巧和建议

提示词编写技巧

1. 详细描述：越详细越好，包括颜色、材质、光线、情绪等
2. 分层描述：先说主体，再说背景，最后说风格
3. 使用形容词：多用生动的形容词让描述更丰富
4. 参考经典：可以提到艺术风格，如"油画风格"、"水彩画风格"

参数调优建议

1. temperature 参数使用：

   • 0.0-0.5：适合需要精确控制的场景
   • 0.5-1.0：日常使用的平衡选择
   • 1.0-2.0：需要创意和变化的场景

2. aspect_ratio 选择：

   • Free：让AI自由发挥
   • Landscape：适合风景、全景图
   • Portrait：适合人物、竖版海报
   • Square：适合社交媒体、头像

3. 参考图片使用：

   • 单张参考：用于风格模仿
   • 多张参考：用于风格融合
   • 图片质量要清晰，避免模糊

工作流程建议

1. 基础生图流程：输入提示词 → 设置参数 → 生成图片
2. 参考生图流程：准备参考图 → 连接到images输入 → 输入提示词 → 生成
3. 批量生图流程：固定提示词 → 改变seed值 → 生成多个变体

5. 常见问题解答

Q1: 提示"未提供有效的API密钥"怎么办？

A:

1. 确保已从 Google AI Studio 获取了有效的API密钥
2. 检查密钥是否完整复制（通常很长，包含字母和数字）
3. 首次输入后密钥会自动保存，下次使用无需重新输入

Q2: 生成的图片是空白的怎么办？

A:

1. 检查网络连接是否正常
2. 确认API密钥是否有效且有剩余额度
3. 尝试简化提示词，避免过于复杂的描述
4. 检查参考图片是否格式正确

Q3: 图片生成速度很慢怎么办？

A:

1. 这是正常现象，AI生图需要时间
2. 避免同时运行多个生成任务
3. 检查网络连接稳定性
4. 可以尝试简化提示词

Q4: 如何让生成的图片更符合要求？

A:

1. 提供更详细和具体的描述
2. 使用参考图片来指导风格
3. 调整temperature参数控制创意程度
4. 多次尝试不同的提示词表达

Q5: 参考图片功能怎么使用？

A:

1. 将图片节点连接到Gemini节点的images输入
2. 支持单张或多张图片同时输入
3. AI会参考图片的风格、构图、色彩等元素
4. 在提示词中可以说明如何使用参考图

Q6: API有使用限制吗？

A:

1. Google API可能有调用次数或费用限制
2. 建议查看Google官方文档了解具体限制
3. 合理使用，避免频繁调用
4. 注意保护个人隐私，上传的图片会发送给Google

6. 实际应用场景

场景1：概念艺术创作

• 用途：为游戏、动画、小说创作概念图
• 技巧：详细描述场景、角色、氛围
• 示例：创作科幻城市、奇幻生物、未来载具

场景2：商业设计辅助

• 用途：为产品、广告、品牌创作视觉素材
• 技巧：结合品牌色彩、风格要求
• 示例：产品展示图、广告背景、logo设计灵感

场景3：个人创作

• 用途：为个人项目、社交媒体创作图片
• 技巧：发挥创意，尝试不同风格
• 示例：头像设计、壁纸制作、插画创作

场景4：风格学习和模仿

• 用途：学习特定艺术风格或技法
• 技巧：使用参考图片功能
• 示例：模仿名画风格、学习插画技法

7. 注意事项

隐私和安全

1. 图片隐私：上传的参考图片会发送给Google，注意隐私保护
2. API密钥安全：不要在公共场所或截图中暴露API密钥
3. 内容合规：避免生成违法、有害或不当内容

使用限制

1. API配额：注意Google API的使用限制和费用
2. 网络要求：需要稳定的网络连接访问Google服务
3. 依赖性：功能依赖Google服务的可用性

技术要求

1. 版本要求：需要google-genai>=1.5.0和Pillow>=10.1.0
2. 系统兼容：支持Windows、Mac、Linux系统
3. 内存要求：处理大图片时需要足够内存

8. 更新和维护

如何更新插件

1. 进入插件目录：cd custom_nodes/ComfyUI-Gemini-API
2. 拉取最新代码：git pull
3. 更新依赖：pip install -r requirements.txt --upgrade
4. 重启 ComfyUI

如何卸载插件

1. 删除 custom_nodes/ComfyUI-Gemini-API 文件夹
2. 重启 ComfyUI

9. 总结

ComfyUI-Gemini-API 插件为 ComfyUI 用户提供了强大的AI图像生成能力。它的主要优势包括：

1. 先进的AI技术：基于Google最新的Gemini 2.0模型
2. 多样化输入：支持文本描述和参考图片
3. 灵活控制：可调节创意程度、图片比例等参数
4. 易于使用：简单的界面，详细的参数说明
5. 高质量输出：能生成高质量、符合要求的图片

无论你是专业设计师、艺术创作者，还是AI爱好者，这个插件都能为你的创作工作流程带来新的可能性。记住，好的提示词和合适的参数设置是获得理想结果的关键！

希望这个教程能帮助你更好地使用 ComfyUI-Gemini-API 插件，创作出令人惊艳的AI艺术作品！