Ressources · Intégration n8n

Nœud OpenAI n8nConfigurer OpenAI dans n8n.

Le nœud OpenAI transforme un appel de modèle en simple étape de workflow. Il réunit 16 opérations réparties sur 6 ressources : texte, image, audio, fichier, conversation et vidéo. Le nœud OpenAI n8n s'exécute sur chaque item entrant, comme tout nœud d'action, donc il se place dans une chaîne, pas dans un chat.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud OpenAI n8n ?

Le nœud OpenAI n8n sert d'intermédiaire entre un workflow et l'API OpenAI. Une ressource d'abord (Text, Image, Audio, File, Conversation, Video), une opération ensuite parmi les 16 disponibles : le choix fait, n8n construit la requête avec le credential enregistré, un identifiant que n8n garde à part du workflow, avant de remettre la réponse au nœud suivant. Comme il n'exécute qu'un item à la fois, 40 lignes en entrée déclenchent 40 requêtes distinctes.

Trois usages reviennent tout le temps. Le premier, du texte en série : une ligne arrive de Google Sheets, text.response rédige la synthèse, le résultat repart dans la feuille. Le deuxième, de la production de média : image.generate fabrique un visuel à partir d'un prompt, audio.generate lit un script à voix haute, video.generate sort un clip court, et chacune renvoie un fichier binaire que la suite du workflow stocke ou envoie. Le troisième, du traitement entrant : audio.transcribe convertit un message vocal en texte, image.analyze répond à une question posée sur une pièce jointe, text.classify signale un contenu qui sort des règles d'usage avant qu'un humain le lise.

La conversation, elle, passe souvent à la trappe. conversation.create ouvre un fil, et une réponse de modèle peut s'y rattacher via l'option Conversation ID : le deuxième appel sait alors ce qu'a dit le premier. Sans ça, chaque exécution repart de zéro. Très bien pour de la classification, franchement gênant pour un échange support qui s'étale sur plusieurs messages.

Il y a des cas où ce nœud n'est pas le bon. Quand le modèle doit décider lui-même de l'action suivante, c'est le nœud AI Agent qui joue le rôle de nœud racine, avec des sous-nœuds branchés sur ses ports (un sous-nœud, c'est un petit nœud qu'on raccorde à un nœud racine, un type par port). Le nœud OpenAI n'a aucun port de ce genre : il tourne seul, item par item. Pour une recherche sur le web en direct, Perplexity a son propre nœud. Et pour un point d'API OpenAI que ce nœud n'expose pas, le nœud HTTP Request réutilise le même credential.

Deux limites à garder en tête avant de construire. Les opérations Assistant sont dépréciées dans la version 2 du nœud, arrivée avec n8n 1.117.0, parce que le nœud est passé à l'API Responses d'OpenAI. Et le fournisseur du modèle facture ses propres appels d'API selon ses conditions, quel que soit le plan n8n : n8n n'ajoute rien, mais ne te protège pas du compteur d'en face non plus.

La sortie part ensuite là où va le workflow : un brouillon dans Gmail, une transcription dans un tableur, une image générée dans un nœud de stockage. Pour prendre du recul sur l'outil avant de t'engager, l'Avis n8n dit ce qui marche et ce qui coince.

Connexion

Qu'est-ce qu'il faut connecter avant de lancer le nœud ?

  1. 01

    Créer le credential OpenAI

    Direction le menu Credentials de n8n : là, tu crées un credential OpenAI ou tu réutilises celui qui existe déjà, c'est-à-dire le jeu de secrets que n8n range en dehors du workflow lui-même. Le même champ Credential to connect with sert pour les 16 opérations du nœud, sur n8n Cloud comme sur une instance auto-hébergée, donc une seule configuration couvre tous les workflows à venir.

  2. 02

    Ou passer par les Gateway credits sur Cloud

    n8n Cloud propose une autre voie : le champ credential du nœud accepte Use Gateway credits, et plus besoin d'un compte OpenAI personnel. Une instance auto-hébergée n'a pas cette option, elle reste sur le credential classique. Le choix se fait avant de construire, faute de quoi il faudra rouvrir chaque nœud OpenAI du workflow pour changer d'avis.

  3. 03

    Valider avec une opération simple avant le reste

    file.list ne réclame aucune entrée et renvoie la liste des fichiers de l'organisation : c'est le test le plus rapide pour confirmer que le credential fonctionne. Une fois la réponse obtenue, place à l'opération recherchée. Comme le nœud n'a pas de sélecteur Authentication, ce champ credential reste la seule barrière entre le workflow et l'API.

Actions

Quelle opération fait quoi ?

Le nœud OpenAI expose 16 opérations sur 6 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreateGetUpdateRemoveAnalyze 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 opérations
01

