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
À 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.
Qu'est-ce qu'il faut connecter avant de lancer le nœud ?
- 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.
- 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.
- 03
Valider avec une opération simple avant le reste
file.listne 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.
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.
| Ressource | 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 | ✓ |
Sommaire des opérations
Text
2 opérationsMessage a model
text.responseCe 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,assistantousystem) 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.
system qui fixe le ton une bonne fois.Classify text for violations
text.classifyCe 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.
flagged à vrai.Image
3 opérationsAnalyze image
image.analyzeCe 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 :
urlpour passer des URL(s) séparées par des virgules,base64pour lire le binaire depuis Input Data Field Name. - Detail :
lowrépond plus vite en consommant moins de tokens (un token étant l'unité dans laquelle un modèle compte le texte),highdétaille,autolaisse le modèle trancher selon la taille de l'image. - Length of Description (Max Tokens) : moins de tokens, description plus courte.
Generate an image
image.generateCe 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-3ougpt-image-1. - Prompt : jusqu'à 1000 caractères pour
dall-e-2et 4000 pourdall-e-3. - Number of Images, Resolution et Style :
naturalreste proche d'une photo,vividpousse 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.
Edit image
image.editCe 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-2et 32000 pourgpt-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.
Audio
3 opérationsGenerate audio
audio.generateCe 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-1outts-1-hd. - Text Input : le texte à vocaliser, 4096 caractères au maximum.
- Voice :
alloy,echo,fable,nova,onyxoushimmer. - Response Format et Audio Speed : le conteneur (
mp3,opus,aac,flac) et le rythme de lecture.
Transcribe a recording
audio.transcribeCe 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 :
datapar 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.
whisper-1 par défaut.Translate a recording
audio.translateCe 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 :
datapar défaut, avec les mêmes formats acceptés qu'en transcription, de flac à webm. - Output Randomness (Temperature) :
1.0par défaut, la plage allant de0.0(déterministe) à1.0(aléatoire maximal).
whisper-1 par défaut valent aussi ici.File
3 opérationsDelete a file
file.deleteFileCe 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.
List files
file.listCe 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,visionouuser_data. Laissé surany, tout remonte.
Upload a file
file.uploadCe 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 :
datapar 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,visionouuser_data. Le fine-tuning n'accepte que des fichiers.jsonl.
Conversation
4 opérationsCreate a conversation
conversation.createCe 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
systemprime sur les instructions données enuser. - 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.
Get a conversation
conversation.getCe 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 }}.
Remove a conversation
conversation.removeCe 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_1234567890du fil à retirer, relu depuis la ligne où tu l'avais stocké.
Update a conversation
conversation.updateCe 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.
Video
1 opérationGenerate a video
video.generateCe 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,1024x1792ou1792x1024, les deux derniers uniquement sur Sora 2 Pro. - Wait Timeout : le temps d'attente du rendu en secondes,
300par défaut. Output Field Name nomme la sortie.
Besoin d'aide pour automatiser OpenAI avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.


