- Home
- Resources
- Integrations
- Google Gemini
n8n Google Gemini nodeConfigure Google Gemini in n8n.
The n8n Google Gemini node puts text, image, audio, video and document work inside a workflow. It ships 15 operations spread over 7 resources, from Message a Model to File Search stores for RAG. One Google AI credential covers all of them. Built for anyone wiring Gemini into an automation.
Verified Trustpilot reviews · AI, automation & growth agency
What does the n8n Google Gemini node actually do?
The node calls Google Gemini models from inside a workflow and hands the answer back as regular n8n data. It runs like any action node: one execution per incoming item, no sub-node ports to wire underneath it. Pick a resource (Text, Image, Audio, Video, Document, Media File, File Search), pick an operation, and the panel shows only the fields that operation needs.
Three things people build with it, over and over. First, a text step: text.message takes a prompt plus an optional System Message and returns a completion, which is what you want when a workflow needs a summary, a classification or a rewritten paragraph before the next node. Turn on Output Content as JSON and the result slots straight into a spreadsheet row or an API payload.
Second, media understanding. image.analyze, audio.analyze, video.analyze and document.analyze all take a URL or a binary field from the previous node and answer a question about it. An invoice PDF arriving in Gmail can be described, then the answer written to Google Sheets and posted into Slack. Transcription has its own operation, audio.transcribe, with Start Time and End Time to cut a long recording down to the part that matters.
Third, generation and retrieval. image.generate and video.generate create files from a prompt, image.edit reworks images you supply, and the File Search resource builds stores for Retrieval Augmented Generation, meaning the model answers from documents you uploaded rather than from memory alone.
When to reach for something else. This node answers once per item and stops. If the job needs the model to pick tools, loop and keep context between messages, the AI Agent node with a chat model sub-node underneath it is the right shape, and a sub-node is simply a node that plugs into a port of a root node instead of running on its own. If the point is to compare providers, the OpenAI node covers the same kinds of media work, and Perplexity covers search-flavored prompting.
The limits worth knowing up front. Code Execution and Duration (Seconds) are supported only by certain models. fileSearch.listStores pages its results, so a long list needs Page Token to continue. video.download only works against a URL the Gemini API returned, which is why video.generate offers Return As set to url. Google bills its own API calls under its own terms; n8n adds nothing on top.
What does it take to connect the node?
- 01
Create the Google AI credential
The node reads its access from a Google AI credential, which is the record n8n keeps for your Google API key. Open the Credentials menu in n8n, create the Google AI credential and save it. It is created once and reused by every workflow that talks to Gemini, so a key rotation happens in one place instead of node by node.
- 02
Or switch to Gateway credits on n8n Cloud
On n8n Cloud there is a second route: select Use Gateway credits in the credential field of the node, and it runs without a Google account and without a key of your own. Handy for a first test, or for a workflow that has to ship before anyone has opened a Google API console. Everything else on the node behaves the same way.
- 03
Pick the credential, then the model
Back in the node, select the credential you just saved in its credential field, then choose the resource and the operation you need. The analysis and generation operations expect a Model, and it is a required field: leave it empty and n8n stops the node before the call goes out. Run the step once on real data to confirm the answer comes back.
Which Google Gemini operations can n8n run?
The Google Gemini node exposes 15 operations across 7 resources. For each one: the node as you configure it in n8n, the required fields, and our field notes.
| Resource | Analyze Audio | Create File Search Store | Delete File Search Store | Download Video | Edit Image | Generate an Image | List File Search Stores | Message a Model | Transcribe a Recording | Upload Media File | Upload to File Search Store |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Audio | ✓ | ✓ | |||||||||
| Document | ✓ | ||||||||||
| File Search | ✓ | ✓ | ✓ | ✓ | |||||||
| Image | ✓ | ✓ | ✓ | ||||||||
| Media File | ✓ | ||||||||||
| Text | ✓ | ||||||||||
| Video | ✓ | ✓ | ✓ |
Operations index
Audio
2 operationsAnalyze audio
audio.analyzeWhat you see in n8n
Notes & use cases
Sends one or more audio files to a Gemini model with a question, and returns the model's answer as text. Good for describing what a recording contains without reading a full transcript.
Key parameters
- Model: the Gemini model that handles the request, required, chosen from the list or set by expression.
- Input Type:
urlfor URL(s), orbinaryfor Input Data Field Name(s), with several values separated by commas. - Length of Description (Max Tokens): fewer tokens give a shorter, less detailed audio description.
Transcribe a recording
audio.transcribeWhat you see in n8n
Notes & use cases
Turns audio into text. Unlike the analyze operation there is no question to ask: the output is the spoken content itself, ready for search, storage or a second model call.
Key parameters
- Model: required, the model that performs the transcription.
- URL(s): one or several audio addresses separated by commas, or Input Data Field Name(s) when the file arrives as binary data.
- Start Time and End Time: bounds in
MM:SSorHH:MM:SS, so a two hour webinar can be reduced to the segment you care about.
Document
1 operationAnalyze document
document.analyzeWhat you see in n8n
Notes & use cases
Feeds a document to the model and answers a question about it, so a PDF stops being an opaque attachment and becomes fields the workflow can use.
Key parameters
- Text Input: the question, for example what the document contains or which totals it shows.
- URL(s): the document addresses, often
{{ $json.fileUrl }}from the node before. - Simplify Output: on, the node returns a trimmed response instead of the raw payload.
File Search
4 operationsCreate a File Search store
fileSearch.createStoreWhat you see in n8n
Notes & use cases
Creates an empty File Search store, the container Gemini uses for Retrieval Augmented Generation: the model answers from documents you uploaded rather than from its training alone.
Key parameters
- Display Name: required, a human-readable name for the store, which is how you recognize it later in the list.
Delete a File Search store
fileSearch.deleteStoreWhat you see in n8n
Notes & use cases
Removes a store and, optionally, everything inside it. The operation is the cleanup counterpart of the create step, useful when stores are built per project and thrown away at the end.
Key parameters
- File Search Store Name: required, the full name in the format
fileSearchStores/..., not the display name. - Force Delete: on, related documents and objects go too; off, the deletion fails when the store still holds documents.
List all File Search stores
fileSearch.listStoresWhat you see in n8n
Notes & use cases
Returns the File Search stores owned by the account, which is how a workflow finds the full store name it needs before uploading or deleting.
Key parameters
- Page Size: how many stores come back per page, up to a maximum of 20.
- Page Token: the token from a previous page, used to fetch the next one; without it the workflow only ever sees the first page.
Upload a file to a File Search store
fileSearch.uploadToStoreWhat you see in n8n
Notes & use cases
Adds a file to an existing store so the model can cite it later. This is the operation that actually makes a RAG setup useful, once the store exists.
Key parameters
- File Search Store Name: required, the full
fileSearchStores/...name of the target store. - File Display Name: required, and worth care because it shows up in citations.
- Input Type:
urlto point at URL, orbinaryto read the file from Input Data Field Name.
Image
3 operationsAnalyze an image
image.analyzeWhat you see in n8n
Notes & use cases
Asks a question about one or more images and returns the answer as text, which is how a workflow reads a screenshot, a photo or a scanned page.
Key parameters
- Text Input: what to ask, for instance what the picture shows or whether a label is present.
- URL(s): image addresses, several separated by commas, or Input Data Field Name(s) for binary fields.
- Length of Description (Max Tokens): caps the answer, fewer tokens meaning a shorter image description.
Generate an image
image.generateWhat you see in n8n
Notes & use cases
Creates images from a written description and returns them as binary data the workflow can store or send. No input file is involved here, only the prompt.
Key parameters
- Prompt: the text description of the image you want, as concrete as possible.
- Number of Images: how many variants come back in one run.
- Put Output in Field: the name of the output field that carries the binary file data, which the next node then reads.
Edit an image
image.editWhat you see in n8n
Notes & use cases
Takes images you already have and reworks them according to an instruction, so the starting point is your own asset rather than a blank prompt.
Key parameters
- Prompt: the instruction describing the edit, such as combining the first image with the second.
- Images: the collection where you add one or more binary fields to send along with the prompt.
- Binary Field Name: the field holding the image data, when the default name does not match what the previous node produced.
Media File
1 operationUpload a media file
file.uploadWhat you see in n8n
Notes & use cases
Pushes a file to the Google Gemini API and keeps it there for later use, which saves resending the same large asset on every call.
Key parameters
- Input Type:
urlto fetch from URL, orbinaryto take the file from the workflow itself. - Input Data Field Name: the binary property carrying the file, typically
datawhen it comes from a download node.
Text
1 operationMessage a model
text.messageWhat you see in n8n
Notes & use cases
The plain text operation: a completion from a Gemini model, with the widest set of options on the node.
Key parameters
- Messages: the conversation you send, each entry carrying a Prompt and a Role,
userto ask,modelto set a tone or personality. - System Message: standing instructions that apply to the whole call.
- Output Randomness (Temperature): lower it for repeatable answers, raise it when variety is the point.
- Thinking Budget:
0disables automatic thinking,-1leaves it dynamic.
Video
3 operationsAnalyze video
video.analyzeWhat you see in n8n
Notes & use cases
Answers questions about video content, which turns a file nobody has time to watch into a few usable sentences.
Key parameters
- Text Input: the question put to the model about the footage.
- URL(s): video addresses, comma separated for several at once, or Input Data Field Name(s) for binary input.
- Simplify Output: on, the response comes back trimmed rather than raw.
Generate a video
video.generateWhat you see in n8n
Notes & use cases
Builds a video from a written prompt. Generation takes longer than an image, so the operation lets you choose how the result comes back.
Key parameters
- Prompt: the description of the shot you want.
- Return As:
videofor a binary file in the workflow,urlfor an address you can download later. - Aspect Ratio:
16:9for screens,9:16for short-form vertical. - Person Generation:
dont_allow,allow_adultorallow_all, depending on what the brand accepts.
Download a video
video.downloadWhat you see in n8n
Notes & use cases
Fetches a generated video from the Google Gemini API using the address the API gave you, and brings the file into the workflow as binary data.
Key parameters
- URL: the Gemini API address to download from, usually
{{ $json.url }}carried over from the generation step. - Put Output in Field: the output field that receives the binary file data.
Need help automating Google Gemini with n8n?
A person reads every message.
Google Gemini and n8n: common questions
01Is the Google Gemini node included in n8n?
02What credentials does the n8n Google Gemini node need?
03What are the limits of the Google Gemini node?
04When to use this node instead of the AI Agent node?
05n8n or Make for Google Gemini work?
Get our weekly integration tips.
No spam. Unsubscribe anytime.

