Connecter OpenAI à n8n : credentials, modèles et bonnes pratiques (guide complet)

OpenAI est le fournisseur d'IA le plus utilisé dans les workflows n8n, et pourtant la première connexion bloque encore beaucoup d'utilisateurs : clé API introuvable, confusion entre abonnement ChatGPT et crédit API, erreur 429 dès le premier appel, ou hésitation entre les cinq nodes différents qui affichent le logo OpenAI. Ce guide reprend tout dans l'ordre : création de la clé, configuration du credential (y compris le champ Base URL, souvent ignoré alors qu'il ouvre la porte aux endpoints compatibles), tour de la famille de nodes OpenAI, choix du modèle et résolution des erreurs fréquentes. Si vous hésitez encore entre OpenAI et Anthropic, notre comparatif pour connecter Claude ou GPT à n8n donne une vue d'ensemble des deux fournisseurs ; la présente page est LA page dédiée 100 % OpenAI.

Étape 1 : créer la clé API sur platform.openai.com

L'API OpenAI se gère sur platform.openai.com, un espace distinct de ChatGPT. Point essentiel : un abonnement ChatGPT Plus ne donne aucun crédit API. Les deux produits sont facturés séparément, et c'est la première cause d'erreur 429 chez les débutants.

1. Créez un compte (ou connectez-vous) sur platform.openai.com.
2. Dans les paramètres de facturation (Billing), ajoutez du crédit prépayé ou un moyen de paiement. Sans cela, la clé existera mais tous les appels échoueront.
3. Dans la section des clés API (API keys), créez une nouvelle clé secrète. OpenAI organise les clés par projet : créez un projet dédié à n8n, vous pourrez suivre et plafonner sa consommation indépendamment.
4. Copiez la clé immédiatement : elle ne sera plus jamais affichée en clair.
5. Si votre compte appartient à plusieurs organisations, notez aussi l'Organization ID dans les paramètres d'organisation.

Fixez dès maintenant une limite de dépense mensuelle dans la facturation du projet : un workflow n8n qui boucle par erreur peut enchaîner des centaines d'appels en quelques minutes, et un plafond dur reste le meilleur garde-fou.

Étape 2 : créer le credential OpenAI dans n8n

Dans n8n, ouvrez Credentials → Add credential → OpenAI. Trois champs sont proposés :

• API Key (obligatoire) : la clé secrète copiée à l'étape précédente.
• Organization ID (optionnel) : à renseigner uniquement si votre compte appartient à plusieurs organisations, pour désigner celle qui sera facturée. Sinon, laissez vide.
• Base URL (optionnel) : l'URL de l'API, qui pointe par défaut vers l'endpoint officiel d'OpenAI. C'est le champ le plus sous-estimé du credential.

Le champ Base URL mérite qu'on s'y arrête : le format d'API d'OpenAI est devenu un standard de fait, largement implémenté ailleurs. En le remplaçant par l'URL d'un fournisseur compatible — OpenRouter pour accéder à des dizaines de modèles avec une seule clé, un proxy d'entreprise, ou un serveur d'inférence local au format OpenAI — vous réutilisez les mêmes nodes n8n sans toucher à vos workflows.

Enregistrez, puis testez avec un node OpenAI minimal (un simple « réponds OK ») avant de construire quoi que ce soit : cela isole les problèmes d'authentification des problèmes de workflow. Et appliquez les réflexes de notre guide pour sécuriser vos credentials dans n8n : jamais de clé en dur dans un node Code ou HTTP Request, toujours le système de credentials chiffrés.

La famille de nodes qui utilisent ce credential

Plusieurs nodes n8n portent le nom OpenAI et partagent tous le même credential. Chacun a pourtant un rôle précis.

• Le node OpenAI classique : le couteau suisse. Il regroupe les opérations par ressource — envoyer un message à un modèle (chat), générer une image, transcrire ou traduire un audio, générer de la parole, analyser une image, gérer fichiers et assistants. C'est le bon choix pour un appel ponctuel : « résume ce texte », « transcris cet enregistrement ».
• OpenAI Chat Model : un sub-node qui ne s'utilise jamais seul. Il se branche sous un AI Agent, une chaîne LLM ou un Text Classifier pour leur fournir le « cerveau ». Si cette architecture est nouvelle pour vous, notre guide pour débuter avec les nodes IA de n8n explique la différence entre nodes et sub-nodes.
• Embeddings OpenAI : un autre sub-node, dédié à la vectorisation de texte pour les architectures RAG — il se branche sous un vector store pour indexer et rechercher des documents.
• Transcription audio (Whisper) : via l'opération audio du node OpenAI, elle transforme un fichier audio binaire en texte. Notre guide de transcription et résumé de réunions avec Whisper et n8n en fait un cas d'usage complet.
• Génération d'images : l'opération image du node OpenAI produit des visuels à partir d'un prompt, renvoyés en binaire ou en URL.

