Recursos · Integración n8n

Nodo OpenAI n8nConfigura OpenAI en n8n.

El nodo OpenAI convierte una llamada a un modelo en un paso más del flujo. Reúne 16 operaciones repartidas en 6 recursos: texto, imagen, audio, archivo, conversación y vídeo. El nodo OpenAI n8n se ejecuta sobre cada item de entrada, como cualquier nodo de acción, así que encaja en una cadena y no en un chat.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve el nodo OpenAI n8n?

Este nodo hace de puente entre un flujo de trabajo y la API de OpenAI. Primero un recurso (Text, Image, Audio, File, Conversation, Video), después una de las 16 operaciones disponibles: hecha la elección, n8n arma la petición con la credencial guardada, un identificador que n8n mantiene fuera del flujo, y entrega la respuesta al nodo siguiente. Como procesa un item por ejecución, 40 filas de entrada generan 40 llamadas independientes.

Hay tres formas de trabajo que cubren casi todo. Texto en cadena: llega una fila desde Google Sheets, text.response redacta el resumen y el resultado vuelve a la hoja. Producción de medios: image.generate crea un visual a partir de un prompt, audio.generate lee un guion en voz alta, video.generate genera un clip corto, y cada una devuelve un archivo binario que el resto del flujo guarda o envía. Y tratamiento de lo que entra: audio.transcribe pasa un mensaje de voz a texto, image.analyze responde a una pregunta sobre un adjunto, text.classify marca el contenido que se sale de las políticas de uso antes de que lo lea nadie.

La conversación es la pieza que casi todos se saltan. conversation.create abre un hilo, y una respuesta de modelo se engancha a él con la opción Conversation ID: así la segunda llamada sabe qué dijo la primera. Sin eso, cada ejecución empieza desde cero. Perfecto para clasificar, un problema en un hilo de soporte que dura varios mensajes.

Conviene saber cuándo este nodo no es la respuesta. Si el modelo tiene que decidir por su cuenta la acción siguiente, el nodo AI Agent hace de nodo raíz, con subnodos enchufados a sus puertos (un subnodo es un nodo pequeño que se conecta a un nodo raíz, un tipo por puerto). El nodo OpenAI no tiene ningún puerto así: funciona solo, item a item. Para una búsqueda en la web en vivo, Perplexity trae su propio nodo. Y para un endpoint de OpenAI que este nodo no expone, el nodo HTTP Request reutiliza la misma credencial.

Dos límites antes de construir nada. Las operaciones Assistant están obsoletas en la versión 2 del nodo, que llegó con n8n 1.117.0, porque el nodo se pasó a la API Responses de OpenAI. Y el proveedor del modelo factura sus propias llamadas de API según sus condiciones, tengas el plan de n8n que tengas: n8n no añade nada encima, pero tampoco te protege del contador del otro lado.

La salida sigue el camino del flujo: un borrador hacia Gmail, una transcripción hacia una hoja, una imagen generada hacia un nodo de almacenamiento. Si prefieres ver la herramienta entera antes de comprometerte, la Reseña n8n cuenta lo que funciona y lo que molesta.

Conexión

¿Qué hay que conectar antes de lanzarlo?

  1. 01

    Da de alta la credencial de OpenAI

    Ve al menú Credentials de n8n: ahí creas una credencial de OpenAI o eliges la que ya tengas, es decir, el conjunto de claves que n8n guarda aparte del flujo. El mismo campo Credential to connect with vale para las 16 operaciones del nodo, tanto en n8n Cloud como en una instancia autoalojada, así que una sola configuración cubre todos los flujos futuros.

  2. 02

    O tira de los Gateway credits en Cloud

    n8n Cloud ofrece otra vía: el campo de credencial del nodo acepta Use Gateway credits, y ya no hace falta una cuenta de OpenAI propia. Una instancia autoalojada no tiene esa opción y se queda con la credencial de siempre. Conviene decidirlo antes de montar el flujo, porque cambiar de idea después obliga a reabrir cada nodo OpenAI uno por uno.

  3. 03

    Valida con una operación sencilla antes de seguir

    file.list no pide ninguna entrada y devuelve los archivos de la organización: es la prueba más rápida para confirmar que la credencial funciona. Con la respuesta en mano, toca ya la operación que realmente interesa. Como el nodo no tiene selector Authentication, ese campo de credencial es lo único que separa el flujo de la API.

Acciones

¿Qué hace cada operación?

El nodo OpenAI expone 16 operaciones en 6 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetUpdateRemoveAnalyze ImageClassify Text for ViolationsDelete a FileEdit ImageGenerate an ImageList FilesMessage a ModelTranscribe a RecordingTranslate a RecordingUpload a File
Text✓✓
Image✓✓✓
Audio✓✓✓
File✓✓✓
Conversation✓✓✓✓
Video✓

