358 lines
6.0 KiB
Markdown
358 lines
6.0 KiB
Markdown
# ComfyUI\_Gemini\_3\_Pro\_API\_node
|
|
|
|
Gemini\_3\_Pro\_API\_node for ComfyUI
|
|
===================================================================
|
|
|
|
GEMINI IMAGE GENERATION NODE - INSTALLATION GUIDE
|
|
|
|
===================================================================
|
|
|
|
|
|
|
|
This custom node allows you to generate images using Google's Gemini API
|
|
|
|
directly within ComfyUI, supporting resolutions up to 4K.
|
|
|
|
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
QUICK START - COPY \& PASTE THESE COMMANDS
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
|
|
|
|
1\. Navigate to your ComfyUI directory in terminal/command prompt
|
|
|
|
|
|
|
|
2\. For Windows (PowerShell or CMD):
|
|
|
|
|
|
|
|
cd C:\\Users\\\[YourUsername]\\Documents\\ComfyUI
|
|
|
|
.venv\\Scripts\\activate
|
|
|
|
pip install --upgrade google-genai
|
|
|
|
|
|
|
|
3\. For Linux/Mac:
|
|
|
|
|
|
|
|
cd ~/ComfyUI
|
|
|
|
source venv/bin/activate
|
|
|
|
pip install --upgrade google-genai
|
|
|
|
|
|
|
|
4\. Verify installation (optional):
|
|
|
|
|
|
|
|
pip show google-genai
|
|
|
|
|
|
|
|
5\. Set API key as environment variable (recommended):
|
|
|
|
|
|
|
|
Windows (PowerShell):
|
|
|
|
$env:GOOGLE\_API\_KEY="YOUR\_API\_KEY\_HERE"
|
|
|
|
|
|
|
|
Windows (CMD):
|
|
|
|
set GOOGLE\_API\_KEY=YOUR\_API\_KEY\_HERE
|
|
|
|
|
|
|
|
Linux/Mac:
|
|
|
|
export GOOGLE\_API\_KEY="YOUR\_API\_KEY\_HERE"
|
|
|
|
|
|
|
|
6\. Restart ComfyUI
|
|
|
|
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
REQUIREMENTS
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
|
|
|
|
\- ComfyUI installed and working
|
|
|
|
\- Python 3.8 or higher
|
|
|
|
\- Google AI Studio API key (free tier available)
|
|
|
|
\- Internet connection
|
|
|
|
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
INSTALLATION STEPS
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
|
|
|
|
1\. INSTALL THE NODE
|
|
|
|
|
|
|
|
Copy the "Google Gemini API" folder to your ComfyUI custom nodes directory:
|
|
|
|
|
|
|
|
Windows:
|
|
|
|
C:\\Users\\\[YourUsername]\\Documents\\ComfyUI\\custom\_nodes\\
|
|
|
|
|
|
|
|
Linux/Mac:
|
|
|
|
~/ComfyUI/custom\_nodes/
|
|
|
|
|
|
|
|
2\. INSTALL PYTHON DEPENDENCIES
|
|
|
|
|
|
|
|
Open a terminal/command prompt and navigate to your ComfyUI directory, then run:
|
|
|
|
|
|
|
|
Windows (PowerShell):
|
|
|
|
.\\venv\\Scripts\\activate
|
|
|
|
pip install --upgrade google-genai
|
|
|
|
|
|
|
|
Linux/Mac:
|
|
|
|
source venv/bin/activate
|
|
|
|
pip install --upgrade google-genai
|
|
|
|
|
|
|
|
IMPORTANT: You need google-genai version 1.51.0 or higher for 4K support.
|
|
|
|
|
|
|
|
To verify the version:
|
|
|
|
pip show google-genai
|
|
|
|
|
|
|
|
3\. GET YOUR GOOGLE API KEY
|
|
|
|
|
|
|
|
a) Go to: https://aistudio.google.com/app/apikey
|
|
|
|
b) Sign in with your Google account
|
|
|
|
c) Click "Create API Key"
|
|
|
|
d) Copy the generated key (starts with "AIza...")
|
|
|
|
|
|
|
|
BILLING NOTE: Image generation requires billing to be enabled.
|
|
|
|
- Free tier has ZERO quota for image generation
|
|
|
|
- You MUST enable billing at: https://console.cloud.google.com/billing
|
|
|
|
- Set up budget alerts to avoid unexpected charges
|
|
|
|
|
|
|
|
4\. CONFIGURE THE NODE
|
|
|
|
|
|
|
|
Option A: In ComfyUI Node
|
|
|
|
- Paste your API key directly into the "api\_key" field
|
|
|
|
|
|
|
|
Option B: Environment Variable (Recommended for security)
|
|
|
|
- Set GOOGLE\_API\_KEY environment variable
|
|
|
|
- The node will automatically use it if the field says "INSERT\_API\_KEY\_HERE"
|
|
|
|
|
|
|
|
Windows (PowerShell):
|
|
|
|
$env:GOOGLE\_API\_KEY="YOUR\_API\_KEY\_HERE"
|
|
|
|
|
|
|
|
Linux/Mac:
|
|
|
|
export GOOGLE\_API\_KEY="YOUR\_API\_KEY\_HERE"
|
|
|
|
|
|
|
|
5\. RESTART COMFYUI
|
|
|
|
|
|
|
|
After installing dependencies, restart ComfyUI completely.
|
|
|
|
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
NODE FEATURES
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
|
|
|
|
\- Models:
|
|
|
|
\* gemini-3-pro-image-preview (recommended, supports 4K)
|
|
|
|
\* gemini-2.5-flash-image
|
|
|
|
|
|
|
|
\- Resolutions:
|
|
|
|
\* 1K: ~1024 pixels
|
|
|
|
\* 2K: ~2048 pixels
|
|
|
|
\* 4K: ~4096 pixels (e.g., 5504x3072 for 16:9)
|
|
|
|
|
|
|
|
\- Aspect Ratios:
|
|
|
|
\* 1:1, 16:9, 4:3, 3:4, 9:16, 2:3, 3:2, 4:5, 5:4, 21:9
|
|
|
|
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
BUDGET PROTECTION
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
|
|
|
|
To avoid unexpected charges, set up a budget alert:
|
|
|
|
|
|
|
|
1\. Go to: https://console.cloud.google.com/billing
|
|
|
|
2\. Select your billing account
|
|
|
|
3\. Click "Budgets \& alerts" (left menu)
|
|
|
|
4\. Click "Create Budget"
|
|
|
|
5\. Set monthly limit (e.g., $5 or $10)
|
|
|
|
6\. Enable email alerts at 50%, 90%, 100%
|
|
|
|
|
|
|
|
Image generation costs vary by resolution. 4K images cost more than 1K.
|
|
|
|
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
TROUBLESHOOTING
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
|
|
|
|
ERROR: "RESOURCE\_EXHAUSTED" or "429" error
|
|
|
|
SOLUTION: Enable billing for your Google Cloud project. Free tier has
|
|
|
|
zero quota for image generation.
|
|
|
|
|
|
|
|
ERROR: "GenerateContentResponse object has no attribute 'parts'"
|
|
|
|
SOLUTION: Outdated SDK. Run: pip install --upgrade google-genai
|
|
|
|
|
|
|
|
ERROR: "Image object has no attribute 'mode'"
|
|
|
|
SOLUTION: Update GeminiImageGen.py to latest version from this folder.
|
|
|
|
|
|
|
|
ERROR: "ImageConfig not found"
|
|
|
|
SOLUTION: Upgrade google-genai to 1.51.0+: pip install --upgrade google-genai
|
|
|
|
|
|
|
|
ERROR: Images always 1K regardless of setting
|
|
|
|
SOLUTION: Ensure google-genai is version 1.51.0 or higher.
|
|
|
|
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
SUPPORT
|
|
|
|
-------------------------------------------------------------------
|
|
|
|
|
|
|
|
For issues with:
|
|
|
|
\- This node: Check the GeminiImageGen.py file for updates
|
|
|
|
\- Gemini API: https://ai.google.dev/gemini-api/docs/image-generation
|
|
|
|
\- Billing: https://console.cloud.google.com/billing
|
|
|
|
|
|
|
|
===================================================================
|
|
|
|
Last Updated: 2025-11-20
|
|
|
|
===================================================================
|
|
|
|
|
|
|