node-red-contrib-gemini

A comprehensive Node-RED package providing nodes for Google's Gemini AI models, covering text generation, chat, vision, image generation, audio understanding, and speech synthesis.

Included Nodes

- gemini-generate-content: Text generation, multi-turn chat, and vision analysis.
- gemini-image-generate: Create and edit images (Imagen 3 / Gemini).
- gemini-speech-generate: High-quality text-to-speech synthesis.
- gemini-audio-understand: Transcription and analysis of audio files.
- gemini-api-key: Secure API credential management.

Quick Start

1. Install: Search for node-red-contrib-gemini in the Node-RED Palette Manager.
2. Get Key: Obtain a an API key from Google AI Studio.
3. Configure: Check the API Key configuration node and paste your key.
4. Select Model: In any node, click the Fetch Models (refresh) button to load the latest available models directly from Google.

Key Features

- Dynamic Model Fetching: Automatically access new models as they are released without package updates.
- Multimodal Support: Seamlessly handle text, images, video, and audio.
- Mustache Templating: Use {{msg.payload}} or {{msg.topic}} in prompts and text fields.
- Advanced Options: Support for Google Search Grounding, Streaming responses, and JSON/Enum output.
- Output Control: Send results to msg.payload, files, or custom properties.

Examples

Text Generation with Grounding & Structured Output