Text

2 operaciones
01

Message a model

text.response

Lo que ves en n8n

Notas y casos de uso

Envía uno o varios mensajes a un modelo por la API Responses y devuelve su respuesta, lista para el nodo siguiente.

Parámetros clave

  • Model: requerido, elegido en la lista o pasado por expresión, tipo {{ $json.model }}.
  • Messages: cada entrada lleva un Role (user, assistant o system) y un Prompt, y puede llevar una imagen o un archivo en vez de texto mediante Type.
  • Conversation ID: engancha la respuesta a un hilo existente. No se combina con Previous Response ID.
  • Simplify Output: activado devuelve solo la respuesta; desactivado, los datos en bruto.
Casos de uso
redactar una propuesta de respuesta para cada ticket nuevo, con un mensaje system que fija el tono de una vez.
02

Classify text for violations

text.classify

Lo que ves en n8n

Notas y casos de uso

Comprueba si un contenido cumple las políticas de uso. La respuesta trae flagged, una lista de categories y sus category_scores.

Parámetros clave

  • Text Input: el texto a revisar, casi siempre {{ $json.message }} directo del disparador.
  • Use Stable Model: activado usa la versión estable del modelo en lugar de la última, con una precisión que puede ser algo menor.
  • Simplify Output: devuelve una respuesta simplificada en vez de los datos en bruto.
Casos de uso
filtrar comentarios de visitantes antes de la cola de moderación y mandar a una persona todo lo que salga con flagged en verdadero.

Image

3 operaciones
03

Analyze image

image.analyze

Lo que ves en n8n

Notas y casos de uso

Pasa una o varias imágenes a un modelo y recoge en texto la respuesta a la pregunta planteada.

Parámetros clave

  • Model: requerido, el modelo que va a leer la imagen.
  • Input Type: url para pasar URL(s) separadas por comas, o base64 para leer el binario desde Input Data Field Name.
  • Detail: low responde más rápido y gasta menos tokens (el token es la unidad en la que un modelo cuenta el texto), high entra en detalle y auto deja que el modelo decida según el tamaño.
  • Length of Description (Max Tokens): menos tokens, descripción más corta.
Casos de uso
leer un albarán escaneado que llega como adjunto y sacar la referencia del pedido.
04

Generate an image

image.generate

Lo que ves en n8n

Notas y casos de uso

Crea una imagen a partir de un prompt y la devuelve como archivo binario, o como enlace si lo pides.

Parámetros clave

  • Model: dall-e-2, dall-e-3 o gpt-image-1.
  • Prompt: hasta 1000 caracteres con dall-e-2 y 4000 con dall-e-3.
  • Number of Images, Resolution y Style: natural se queda cerca de una foto y vivid tira hacia un resultado dramático.
  • Respond with Image URL(s): activado devuelve enlaces en vez de binarios; si no, Put Output in Field nombra el campo de salida.
Casos de uso
generar la cabecera visual de cada artículo redactado antes en el mismo flujo.
05

Edit image

image.edit

Lo que ves en n8n

Notas y casos de uso

Retoca una imagen que tú aportas siguiendo la instrucción del prompt, en vez de partir de cero.

Parámetros clave

  • Prompt: requerido, hasta 1000 caracteres con dall-e-2 y 32000 con gpt-image-1.
  • Images: uno o varios campos binarios, cada uno en png, webp o jpg por debajo de 50MB, hasta 16 imágenes.
  • Image Mask: un png cuyas zonas totalmente transparentes marcan qué repintar, con las mismas dimensiones que la imagen y menos de 4MB. Con varias imágenes se aplica a la primera.
  • Background e Input Fidelity: la transparencia y la fidelidad al estilo de origen, ambas solo en gpt-image-1.
Casos de uso
recortar el fondo de una foto de producto antes de subirla al catálogo.

Audio

3 operaciones
06

Generate audio

audio.generate

Lo que ves en n8n

Notas y casos de uso

Lee un texto en voz alta y devuelve el audio como archivo binario.

Parámetros clave

  • Model: tts-1 o tts-1-hd.
  • Text Input: el texto a vocalizar, con un máximo de 4096 caracteres.
  • Voice: alloy, echo, fable, nova, onyx o shimmer.
  • Response Format y Audio Speed: el contenedor (mp3, opus, aac, flac) y el ritmo de lectura.
Casos de uso
convertir el resumen escrito de la semana en una versión de audio que se deja en una carpeta compartida.
07

Transcribe a recording

