# 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

===================================================================