``json [ { "id": "e8a423a769b8dec0", "type": "gemini-generate-content", "z": "a6c480dcb27b87bd", "g": "7c41675671016995", "name": "", "apiKey": "fe0d58f14ac27f69", "modelSelection": "gemini-3-flash-preview", "customModel": "", "customModelType": "str", "mode": "single", "prompt": "Does the movie {{msg.payload.movie}} have an after credits scene? Answer as briefly as possible. ", "promptType": "str", "multimodalInputsData": "[]", "grounding": true, "temperature": "1", "temperatureType": "num", "topP": "0.95", "topPType": "num", "topK": "64", "topKType": "num", "maxOutputTokens": "8192", "maxOutputTokensType": "num", "safetyHarassment": "BLOCK_MEDIUM_AND_ABOVE", "safetyHateSpeech": "BLOCK_MEDIUM_AND_ABOVE", "safetySexuallyExplicit": "BLOCK_MEDIUM_AND_ABOVE", "safetyDangerousContent": "BLOCK_MEDIUM_AND_ABOVE", "thinkingBudget": "-1", "thinkingBudgetType": "num", "thinkingLevel": "", "thinkingLevelType": "str", "includeThoughts": false, "systemInstruction": "", "systemInstructionType": "str", "outputProperty": "msg.payload.details", "passthroughProperties": false, "responseFormat": "json", "schemaPropertiesData": "[{\"name\":\"afterCredits\",\"type\":\"BOOLEAN\",\"required\":true},{\"name\":\"details\",\"type\":\"STRING\",\"required\":true},{\"name\":\"sourceURL1\",\"type\":\"STRING\",\"required\":true},{\"name\":\"sourceURL2\",\"type\":\"STRING\",\"required\":false}]", "enumValues": "", "x": 650, "y": 500, "wires": [ [ "14a2617d6e1c1a49" ], [ "14a2617d6e1c1a49" ] ] }, { "id": "0553c65f94a35371", "type": "inject", "z": "a6c480dcb27b87bd", "g": "7c41675671016995", "name": "Send movie example (structured output + grounding)", "props": [ { "p": "payload.movie", "v": "The Long Walk", "vt": "str" } ], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "x": 310, "y": 500, "wires": [ [ "e8a423a769b8dec0" ] ] }, { "id": "14a2617d6e1c1a49", "type": "debug", "z": "a6c480dcb27b87bd", "g": "7c41675671016995", "name": "Text generate (grounding + search) debug", "active": true, "tosidebar": true, "console": false, "tostatus": false, "complete": "true", "targetType": "full", "statusVal": "", "statusType": "auto", "x": 1020, "y": 500, "wires": [] }, { "id": "fe0d58f14ac27f69", "type": "gemini-api-key", "name": "node-red-free" }, { "id": "90b01cfcf7ce8cba", "type": "global-config", "env": [], "modules": { "node-red-contrib-gemini": "1.0.2" } } ]`


Image Generation & Editing

`json [{"id":"be4d6ff6a36494ee","type":"group","z":"a6c480dcb27b87bd","style":{"stroke":"#999999","stroke-opacity":"1","fill":"none","fill-opacity":"1","label":true,"label-position":"nw","color":"#a4a4a4"},"nodes":["6fc837881ae39da0","c48c713b1208e241","a7f861aa9e06a8bb","a773e54e40b4e08b","f877c30efdbbeeeb","18ea36bf88be42b6","ea909ae5b69bfe15"],"x":64,"y":739,"w":1562,"h":262},{"id":"6fc837881ae39da0","type":"gemini-image-generate","z":"a6c480dcb27b87bd","g":"be4d6ff6a36494ee","name":"Generate Image","apiKey":"86f1d6e41a7140a9","modelSelection":"gemini-2.5-flash-image","customModel":"","customModelType":"str","prompt":"Generate an image of Scooby Doo having fun with his best friend, a green banana. They should be in a jurassic era volcanic setting with dinosaurs lurking","promptType":"str","numberOfImages":"1","numberOfImagesType":"num","aspectRatio":"1:1","outputFormat":"base64","saveDirectory":"","saveDirType":"str","mode":"generate","inputFile":"","inputFileType":"str","outputProperty":"msg.inputImages","systemInstruction":"","systemInstructionType":"str","responseModalities":"image","safetyHarassment":"BLOCK_MEDIUM_AND_ABOVE","safetyHateSpeech":"BLOCK_MEDIUM_AND_ABOVE","safetySexuallyExplicit":"BLOCK_MEDIUM_AND_ABOVE","safetyDangerousContent":"BLOCK_MEDIUM_AND_ABOVE","x":440,"y":800,"wires":[[["c48c713b1208e241","ea909ae5b69bfe15","a773e54e40b4e08b"],["ea909ae5b69bfe15"]]]},{"id":"c48c713b1208e241","type":"image viewer","z":"a6c480dcb27b87bd","g":"be4d6ff6a36494ee","name":"","width":"580","data":"inputImages","dataType":"msg","active":true,"x":930,"y":780,"wires":[[]]},{"id":"a7f861aa9e06a8bb","type":"inject","z":"a6c480dcb27b87bd","g":"be4d6ff6a36494ee","name":"Test image gen and edit","props":[],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","x":210,"y":800,"wires":[["6fc837881ae39da0"]]},{"id":"a773e54e40b4e08b","type":"gemini-image-generate","z":"a6c480dcb27b87bd","g":"be4d6ff6a36494ee","name":"Modify Image","apiKey":"86f1d6e41a7140a9","modelSelection":"gemini-2.5-flash-image","customModel":"","customModelType":"str","prompt":"Add a spooky jack o' lantern on top of scooby's head","promptType":"str","numberOfImages":"1","numberOfImagesType":"num","aspectRatio":"1:1","outputFormat":"base64","saveDirectory":"","saveDirType":"str","mode":"edit","inputFile":"","inputFileType":"str","outputProperty":"payload","systemInstruction":"","systemInstructionType":"str","responseModalities":"image","safetyHarassment":"BLOCK_MEDIUM_AND_ABOVE","safetyHateSpeech":"BLOCK_MEDIUM_AND_ABOVE","safetySexuallyExplicit":"BLOCK_MEDIUM_AND_ABOVE","safetyDangerousContent":"BLOCK_MEDIUM_AND_ABOVE","x":500,"y":960,"wires":[[["f877c30efdbbeeeb","18ea36bf88be42b6"],["f877c30efdbbeeeb"]]]},{"id":"f877c30efdbbeeeb","type":"debug","z":"a6c480dcb27b87bd","g":"be4d6ff6a36494ee","name":"image 2 debug","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":760,"y":860,"wires":[]},{"id":"18ea36bf88be42b6","type":"image viewer","z":"a6c480dcb27b87bd","g":"be4d6ff6a36494ee","name":"","width":"580","data":"payload","dataType":"msg","active":true,"x":1530,"y":780,"wires":[[]]},{"id":"ea909ae5b69bfe15","type":"debug","z":"a6c480dcb27b87bd","g":"be4d6ff6a36494ee","name":"image 1 debug","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":760,"y":820,"wires":[]},{"id":"86f1d6e41a7140a9","type":"gemini-api-key","name":"node-red-paid"}]`


Audio Generation & Understanding

`json [ { "id": "eba78a6484fd41a0", "type": "gemini-speech-generate", "z": "a6c480dcb27b87bd", "g": "e853ab82cdb9436c", "name": "", "apiKey": "fe0d58f14ac27f69", "model": "gemini-2.5-flash-preview-tts", "text": "james: Hello! I have no idea what I'm doing. blueman: This is a test of the multi-speaker generation with gemini in node-red", "textType": "str", "speakerMode": "multi", "voiceName": "", "speaker1Name": "james", "speaker1Voice": "Achernar", "speaker2Name": "blueman", "speaker2Voice": "Iapetus", "outputFormat": "buffer", "saveDirectory": "", "saveDirType": "str", "filename": "itsatest2", "filenameType": "str", "systemInstruction": "", "systemInstructionType": "str", "maxOutputTokens": "", "maxOutputTokensType": "num", "outputProperty": "msg.audioData", "passthroughProperties": false, "x": 590, "y": 660, "wires": [ [ "f06072a81460fba7", "7e5e2bc15661e2c7" ], [ "f06072a81460fba7" ] ] }, { "id": "ec11788db1f8ad68", "type": "inject", "z": "a6c480dcb27b87bd", "g": "e853ab82cdb9436c", "name": "Geenrate audio and then understand it example", "props": [ { "p": "payload" }, { "p": "topic", "vt": "str" } ], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "payload": "", "payloadType": "date", "x": 280, "y": 660, "wires": [ [ "eba78a6484fd41a0" ] ] }, { "id": "f06072a81460fba7", "type": "debug", "z": "a6c480dcb27b87bd", "g": "e853ab82cdb9436c", "name": "Speech generate debug", "active": true, "tosidebar": true, "console": false, "tostatus": false, "complete": "true", "targetType": "full", "statusVal": "", "statusType": "auto", "x": 970, "y": 660, "wires": [] }, { "id": "7e5e2bc15661e2c7", "type": "gemini-audio-understand", "z": "a6c480dcb27b87bd", "g": "e853ab82cdb9436c", "name": "", "apiKey": "fe0d58f14ac27f69", "model": "gemini-2.5-flash", "prompt": "Transcribe this for me, identifying individual speakers", "promptType": "str", "audioFile": "", "audioFileType": "str", "systemInstruction": "", "systemInstructionType": "str", "temperature": "", "temperatureType": "num", "topP": "", "topPType": "num", "topK": "", "topKType": "num", "maxOutputTokens": "", "maxOutputTokensType": "num", "safetyHarassment": "BLOCK_MEDIUM_AND_ABOVE", "safetyHateSpeech": "BLOCK_MEDIUM_AND_ABOVE", "safetySexuallyExplicit": "BLOCK_MEDIUM_AND_ABOVE", "safetyDangerousContent": "BLOCK_MEDIUM_AND_ABOVE", "outputFormat": "text", "saveDirectory": "", "saveDirType": "str", "outputProperty": "payload", "passthroughProperties": false, "x": 890, "y": 600, "wires": [ [ "887cf6ec214ba54b" ], [ "887cf6ec214ba54b" ] ] }, { "id": "887cf6ec214ba54b", "type": "debug", "z": "a6c480dcb27b87bd", "g": "e853ab82cdb9436c", "name": "Audio understand debug", "active": true, "tosidebar": true, "console": false, "tostatus": false, "complete": "true", "targetType": "full", "statusVal": "", "statusType": "auto", "x": 1210, "y": 600, "wires": [] }, { "id": "fe0d58f14ac27f69", "type": "gemini-api-key", "name": "node-red-free" }, { "id": "5033da0e83edc623", "type": "global-config", "env": [], "modules": { "node-red-contrib-gemini": "1.0.2" } } ]``

Disclaimer

This package was written with Claude Code. I'm not a developer by trade and am new to Git as a whole. This is also my first node-red package. I had a use for interfacing with Gemini in my node-red setup and wanted a better way of doing it. I tried to add features that I thought may be useful to a broader audience. I'll do my best to support this and keep it functional. I hope it's able to make your flows a little bit more robust :)

Instructions were given to stay within the confines of the Gemini API documentation https://ai.google.dev/gemini-api/docs as well as the Node.js SDK written by Google https://github.com/googleapis/js-genai. It was built against SDK version 1.27.0.

License