Enjoy Google Gemini API for ComfyUI generate images, transcribe audio, sumarize videos. Making a separate implemetation of my old IF_AI tools for easy installation

• Text Generation: Create content, answer questions, and generate creative text formats

• Image Analysis: Describe, analyze, and extract information from images

• Image Generation: Generate images with Gemini's image generation capabilities

• Multi-Modal Input: Combine text and images in your prompts

• Customizable Parameters: Control temperature, output tokens, and other generation settings

• Chat Mode: Maintain conversation history for interactive sessions

• Batch Processing: Generate multiple outputs with a single prompt

• ** URL PROXY ** Users can now configure a custom Gemini API endpoint in three ways:

  1. Environment variable: export GEMINI_BASE_URL='https://your-proxy.com/gemini/v1'
  2. In .env file: GEMINI_BASE_URL=https://your-proxy.com/gemini/v1
  3. In shell config (.bashrc/.zshrc): export GEMINI_BASE_URL='https://your-proxy.com/gemini/v1'

🚀 Usage Examples

Method 1 - Environment Variables: export OPENROUTER_API_KEY="sk-or-v1-your-key" export OPENROUTER_PROXY="true"

Method 2 - Direct Configuration: export OPENROUTER_API_KEY="sk-or-v1-your-key" export GEMINI_BASE_URL="https://openrouter.ai/api/v1"

Method 3 - External API Key: Just paste your OpenRouter key into the external_api_key field and use OpenRouter model names.

🎨 Free Image Model Access

Use model: google/gemini-2.5-flash-image-preview:free for completely free image analysis through OpenRouter!

🔧 Files Modified

• env_utils.py - Enhanced base URL and API key detection
• gemini_node.py - Added OpenRouter client support and model names
• OPENROUTER_README.md - Complete documentation
• example.env - Configuration template

1. Clone this repository into your ComfyUI custom nodes folder:

cd ComfyUI/custom_nodes git clone https://github.com/if-ai/ComfyUI-IF_Gemini

2. Install the required Python packages:

cd ComfyUI-IF_Gemini pip install -r requirements.txt

4. Restart ComfyUI to load the new node

The Gemini node appears in the "ImpactFrames💥🎞️/LLM" category in the ComfyUI node browser.

3. Restart ComfyUI

4. Add your Gemini API key using one of these methods:

   • Shell configuration file (recommended for macOS/Linux):

     # In ~/.zshrc, ~/.bashrc, or ~/.bash_profile: export GEMINI_API_KEY=your_api_key_here

     Then restart your terminal or run source ~/.zshrc (or relevant file)

   • System environment variable:

     export GEMINI_API_KEY=your_api_key

   • Directly in the node: Enter your API key in the "external_api_key" field

   • In a .env file in the custom node directory:

     GEMINI_API_KEY=your_api_key 

5. Add the "IF LLM Gemini AI" node to your workflow

6. Verify your API key using the "Verify API Key" button in the node

7. Configure the node:

   • For text generation, set "operation_mode" to "analysis" or "generate_text"
   • For image generation, set "operation_mode" to "generate_images"
   • Connect reference images (optional) for style-based generation

8. Set additional parameters as needed:

   • Prompt: Your text instructions
   • Model version: Select appropriate Gemini model
   • Temperature: Controls randomness (0.0-1.0)
   • Seed: For reproducible results

• If you encounter API key errors, use the "Verify API Key" button to check its validity
• For image safety errors, try modifying your prompt to avoid content that may trigger safety filters
• Ensure your Gemini API has appropriate quotas for your usage

MIT

If you find this tool useful, please consider supporting my work by:

• Starring this repo on GitHub
• Subscribing to my YouTube channel: Impact Frames
• Follow me on X: Impact Frames X
• Supporting me on Ko-fi: Impact Frames Ko-fi
• Becoming a patron on Patreon: Impact Frames Patreon Thank You!