Exemple concret : un node OpenAI (opération chat) dont la réponse est consommée en aval avec une expression :

{{ $json.message.content }}

Si vous attendez du JSON structuré plutôt que du texte libre, combinez le Chat Model avec un Structured Output Parser pour garantir un format exploitable en aval.

Choisir le modèle selon le cas d'usage

Le champ Model de chaque node liste les modèles accessibles avec votre clé. Plutôt que des prix (ils évoluent trop vite pour être gravés dans un article), retenez la logique par famille :

• Modèles légers (type gpt-4o-mini et équivalents) : classification, extraction simple, reformulation, routage. La grande majorité des tâches d'automatisation n'a pas besoin de plus.
• Modèles principaux (type gpt-4o / GPT-4.1) : rédaction soignée, raisonnement multi-étapes, agents avec outils.
• Modèles de raisonnement (série o) : problèmes complexes où la qualité prime sur la latence et le coût — à réserver aux étapes qui le justifient.
• Modèles spécialisés : whisper-1 pour l'audio, text-embedding-3-small ou large pour les embeddings, les modèles image pour la génération visuelle.

Ce choix n'est pas qu'une affaire de confort : une étude de Lingjiao Chen, Matei Zaharia et James Zou (Stanford), FrugalGPT: How to Use Large Language Models While Reducing Cost and Improving Performance, publiée en 2023 puis dans la revue Transactions on Machine Learning Research, montre qu'une cascade de modèles — un modèle léger d'abord, escalade vers le plus puissant seulement si nécessaire — peut égaler la performance du meilleur modèle seul en réduisant le coût jusqu'à 98 % sur certains jeux de requêtes. Dans n8n, ce pattern se construit naturellement : un modèle léger classifie, un node IF route les cas difficiles vers un modèle supérieur.

Erreurs courantes : 401, 429 et leurs vraies causes

Trois erreurs couvrent l'essentiel des blocages :

• 401 – invalid_api_key : la clé est fausse, tronquée (un espace copié en trop suffit), révoquée, ou la Base URL pointe vers un service qui n'accepte pas cette clé. Recréez le credential en recollant la clé.
• 429 – insufficient_quota : le piège classique. Ce n'est pas un problème de vitesse mais de crédit épuisé ou absent — typiquement un compte sans facturation activée. Direction platform.openai.com, section Billing.
• 429 – rate_limit_exceeded : là, c'est bien la fréquence d'appels qui dépasse les limites de votre niveau d'usage. Les solutions — lots, pauses, retry avec backoff — sont détaillées dans notre guide pour gérer les rate limits des API d'IA dans n8n.

Pour un workflow de production qui ne doit jamais s'arrêter, prévoyez un plan B : notre article sur le fallback multi-fournisseurs d'IA dans n8n montre comment basculer automatiquement vers un autre modèle ou fournisseur quand OpenAI renvoie une erreur.

Suivre et maîtriser les coûts

L'espace platform.openai.com fournit un tableau de bord d'usage par projet — d'où l'intérêt d'une clé dédiée à n8n. Mais pour savoir quel workflow consomme quoi, il faut instrumenter côté n8n : les réponses de l'API incluent le nombre de tokens consommés, que vous pouvez journaliser vers Google Sheets ou une base après chaque appel. Notre guide pour suivre le coût de vos appels IA dans n8n détaille ce montage de bout en bout.

Trois réflexes évitent les mauvaises surprises : une limite de dépense dure côté OpenAI, un modèle léger par défaut, et des prompts courts — le contexte inutile se paie à chaque exécution, des milliers de fois par mois sur un workflow planifié.

En résumé

Connecter OpenAI à n8n tient en deux étapes — une clé API créée dans un projet dédié sur platform.openai.com (avec du crédit API, indépendant de ChatGPT Plus), puis un credential n8n avec la clé, l'Organization ID si nécessaire et une Base URL modifiable pour les endpoints compatibles. Ce credential unique alimente toute la famille de nodes : OpenAI classique, Chat Model, Embeddings, Whisper et génération d'images. Retenez la règle du modèle le plus léger qui fait le travail, distinguez les deux visages de l'erreur 429 (quota contre rate limit), et journalisez vos tokens dès le premier workflow sérieux. Pour des workflows IA déjà assemblés, parcourez nos workflows n8n prêts à l'emploi.