comfyui-google-genmedia-custom-nodes：谷歌打造的GenMedia 自定义ComfyUI节点

注意：这是 Google GenAI ComfyUI 自定义节点的预览版本，为 ComfyUI 提供一组自定义节点，用于调用 Google Cloud 上的 GenMedia 系列生成模型，包括：

• Gemini（多模态文本生成）
• Gemini 2.5 Flash Image（代号 Nano Banana 🍌）
• Gemini 3 Pro Image（代号 Nano Banana Pro 🍌）
• Imagen3 / Imagen4（高质量文生图）
• Veo2 / Veo3.1（文生视频、图生视频、多图引导视频）
• Lyria2（文本生成音乐）
• Virtual Try-On（虚拟试穿：人像 + 服装 → 穿搭效果图）

所有节点均通过 Google Cloud Vertex AI API 调用模型，必须提供有效的 GCP 项目 ID 与区域。

• GitHub：https://github.com/GoogleCloudPlatform/comfyui-google-genmedia-custom-nodes

运行环境说明

方式一：在 GKE 上运行（推荐，免认证）

若您按照 ComfyUI on GKE 指南 部署 ComfyUI，系统将自动通过 GKE Workload Identity 完成认证，无需额外配置，节点开箱即用。

方式二：本地或非 GCP 环境运行（需手动认证）

您需完成以下两步：

1. 安装自定义节点
2. 配置 Google Cloud 身份验证

安装步骤（本地环境）

方法 1：使用 ComfyUI Manager（推荐）

1. 打开 ComfyUI Manager
2. 进入 Custom Node Manager
3. 搜索 comfyui-google-genmedia-custom-nodes
4. 点击 Install

方法 2：手动 Git 安装

# 进入 ComfyUI 根目录（示例路径）
cd /path/to/ComfyUI

# 进入 custom_nodes 目录
cd custom_nodes

# 克隆仓库
git clone https://github.com/GoogleCloudPlatform/comfyui-google-genmedia-custom-nodes

# 安装依赖（如使用虚拟环境，请先激活）
pip install -r comfyui-google-genmedia-custom-nodes/requirements.txt

身份验证配置

节点调用 Vertex AI 时需通过 Google Cloud 身份验证。请选择以下任一方式：

选项 A：使用用户账号（适合个人开发）

# 安装 gcloud CLI（如未安装）
# https://cloud.google.com/sdk/docs/install

# 登录并设置 Application Default Credentials
gcloud auth application-default login

选项 B：使用服务账号（适合生产或团队）

# 设置变量
export PROJECT_ID="your-gcp-project-id"
export SERVICE_ACCOUNT_ID="comfyui-sa"

# 创建服务账号
gcloud iam service-accounts create $SERVICE_ACCOUNT_ID \
    --display-name="ComfyUI Service Account"

# 授予必要权限
gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:${SERVICE_ACCOUNT_ID}@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/aiplatform.user"

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:${SERVICE_ACCOUNT_ID}@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/storage.objectUser"

# 允许当前用户模拟该服务账号
gcloud iam service-accounts add-iam-policy-binding \
    ${SERVICE_ACCOUNT_ID}@${PROJECT_ID}.iam.gserviceaccount.com \
    --member="user:$(gcloud auth list --filter=status:ACTIVE --format='value(account)')" \
    --role="roles/iam.serviceAccountTokenCreator"

# 启用模拟登录
gcloud auth application-default login \
    --impersonate-service-account=${SERVICE_ACCOUNT_ID}@${PROJECT_ID}.iam.gserviceaccount.com

🔔 重要：即使使用自动认证，每个节点仍需手动输入 gcp_project_id 和 gcp_region（除非环境变量已全局设置）。

节点功能概览

安装成功后，重启 ComfyUI。右键菜单将新增 Google AI 类别，包含以下节点：

✅ 所有节点均支持 安全过滤、种子复现、输出格式控制 等高级参数。

示例工作流（快速上手）

项目提供多个 .json 工作流模板，覆盖图像生成、视频生成、虚拟试穿等场景。

本地使用示例工作流

1. 复制工作流文件：

   cd /path/to/ComfyUI/custom_nodes
   cp comfyui-google-genmedia-custom-nodes/sample-workflows/*.json ../user/default/workflows/
   

2. 复制示例输入图像（如有）：

   cp comfyui-google-genmedia-custom-nodes/sample-workflows/input-images/* ../input/
   

3. 安装依赖的 ComfyUI 扩展：
   • ComfyUI-VideoHelperSuite（用于视频处理）
   • ComfyUI-Custom-Scripts（用于 UI 增强）
4. 重启 ComfyUI，在左侧 Workflows 菜单中加载示例流程。

⚠️ 注意：部分 Veo3.1 无损视频工作流必须提供 output_gcs_uri（如 gs://your-bucket/）。若未设置，节点将报错提示。

使用提示

• GCP 项目需启用 Vertex AI API，并确保配额充足。
• Veo 视频生成默认时长为 8 秒（Veo3.1 支持 4–8 秒，步长 2）。
• Veo3.1 强制启用 prompt 增强，因此 不支持固定 seed。
• Virtual Try-On 输出自带 SynthID 隐水印（若启用 add_watermark）。
• 所有生成内容受 Google 内容安全策略限制（可配置过滤级别）。