Herramientasn8n
n8n Gemini: conecta tu primer flujo paso a paso
Conecta Gemini y n8n con un ejemplo sencillo: prepara credenciales, configura el nodo, prueba la respuesta y resuelve errores sin exponer datos.
- Autor: humAIns
- 10 min de lectura
índice · 7 apartados
Para conectar Gemini con n8n necesitas una credencial de Google Gemini (PaLM), una clave de Gemini API —salvo que uses Gateway credits en n8n Cloud con un nodo compatible— y un flujo que incluya un modelo de chat. En esta guía crearás una prueba manual que envía un texto ficticio a Gemini y comprueba la respuesta antes de automatizar nada. No hacen falta datos de clientes ni código para seguir los pasos.
Si todavía estás descubriendo la herramienta, primero puedes leer qué es n8n y cómo funciona. Aquí nos centramos en esta integración concreta; para aprender a crear agentes de IA en n8n puedes ampliar después con herramientas y decisiones de agente.
Qué necesitas y qué versión del nodo admite tu instalación
Necesitas acceso de edición a una instancia de n8n, conexión saliente a Internet y acceso a Gemini API. En una instancia autoalojada, quien administre el servidor debe permitir la conexión HTTPS al host de Google. En n8n Cloud, la documentación también indica que el nodo Google Gemini Chat Model puede usar Gateway credits en vez de una clave propia; esa opción depende de que el nodo y la cuenta la ofrezcan.
En n8n hay varios nodos con Gemini. Para este ejemplo usaremos Google Gemini Chat Model, que es un subnodo de modelo: no suele iniciar un flujo por sí solo. Conéctalo a la entrada de modelo de un nodo raíz compatible, por ejemplo Basic LLM Chain. La cadena recibe el texto, lo pasa al modelo y devuelve el resultado. El catálogo de modelos se carga dinámicamente desde Gemini API; por eso la lista que ves depende de los modelos disponibles para tu cuenta y de la versión de la integración.
Los nombres y las pantallas pueden cambiar entre versiones. Si no aparece el subnodo, actualiza la documentación que corresponde a tu versión y busca “Google Gemini Chat Model” en el selector de nodos. No confundas este modelo de chat con el nodo de aplicación Google Gemini, que ofrece operaciones distintas.
Preparar credenciales y acceso de Gemini
La documentación de n8n identifica la credencial como Google Gemini (PaLM) y pide una API key, con el host https://generativelanguage.googleapis.com. Para crear una clave, abre Google AI Studio: API keys, selecciona un proyecto permitido y sigue el proceso que muestre la cuenta. Google documenta que cada clave se asocia a un proyecto de Google Cloud.
Guárdala en n8n como credencial, no dentro de un campo de texto, un prompt o un nodo Set/Edit Fields. En n8n, abre Credentials, crea una credencial nueva de tipo Google Gemini (PaLM) y pega la clave en el campo previsto. Mantén el host predeterminado indicado por n8n; su documentación de esta credencial advierte que los nodos relacionados no admiten cambiar ese host ni configurar un proxy desde esta credencial.
Google está migrando sus claves estándar a claves de autorización: desde el 28 de mayo de 2026, AI Studio crea claves de autorización nuevas por defecto. Google también indica que la API rechaza claves estándar sin restricciones; las claves estándar explícitamente restringidas continúan funcionando. Si tienes una clave antigua, consulta su tipo y estado en AI Studio y sigue la guía oficial de claves Gemini. No pegues una clave en una conversación para pedir ayuda.
Al guardar la credencial, selecciona Test si la interfaz lo permite. Si la prueba no está disponible o falla, aún puedes validar la autenticación ejecutando el workflow con una entrada no sensible y examinando el detalle del error. No publiques capturas con la clave visible.
Montar un flujo con disparador manual y entrada ficticia
Este flujo básico comprueba la conexión sin programar:
- Crea un workflow nuevo y añade Manual Trigger. Así solo se ejecuta cuando tú lo lanzas desde el editor.
- Añade Edit Fields (Set) y crea un campo de texto llamado
consultacon este valor inventado:Resume en una frase: el equipo prepara una exposición de fotografía y necesita ordenar las tareas de montaje.No incluyas nombres reales, presupuestos ni información interna. - Añade Basic LLM Chain después del nodo de entrada. En su prompt, escribe una instrucción breve y coloca el valor de
consultamediante el selector de expresiones de n8n. Por ejemplo: “Resume el texto siguiente en una frase clara. No añadas datos que no aparezcan: [valor de consulta]”. Usa el selector para insertar el campo, en lugar de teclear llaves a mano si no conoces el formato de expresiones. - En la conexión de modelo de Basic LLM Chain, añade Google Gemini Chat Model y selecciona la credencial que acabas de guardar.
- Elige un modelo disponible en el desplegable. Para esta prueba, conserva los parámetros por defecto; no es necesario ajustar temperatura ni tokens.
- Pulsa Execute workflow y abre la salida de la cadena. Comprueba que la respuesta está en una frase y no expone contenido distinto del texto de prueba.
El recorrido debe ser claro: Manual Trigger → Edit Fields → Basic LLM Chain, con Google Gemini Chat Model conectado a la entrada de modelo de la cadena. El subnodo no va en serie como si fuera una acción de aplicación: aporta el modelo que usa la cadena. Si tu editor muestra conectores de distinto tipo, sigue las etiquetas del nodo y la guía oficial, no fuerces una conexión entre puertos incompatibles.
En el subnodo puedes encontrar opciones como Maximum Number of Tokens, Sampling Temperature, Top K, Top P y Safety Settings. Puedes dejarlas sin modificar mientras compruebas que la conexión responde. Una temperatura alta puede producir respuestas más diversas y también aumentar el riesgo de resultados inexactos; no la uses como sustituto de una instrucción clara o de una comprobación humana.
Errores de credenciales, cuota y formato
Si el nodo devuelve un error, abre la ejecución fallida y anota el nombre del nodo, el código o mensaje, la hora y el tipo de prueba. Elimina del registro cualquier fragmento de clave, dato personal o texto confidencial antes de compartirlo.
| Síntoma | Qué comprobar | Siguiente paso |
|---|---|---|
| Error de autenticación o clave inválida | Credencial seleccionada, clave activa y proyecto asociado | Comprueba el estado en AI Studio y vuelve a guardar la credencial en n8n; no copies la clave en el workflow |
| No aparece ningún modelo | Disponibilidad para la cuenta, conexión de red y nodo instalado | Recarga el selector, prueba otro modelo disponible y verifica la versión de n8n |
| Límite o cuota alcanzada | Mensaje exacto de la API y uso de la cuenta | Revisa cuota y condiciones actuales en Google AI Studio; espera o ajusta el uso según lo permitido |
| La cadena no recibe la entrada | Conexiones entre Edit Fields y Basic LLM Chain; campo consulta | Ejecuta cada nodo y confirma que la salida incluye ese campo |
| Respuesta vacía o con formato inesperado | Prompt, salida de la cadena y parámetros del modelo | Prueba con una instrucción más simple y texto ficticio; inspecciona la salida estructurada del nodo |
No asumas que cada error de “rate limit” tiene la misma causa: la respuesta de la API y el estado de uso de tu proyecto son las referencias para diagnosticarlo. Los nombres y límites pueden cambiar. Consulta la documentación de Gemini API y la configuración actual de tu proyecto antes de aumentar la frecuencia de ejecuciones.
Si tu workflow procesa varios elementos, hay una particularidad importante: n8n documenta que en los subnodos las expresiones se resuelven usando el primer elemento, a diferencia de la mayoría de nodos raíz. Prueba expresamente con más de un elemento si ése es tu caso y confirma qué texto llega al modelo; no des por hecho que cada elemento recibió su propio valor.
Privacidad y coste: qué revisar antes de usar datos reales
Un flujo autoalojado no significa que el texto permanezca en tu servidor: el contenido que mandas al modelo se procesa mediante Gemini API. Empieza con valores ficticios, reduce la entrada a los campos imprescindibles y revisa los términos, la configuración de tratamiento y las condiciones aplicables a la cuenta que utilizarás. Para tareas profesionales, acuerda qué información está permitida antes de conectar documentos, clientes o materiales de trabajo.
La clave permite autenticar peticiones y debe tratarse como secreto. Déjala en el almacén de credenciales de n8n, limita quién puede ver o editar workflows y credenciales, evita activarla en capturas y no la escribas en logs. Si sospechas que se expuso, revócala o sustitúyela desde el panel de Google y actualiza la credencial almacenada.
No afirmamos aquí un precio ni un nivel gratuito: pueden depender del modelo, proyecto, región y condiciones vigentes. Separa el coste de n8n del consumo de Gemini y comprueba ambos antes de programar ejecuciones recurrentes. Consulta la página de precios de n8n y la información de uso y facturación de Google para tu proyecto.
Con la conexión probada, puedes decidir si el paso aporta valor a un proceso real: por ejemplo, resumir una descripción de material audiovisual que ya esté aprobada para este uso, con comprobación del resultado antes de incorporarlo al flujo de trabajo. Si te interesa aplicar automatización a tareas de ese ámbito, consulta el programa de IA audiovisual; para priorizar qué aprender según tu punto de partida, prueba el diagnóstico gratuito.
Preguntas frecuentes
¿Necesito una clave de API?
Sí, si usas tu propio acceso de Gemini: crea una clave en Google AI Studio y guárdala en una credencial Google Gemini (PaLM) de n8n. En n8n Cloud, algunos nodos compatibles permiten elegir Gateway credits en lugar de introducir tu propia clave; comprueba que la opción aparece en tu instancia.
¿Funciona en n8n autoalojado?
Sí. Configura la credencial en tu instancia y asegúrate de que el servidor puede conectarse al host predeterminado generativelanguage.googleapis.com. Revisa también la versión y disponibilidad del nodo que tengas instalado.
¿Qué revisar si falla el nodo?
Empieza por la credencial y el host; después confirma que el modelo está disponible y lee el error exacto de la ejecución. Si el mensaje apunta a cuota o límite, consulta el uso del proyecto en AI Studio. Registra el error sin incluir claves ni datos confidenciales.
¿Cómo evito enviar datos confidenciales?
Usa texto de prueba inventado, limita los campos del prompt y no conectes fuentes reales hasta haber verificado las reglas internas y las condiciones aplicables de Google. Que n8n esté autoalojado no evita que los datos enviados a Gemini salgan de esa infraestructura.
Fuentes oficiales
- Google Gemini Chat Model en n8n: parámetros, modelos, opciones y comportamiento de expresiones en subnodos.
- Credenciales de Google Gemini (PaLM) en n8n: host, API key y requisitos de autenticación.
- Claves de Gemini API en Google AI: tipos, creación y seguridad de claves.
- Qué es n8n, agentes de IA con n8n y automatización con IA: guías relacionadas para ampliar el caso de uso.