audio.transcribe

Lo que ves en n8n

Notas y casos de uso

Coge un archivo de audio del item entrante y escribe lo que se dice en él, en el idioma hablado.

Parámetros clave

  • Input Data Field Name: data por defecto, apunta a la propiedad binaria con el archivo en flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav o webm.
  • Language of the Audio File: un código ISO-639-1, que mejora la precisión y la latencia cuando ya sabes el idioma.
  • Output Randomness (Temperature): un valor bajo se pega más al audio.
Casos de uso
la grabación de una llamada comercial cae en una carpeta y el texto acaba como nota del CRM. La API de OpenAI limita el audio a 25 MB y usa whisper-1 por defecto.
08

Translate a recording

audio.translate

Lo que ves en n8n

Notas y casos de uso

Misma entrada, salida distinta: el audio vuelve como texto en inglés, sea cual sea el idioma hablado.

Parámetros clave

  • Input Data Field Name: data por defecto, con los mismos formatos aceptados que en la transcripción, de flac a webm.
  • Output Randomness (Temperature): 1.0 por defecto, en un rango que va de 0.0 (determinista) a 1.0 (aleatoriedad máxima).
Casos de uso
un equipo de soporte que trabaja en inglés recibe notas de voz de varios países y las lee todas en un solo idioma. El tope de 25 MB y el whisper-1 por defecto también valen aquí.

File

3 operaciones
09

Delete a file

file.deleteFile

Lo que ves en n8n

Notas y casos de uso

Borra un archivo del servidor, y lo hace de forma definitiva. Nada más del flujo se ve afectado.

Parámetros clave

  • File: requerido, elegido por nombre en el desplegable o pasado como identificador, muchas veces {{ $json.id }} heredado de un listado previo.
Casos de uso
una limpieza semanal que lista lo subido para fine-tuning, o sea el entrenamiento de un modelo con tus propios datos, y borra lo que supera el plazo de conservación acordado.
10

List files

file.list

Lo que ves en n8n

Notas y casos de uso

Devuelve los archivos que pertenecen a la organización, un item por archivo.

Parámetros clave

  • Purpose: acota el resultado a una intención, assistants, fine-tune, vision o user_data. En any sale todo.
Casos de uso
levantar el inventario de lo que se ha ido subiendo, volcarlo a una hoja y detectar los restos que ya nadie reconoce. Sirve además como primera prueba tras crear la credencial, porque la operación no pide ninguna entrada.
11

Upload a file

file.upload

Lo que ves en n8n

Notas y casos de uso

Sube un archivo desde el flujo hacia OpenAI para que operaciones posteriores lo señalen por su identificador.

Parámetros clave

  • Input Data Field Name: data por defecto, nombra la propiedad binaria con el archivo. Cada archivo llega hasta 512 MB, o 2 millones de tokens para Assistants.
  • Purpose: assistants, fine-tune, vision o user_data. El fine-tuning solo admite archivos .jsonl.
Casos de uso
subir un PDF de referencia para que una respuesta de modelo lo lea luego por la vía File ID en lugar de una URL.

Conversation

4 operaciones
12

Create a conversation

conversation.create

Lo que ves en n8n

Notas y casos de uso

Abre un hilo al que se podrán enganchar respuestas posteriores, y devuelve su identificador.

Parámetros clave

  • Messages: el contenido de apertura, cada entrada con su Role y su Prompt. Un mensaje system tiene prioridad sobre las instrucciones dadas como user.
  • Metadata: hasta 16 pares clave-valor, con claves de 64 caracteres como máximo y valores de 512, para todo aquello por lo que quieras buscar después.
Casos de uso
una conversación por ticket de cliente, creada al abrirlo, para que cada respuesta escrita luego comparta el mismo historial.
13

Get a conversation

conversation.get

Lo que ves en n8n

Notas y casos de uso

Recupera una conversación existente para que el flujo lea lo que contiene.

Parámetros clave

  • Conversation ID: requerido, con la forma conv_1234567890, normalmente guardado antes y recuperado con {{ $json.conversationId }}.
Casos de uso
cuando un cliente contesta tres días después, el flujo relee el hilo ligado a su ticket antes de decidir si la respuesta pide una persona o una nueva respuesta de modelo.
14

Remove a conversation

conversation.remove

Lo que ves en n8n

Notas y casos de uso

Elimina una conversación que ya no hace falta. El hilo y lo que guardaba desaparecen, y la operación no pide nada más que su identificador.

Parámetros clave

  • Conversation ID: requerido, el identificador conv_1234567890 del hilo a retirar, releído desde la fila donde lo guardaste.
