Skip to main content

​
节点概述

节点标识： artsmcp-gemini-banana
技术栈： Gemini
功能： 调用 Gemini API 进行图像分析、编辑和智能处理

​
支持的功能

  • ✅ 图像理解与分析
  • ✅ 图像编辑与修改
  • ✅ 风格转换
  • ✅ 多图输入（最多4张）
  • ✅ 智能图像问答
  • ✅ 分行批量处理

​
节点界面

Gemini 节点配置与生成效果

​
必填参数

参数名称说明示例值备注
输入图片1第一张输入图片-必填，连接图片节点
输入图片2第二张输入图片-可选，支持多图输入
输入图片3第三张输入图片-可选，支持多图输入
输入图片4第四张输入图片-可选，最多支持4张图片
prompt(提示词)图像处理的指令描述”将这个角色的服装改为科幻风格，保持脸部特征不变”支持中英文
API地址Gemini API 端点https://api.example.com填写实际的 API 地址
模型选择模型版本gemini-3-pro-image-preview-4k推荐使用最新版本
API_KEYGemini API 密钥your-api-key-here在控制台获取
提示词建议：
  • 对于图像分析：描述想要了解的内容（“描述这张图片的内容”）
  • 对于图像编辑：明确说明修改要求（“将背景替换为海滩场景”）
  • 对于风格转换：指定目标风格（“转换为油画风格”）
  • 支持复杂的多步骤指令

​
图片尺寸参数

​
匹配参考尺寸
boolean
default:"true"
是否匹配输入图片的尺寸
  • 开启 - 输出图片与输入图片尺寸一致（推荐）
  • 关闭 - 使用指定的宽高比
​
响应格式
string
default:"U"
图片返回格式可选值：
  • U - 返回图片URL（推荐）
  • B64 - 返回Base64编码
​
宽高比
string
default:"2:3"
输出图片的宽高比例（当”匹配参考尺寸”关闭时生效）可选比例：
  • 1:1 - 方形
  • 2:3 / 3:2 - 常见照片比例
  • 3:4 / 4:3 - 传统屏幕比例
  • 4:5 / 5:4 - 社交媒体常用
  • 9:16 / 16:9 - 手机/电脑屏幕
  • 21:9 - 超宽屏

​
宽高比使用指南

1:1 - 正方形适用场景：
  • 社交媒体头像
  • Instagram 发布
  • 需要对称构图的场景

​
高级参数配置

​
性能参数

​
超时时间秒
integer
default:"120"
API请求超时时间（秒）建议值： 120-300 秒
图像处理可能需要较长时间，特别是复杂的编辑任务
​
最大重试次数
integer
default:"3"
API调用失败时的重试次数范围： 1-5 次
  • 网络不稳定时建议增加重试次数
  • 设置过高可能导致长时间等待

​
批量处理参数

​
启用分行提示词
boolean
default:"true"
是否启用分行提示词功能功能说明：
  • 开启后，提示词中的每一行会被视为独立的任务
  • 适合批量处理多个相似的编辑操作
  • 会为每行提示词生成一张图片
使用场景：
将人物服装改为红色
将人物服装改为蓝色
将人物服装改为绿色
→ 会生成3张不同颜色的图片
​
每行并发请求数
integer
default:"1"
每行同时发起的请求数量范围： 1-5
  • 增加并发可以提高处理速度
  • 但会增加 API 负载和费用消耗
  • 建议根据 API 限制合理设置

​
调试参数

​
详细日志
boolean
default:"false"
是否输出详细的调试日志开启后会显示：
  • 请求参数详情
  • API 调用过程
  • 响应数据内容
  • 错误堆栈信息
问题排查时建议开启此选项

​
输出说明

​
images
tuple
生成/编辑的图片文件，自动保存到 ComfyUI 输出目录文件信息：
  • 文件格式：.png
  • 命名规则：ComfyUI_[序号].png
  • 保存路径：ComfyUI/output/
  • 输出结构：tuple 包含 1 个元素（图片列表）
多图输出：
  • 使用分行提示词时会输出多张图片
  • 每行提示词对应一张输出图片

​
使用示例

​
示例 1：图像内容分析

1

连接输入图片

将需要分析的图片连接到”输入图片1”
2

配置分析提示词

详细描述这张图片中的所有元素，包括：
- 主要对象和人物
- 场景和背景
- 色调和光线
- 整体氛围和风格
3

运行节点

执行后会在日志中看到详细的图片分析结果
此模式主要用于理解图片内容，不会生成新图片

​
示例 2：图像编辑修改

1

准备原图

连接要编辑的图片到”输入图片1”
2

配置编辑指令

将这张图片中的人物服装改为科幻风格的战斗服，
保持人物的脸部特征和姿势不变，
添加未来感的装备和配件
3