Message a model

text.response

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie un ou plusieurs messages à un modèle via l'API Responses et renvoie sa réponse, prête pour le nœud suivant.

Paramètres clés

  • Model : requis, choisi dans la liste ou donné par expression, du genre {{ $json.model }}.
  • Messages : chaque entrée porte un Role (user, assistant ou system) et un Prompt, et peut contenir une image ou un fichier au lieu du texte via Type.
  • Conversation ID : rattache la réponse à un fil existant. Incompatible avec Previous Response ID.
  • Simplify Output : activé, tu reçois la réponse seule ; désactivé, la charge brute.
Cas d'usage
rédiger une proposition de réponse à chaque nouveau ticket, avec un message system qui fixe le ton une bonne fois.
02

Classify text for violations

text.classify

Ce que tu vois dans n8n

Notes & cas d'usage

Vérifie si un contenu respecte les règles d'usage. La réponse contient flagged, une liste de categories et les category_scores correspondants.

Paramètres clés

  • Text Input : le texte à contrôler, souvent {{ $json.message }} directement issu du déclencheur.
  • Use Stable Model : activé, la version stable du modèle remplace la dernière en date, avec une précision qui peut être légèrement inférieure.
  • Simplify Output : renvoie une réponse simplifiée plutôt que les données brutes.
Cas d'usage
filtrer des commentaires publiés par des visiteurs avant la file de modération, et router vers un humain tout ce qui ressort avec flagged à vrai.

Image

3 opérations
03

Analyze image

image.analyze

Ce que tu vois dans n8n

Notes & cas d'usage

Donne une ou plusieurs images à un modèle et récupère en texte la réponse à la question posée.