Casos de uso
al cerrar un ticket, una rama del flujo retira la conversación asociada, para que la conservación siga el ciclo de vida del ticket y no se acumule por inercia año tras año.
15

Update a conversation

conversation.update

Lo que ves en n8n

Notas y casos de uso

Cambia los metadatos de una conversación existente, sin tocar sus mensajes.

Parámetros clave

  • Conversation ID: requerido, el hilo que se va a actualizar.
  • Metadata: aquí también requerido, un conjunto de 16 pares clave-valor como máximo, con claves de 64 caracteres y valores de 512.
Casos de uso
marcar un hilo con su responsable y su prioridad una vez clasificado el ticket, para recuperar esos campos desde el panel más adelante.

Video

1 operación
16

Generate a video

video.generate

Lo que ves en n8n

Notas y casos de uso

Genera un clip corto a partir de un prompt y deja el resultado en binario dentro de un campo de salida.

Parámetros clave

  • Model, Prompt y Seconds: los tres requeridos, y el último fija la duración del clip.
  • Size: 720x1280, 1280x720, 1024x1792 o 1792x1024, los dos últimos solo con Sora 2 Pro.
  • Wait Timeout: la espera del renderizado en segundos, 300 por defecto. Output Field Name nombra la salida.
Casos de uso
un clip vertical por lanzamiento de producto, generado con el texto redactado antes en la misma ejecución.
Necesitas ayuda

¿Necesitas ayuda para automatizar OpenAI con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Lo que se pregunta después

01¿El nodo OpenAI viene incluido en n8n, en Cloud y autoalojado?
Sí, y sin coste extra por parte de n8n: el nodo forma parte del paquete de IA de n8n, @n8n/n8n-nodes-langchain, que viene de serie tanto en la Community Edition autoalojada bajo licencia Sustainable Use (Docker o npm) como en n8n Cloud, con el mismo comportamiento en los dos casos y nada que instalar. La única factura real la pone OpenAI: el proveedor cobra sus propias llamadas de API según sus condiciones, sin que n8n añada nada encima. En Cloud, los Gateway credits son la alternativa para quien prefiere no aportar su propia cuenta de OpenAI.
02¿Qué hay que autenticar para que funcione?
Basta con una credencial de OpenAI: se configura una vez en el menú Credentials y luego se reutiliza en el campo Credential to connect with de cada una de las 16 operaciones, ya sea texto, imagen, audio, archivos, conversaciones o vídeo. El nodo no tiene selector Authentication, así que no hay nada más que decidir. Junto a esa vía habitual, n8n Cloud permite marcar Use Gateway credits para prescindir de ella; una instancia autoalojada, en cambio, se queda con la credencial como único camino.
03¿Qué límites tiene el nodo OpenAI n8n?
16 operaciones, 6 recursos, versión 2 documentada aquí: ese es el alcance. Esta versión dejó las operaciones Assistant como obsoletas desde n8n 1.117.0, en favor de la API Responses de OpenAI. Los verdaderos topes vienen de la API y no del nodo: 25 MB para un audio que se transcribe o se traduce, 512 MB o 2 millones de tokens para una subida de tipo Assistants, 4MB para una máscara de imagen, y opciones que solo existen en un modelo concreto, como Background e Input Fidelity, reservadas a gpt-image-1. Un endpoint que el nodo no cubre sigue accesible vía HTTP Request, con la misma credencial.
04¿Cuál es el montaje mínimo y por qué operación empezar?
La credencial basta para arrancar, con List files como primera prueba: no pide entrada, devuelve lo que pertenece a la organización y confirma en una sola ejecución que todo responde. El paso siguiente natural es Message a model, donde acaba yendo a parar la mayoría de los flujos, con Model como único campo obligatorio y un mensaje user para empezar. Dos costumbres simplifican lo que sigue: dejar Simplify Output activado mientras se construye, para que los datos se lean bien, y vigilar los campos requeridos, porque uno vacío corta el nodo antes de que salga ninguna petición.
05¿n8n o Make para llamar a OpenAI?
La decisión pasa por dónde viven los datos y cómo se quiere pagar. Con n8n hay dos caminos: Docker o npm en autoalojado, o n8n Cloud, lo que deja elegir si prompts y archivos generados se quedan en una infraestructura propia. Make, en cambio, solo existe alojado y factura por operación, algo que pesa en cuanto un flujo multiplica llamadas al modelo sobre un lote grande de filas. Las dos plataformas montan bloques de forma visual, y la diferencia está más en el reflejo que en el resultado. Para un uso ligero sin ganas de mantener un servidor, lo alojado cumple; en cuanto el volumen crece o los datos son sensibles, el autoalojamiento deja más puertas abiertas.