设置参数

  • 匹配参考尺寸：开启（保持原图尺寸）
  • 响应格式：U
  • 超时时间：180 秒（复杂编辑需要更长时间）
4

执行生成

运行节点，等待编辑完成

​
示例 3：多图对比分析

1

连接多张图片

  • 输入图片1：第一张对比图
  • 输入图片2：第二张对比图
  • 输入图片3：第三张对比图（可选）
2

配置对比提示词

对比这几张图片，分析它们的：
1. 相同点和不同点
2. 各自的优势和特色
3. 哪张图片的构图更好
4. 给出改进建议
3

查看分析结果

在日志中查看详细的对比分析报告

​
示例 4：批量风格转换

1

连接原图

将一张图片连接到”输入图片1”
2

启用分行提示词

  • 启用分行提示词：true
  • 每行并发请求数：2
3

配置多种风格

在提示词中输入（每行一个风格）：
将这张图片转换为水彩画风格
将这张图片转换为油画风格
将这张图片转换为素描风格
将这张图片转换为赛博朋克风格
4

执行批量处理

运行后会生成4张不同风格的图片

​
常见问题

主要区别：
特性GeminiSeedream
核心能力图像理解 + 编辑图像生成
输入方式必须有图片输入可以纯文本生成
最大输入4张图片2张图片
主要用途分析、修改现有图片创建新图片
特色功能图像问答、批量处理高质量生成、多尺寸
选择建议：
  • 需要分析或编辑已有图片 → 使用 Gemini
  • 需要创建全新图片 → 使用 Seedream
使用步骤：
  1. 启用”启用分行提示词”选项
  2. 在提示词中每行写一个独立的指令
  3. 每行会被当作独立的任务处理
  4. 最终输出多张对应的图片
适用场景：
  • 批量风格转换
  • A/B 测试不同的编辑方案
  • 生成系列变体图片
注意事项：
  • 每行指令应该完整且独立
  • 空行会被忽略
  • 并发数不要设置过高
可能的原因和解决方案：
  1. 提示词不够明确
    • ❌ “改一下这张图”
    • ✅ “将背景从室内改为海滩，保持人物不变”
  2. 原图质量问题
    • 确保输入图片清晰
    • 避免过度压缩的图片
    • 推荐使用高分辨率原图
  3. 要求过于复杂
    • 将复杂任务拆分为多步
    • 先完成基础编辑，再进行细节调整
  4. 模型限制
    • 某些特定类型的编辑可能效果有限
    • 可以尝试调整提示词表达方式
是的，图片顺序可能会影响处理结果。建议：
  • 输入图片1：主要的参考图片
  • 输入图片2-4：辅助参考或对比图片
  • 在提示词中明确说明每张图片的作用
示例提示词：
参考第一张图片的人物姿势，
结合第二张图片的背景场景，
生成一张新的合成图片
获取步骤：
  1. 访问 Gemini API 控制台
  2. 注册或登录账号
  3. 创建新的 API 项目
  4. 生成 API 密钥
  5. 复制密钥配置到节点中
  • 请妥善保管 API Key，不要泄露
  • 不同的 API Key 可能有不同的配额限制
  • 定期检查 API 使用量，避免超额

​
最佳实践

提示词编写技巧

有效的提示词结构：
  1. 明确任务类型
    • 分析：“描述/分析/识别…”
    • 编辑：“修改/替换/添加…”
    • 转换：“转换为/改为…”
  2. 详细的要求
    • 指定保留的部分
    • 说明修改的程度
    • 描述期望的效果
  3. 质量要求
    • “保持高清晰度”
    • “自然融合”
    • “细节丰富”

性能优化建议

提升处理效率：
  1. 合理设置超时
    • 简单任务：60-120秒
    • 复杂编辑：180-300秒
  2. 并发控制
    • 测试时：并发数 = 1
    • 批量处理：并发数 = 2-3
  3. 重试策略
    • 网络稳定：重试 1-2 次
    • 网络不稳定：重试 3-5 次

图片质量保证

输入图片要求：
  1. 格式支持
    • PNG（推荐）
    • JPG
    • WEBP
  2. 分辨率建议
    • 最小：512x512
    • 推荐：1024x1024 以上
    • 最大：4096x4096
  3. 文件质量
    • 避免过度压缩
    • 保持清晰度
    • 合理的文件大小

批量处理策略

高效批量处理：
  1. 任务分组
    • 相似任务一起处理
    • 控制每批数量（建议≤5）
  2. 并发设置
    • 根据 API 限制调整
    • 监控处理速度
    • 避免超过配额
  3. 错误处理
    • 开启详细日志
    • 逐个检查结果
    • 失败任务单独重试

​
相关资源

ComfyUI 概览

返回 ComfyUI 集成首页

Seedance 视频节点

了解视频生成节点

Seedream 图片节点

了解图片生成节点

API 使用指南

查看 API 基础文档