Paramètres clés

  • Model : requis, le modèle qui va lire l'image.
  • Input Type : url pour passer des URL(s) séparées par des virgules, base64 pour lire le binaire depuis Input Data Field Name.
  • Detail : low répond plus vite en consommant moins de tokens (un token étant l'unité dans laquelle un modèle compte le texte), high détaille, auto laisse le modèle trancher selon la taille de l'image.
  • Length of Description (Max Tokens) : moins de tokens, description plus courte.
Cas d'usage
lire un bon de livraison scanné reçu en pièce jointe et en extraire la référence de commande.
04

Generate an image

image.generate

Ce que tu vois dans n8n

Notes & cas d'usage

Fabrique une image à partir d'un prompt et la renvoie en fichier binaire, ou en lien si tu le demandes.

Paramètres clés

  • Model : dall-e-2, dall-e-3 ou gpt-image-1.
  • Prompt : jusqu'à 1000 caractères pour dall-e-2 et 4000 pour dall-e-3.
  • Number of Images, Resolution et Style : natural reste proche d'une photo, vivid pousse vers un rendu spectaculaire.
  • Respond with Image URL(s) : activé, tu récupères des liens plutôt que des binaires ; sinon Put Output in Field nomme le champ de sortie.
Cas d'usage
produire le visuel d'en-tête de chaque article rédigé plus tôt dans le même workflow.
05

Edit image

image.edit

Ce que tu vois dans n8n

Notes & cas d'usage

Retouche une image que tu fournis, en suivant la consigne du prompt, au lieu de partir d'une page blanche.

Paramètres clés

  • Prompt : requis, jusqu'à 1000 caractères pour dall-e-2 et 32000 pour gpt-image-1.
  • Images : un ou plusieurs champs binaires, chacun en png, webp ou jpg sous 50MB, jusqu'à 16 images.
  • Image Mask : un png dont les zones totalement transparentes indiquent quoi repeindre, mêmes dimensions que l'image et moins de 4MB. Avec plusieurs images, il s'applique à la première.
  • Background et Input Fidelity : la transparence et la fidélité au style d'origine, réservés à gpt-image-1.
Cas d'usage
détourer une photo produit avant son passage au catalogue.

Audio

3 opérations
06

Generate audio

audio.generate

Ce que tu vois dans n8n

Notes & cas d'usage

Lit un texte à voix haute et renvoie l'audio sous forme de fichier binaire.

Paramètres clés

  • Model : tts-1 ou tts-1-hd.
  • Text Input : le texte à vocaliser, 4096 caractères au maximum.
  • Voice : alloy, echo, fable, nova, onyx ou shimmer.
  • Response Format et Audio Speed : le conteneur (mp3, opus, aac, flac) et le rythme de lecture.
Cas d'usage
transformer la synthèse écrite de la semaine en version audio déposée dans un dossier partagé.
07

Transcribe a recording

audio.transcribe

Ce que tu vois dans n8n

Notes & cas d'usage

Reprend un fichier audio de l'item entrant et écrit ce qui s'y dit, dans la langue parlée.

Paramètres clés

  • Input Data Field Name : data par défaut, pointe la propriété binaire qui contient le fichier en flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav ou webm.
  • Language of the Audio File : un code ISO-639-1, qui améliore la précision et la latence quand tu connais déjà la langue.
  • Output Randomness (Temperature) : une valeur basse colle davantage à l'audio.
Cas d'usage
l'enregistrement d'un appel commercial arrive dans un dossier, le texte part en note du CRM. L'API OpenAI plafonne le fichier audio à 25 MB et utilise whisper-1 par défaut.
08

Translate a recording

audio.translate

Ce que tu vois dans n8n

Notes & cas d'usage

Même entrée, autre sortie : l'audio revient en texte anglais, quelle que soit la langue parlée dedans.

Paramètres clés

  • Input Data Field Name : data par défaut, avec les mêmes formats acceptés qu'en transcription, de flac à webm.
  • Output Randomness (Temperature) : 1.0 par défaut, la plage allant de 0.0 (déterministe) à 1.0 (aléatoire maximal).
Cas d'usage
une équipe support qui travaille en anglais reçoit des messages vocaux de plusieurs pays et les lit tous dans une seule langue. Le plafond de 25 MB et le whisper-1 par défaut valent aussi ici.

File

3 opérations
09

Delete a file

file.deleteFile

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un fichier du serveur, définitivement. Le reste du workflow n'est pas touché.

Paramètres clés

  • File : requis, sélectionné par son nom dans la liste déroulante ou fourni sous forme d'identifiant, souvent {{ $json.id }} hérité d'une étape de listing.
Cas d'usage
un ménage hebdomadaire qui liste ce qui a été déposé pour du fine-tuning, autrement dit l'entraînement d'un modèle sur tes propres données, et efface ce qui dépasse la durée de conservation décidée.
10

List files

file.list

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les fichiers qui appartiennent à l'organisation, un item par fichier.

Paramètres clés

  • Purpose : restreint le résultat à une intention, assistants, fine-tune, vision ou user_data. Laissé sur any, tout remonte.
Cas d'usage
dresser l'inventaire de ce qui a été déposé au fil du temps, le verser dans un tableur, et repérer les restes que plus personne n'assume. Ça fait aussi un bon premier test après la création du credential, puisque l'opération ne demande aucune entrée.
11

Upload a file

file.upload

Ce que tu vois dans n8n

Notes & cas d'usage

Pousse un fichier du workflow vers OpenAI pour que des opérations suivantes le désignent par son identifiant.

Paramètres clés

  • Input Data Field Name : data par défaut, nomme la propriété binaire qui contient le fichier. Chaque fichier monte jusqu'à 512 MB, ou 2 millions de tokens pour Assistants.
  • Purpose : assistants, fine-tune, vision ou user_data. Le fine-tuning n'accepte que des fichiers .jsonl.
Cas d'usage
déposer un PDF de référence pour qu'une réponse de modèle le lise ensuite par le chemin File ID plutôt que par une URL.

Conversation

4 opérations
12

Create a conversation

conversation.create

Ce que tu vois dans n8n

Notes & cas d'usage

Ouvre un fil auquel des réponses ultérieures pourront se rattacher, et renvoie son identifiant.

Paramètres clés

  • Messages : le contenu d'ouverture, chaque entrée avec un Role et un Prompt. Un message system prime sur les instructions données en user.
  • Metadata : jusqu'à 16 paires clé-valeur, clés de 64 caractères au plus, valeurs de 512, pour tout ce sur quoi tu voudras chercher plus tard.
Cas d'usage
une conversation par ticket client, créée à l'ouverture du ticket, pour que chaque réponse écrite ensuite partage le même historique.
13

Get a conversation

conversation.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère une conversation existante pour que le workflow lise ce qu'elle contient.

Paramètres clés

  • Conversation ID : requis, de la forme conv_1234567890, en général stocké plus tôt puis relu avec {{ $json.conversationId }}.
Cas d'usage
quand un client répond trois jours après, le workflow relit le fil attaché à son ticket avant de décider si la réponse demande un humain ou une nouvelle réponse de modèle.
14

Remove a conversation

conversation.remove

Ce que tu vois dans n8n

Notes & cas d'usage

Efface une conversation devenue inutile. Le fil et ce qu'il contenait disparaissent, et l'opération ne demande rien d'autre que son identifiant.

Paramètres clés

  • Conversation ID : requis, l'identifiant conv_1234567890 du fil à retirer, relu depuis la ligne où tu l'avais stocké.
Cas d'usage
à la clôture d'un ticket, une branche du workflow retire la conversation correspondante, pour que la conservation suive le cycle de vie du ticket au lieu de s'accumuler toute seule année après année.
15

Update a conversation

conversation.update

Ce que tu vois dans n8n

Notes & cas d'usage

Change les métadonnées portées par une conversation existante, sans toucher à ses messages.

Paramètres clés

  • Conversation ID : requis, le fil à mettre à jour.
  • Metadata : requis ici, un ensemble de 16 paires clé-valeur au plus, clés limitées à 64 caractères et valeurs à 512.
Cas d'usage
tamponner un fil avec son responsable et sa priorité une fois le ticket qualifié, pour retrouver ces champs depuis le dashboard ensuite.

Video

1 opération
16

Generate a video

video.generate

Ce que tu vois dans n8n

Notes & cas d'usage

Calcule un clip court à partir d'un prompt et dépose le résultat en binaire dans un champ de sortie.

Paramètres clés

  • Model, Prompt et Seconds : les trois sont requis, le dernier fixant la durée du clip.
  • Size : 720x1280, 1280x720, 1024x1792 ou 1792x1024, les deux derniers uniquement sur Sora 2 Pro.
  • Wait Timeout : le temps d'attente du rendu en secondes, 300 par défaut. Output Field Name nomme la sortie.
Cas d'usage
un clip vertical par lancement produit, généré depuis le texte rédigé plus tôt dans l'exécution.
Besoin d'aide

Besoin d'aide pour automatiser OpenAI avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui viennent ensuite

01Le nœud OpenAI est-il inclus dans n8n, sur Cloud comme en auto-hébergé ?
Oui, sans surcoût côté n8n : le nœud appartient au paquet IA de n8n, @n8n/n8n-nodes-langchain, fourni d'origine, aussi bien en Community Edition auto-hébergée sous licence Sustainable Use (Docker ou npm) que sur n8n Cloud, avec un comportement identique dans les deux cas et rien à installer. La seule facture qui existe vient d'OpenAI : le fournisseur facture ses propres appels d'API selon ses conditions, n8n ne prenant rien au passage. Sur Cloud, les Gateway credits offrent une alternative pour qui préfère éviter son propre compte OpenAI.
02Qu'est-ce qu'il faut authentifier pour que ça marche ?
Un seul credential OpenAI suffit : configuré une fois dans le menu Credentials, il se réutilise ensuite dans le champ Credential to connect with de chacune des 16 opérations, qu'il s'agisse de texte, d'image, d'audio, de fichiers, de conversations ou de vidéo. Aucun sélecteur Authentication sur le nœud, donc rien d'autre à trancher. À côté de cette voie classique, n8n Cloud permet de cocher Use Gateway credits pour s'en passer complètement ; une instance auto-hébergée, elle, garde le credential comme unique chemin.
03Quelles sont les limites du nœud OpenAI n8n ?
16 opérations, 6 ressources, version 2 documentée ici : voilà le périmètre. Cette version a mis les opérations Assistant en dépréciation depuis n8n 1.117.0, au profit de l'API Responses d'OpenAI. Les vrais plafonds viennent de l'API et non du nœud : 25 MB pour un fichier audio à transcrire ou traduire, 512 MB ou 2 millions de tokens pour un envoi côté Assistants, 4MB pour un masque d'image, et des options qui n'existent que sur un modèle précis, comme Background et Input Fidelity réservées à gpt-image-1. Un point d'API que le nœud ne couvre pas reste accessible via HTTP Request, avec le même credential.
04Quel est le minimum à mettre en place et par quelle opération commencer ?
Le credential suffit pour se lancer, avec List files comme premier test : aucune entrée à fournir, une réponse qui liste ce qui appartient à l'organisation, et la preuve en une exécution que tout communique. L'étape suivante logique, c'est Message a model, là où la plupart des workflows finissent par atterrir, avec Model comme seul champ requis et un message user pour commencer. Deux habitudes simplifient la suite : laisser Simplify Output activé pendant la construction pour garder des données lisibles, et surveiller les champs requis, puisqu'un champ requis vide coupe le nœud avant la moindre requête.
05n8n ou Make pour appeler OpenAI ?
Le choix se joue sur l'hébergement des données et le mode de facturation. Avec n8n, deux options coexistent : Docker, npm en auto-hébergé, ou n8n Cloud, ce qui laisse le choix de garder prompts et fichiers générés sur une infrastructure maîtrisée. Make, lui, n'existe qu'en hébergé et facture à l'opération, un point qui pèse dès qu'un workflow multiplie les appels de modèle sur un gros lot de lignes. Les deux plateformes assemblent des blocs visuellement, la différence tient plus au réflexe qu'au résultat final. Pour un usage léger sans envie de gérer un serveur, l'hébergé fait le travail ; dès que le volume grandit ou que les données sont sensibles, l'auto-hébergement garde plus de portes ouvertes.