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
¿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.
¿Qué hay que conectar antes de lanzarlo?
- 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.
- 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.
- 03
Valida con una operación sencilla antes de seguir
file.listno 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.
¿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.
| Recurso | Create | Get | Update | Remove | Analyze Image | Classify Text for Violations | Delete a File | Edit Image | Generate an Image | List Files | Message a Model | Transcribe a Recording | Translate a Recording | Upload a File |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Text | ✓ | ✓ | ||||||||||||
| Image | ✓ | ✓ | ✓ | |||||||||||
| Audio | ✓ | ✓ | ✓ | |||||||||||
| File | ✓ | ✓ | ✓ | |||||||||||
| Conversation | ✓ | ✓ | ✓ | ✓ | ||||||||||
| Video | ✓ |
Índice de operaciones
Text
2 operacionesMessage a model
text.responseLo 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,assistantosystem) 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.
system que fija el tono de una vez.Classify text for violations
text.classifyLo 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.
flagged en verdadero.Image
3 operacionesAnalyze image
image.analyzeLo 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:
urlpara pasar URL(s) separadas por comas, obase64para leer el binario desde Input Data Field Name. - Detail:
lowresponde más rápido y gasta menos tokens (el token es la unidad en la que un modelo cuenta el texto),highentra en detalle yautodeja que el modelo decida según el tamaño. - Length of Description (Max Tokens): menos tokens, descripción más corta.
Generate an image
image.generateLo 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-3ogpt-image-1. - Prompt: hasta 1000 caracteres con
dall-e-2y 4000 condall-e-3. - Number of Images, Resolution y Style:
naturalse queda cerca de una foto yvividtira 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.
Edit image
image.editLo 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-2y 32000 congpt-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.
Audio
3 operacionesGenerate audio
audio.generateLo 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-1otts-1-hd. - Text Input: el texto a vocalizar, con un máximo de 4096 caracteres.
- Voice:
alloy,echo,fable,nova,onyxoshimmer. - Response Format y Audio Speed: el contenedor (
mp3,opus,aac,flac) y el ritmo de lectura.
Transcribe a recording
audio.transcribeLo 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:
datapor 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.
whisper-1 por defecto.Translate a recording
audio.translateLo 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:
datapor defecto, con los mismos formatos aceptados que en la transcripción, de flac a webm. - Output Randomness (Temperature):
1.0por defecto, en un rango que va de0.0(determinista) a1.0(aleatoriedad máxima).
whisper-1 por defecto también valen aquí.File
3 operacionesDelete a file
file.deleteFileLo 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.
List files
file.listLo 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,visionouser_data. Enanysale todo.
Upload a file
file.uploadLo 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:
datapor 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,visionouser_data. El fine-tuning solo admite archivos.jsonl.
Conversation
4 operacionesCreate a conversation
conversation.createLo 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
systemtiene prioridad sobre las instrucciones dadas comouser. - 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.
Get a conversation
conversation.getLo 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 }}.
Remove a conversation
conversation.removeLo 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_1234567890del hilo a retirar, releído desde la fila donde lo guardaste.
Update a conversation
conversation.updateLo 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.
Video
1 operaciónGenerate a video
video.generateLo 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,1024x1792o1792x1024, los dos últimos solo con Sora 2 Pro. - Wait Timeout: la espera del renderizado en segundos,
300por defecto. Output Field Name nombra la salida.
¿Necesitas ayuda para automatizar OpenAI con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.


