🚀 Tutoriel pour connecter les grands modèles personnalisés CodingPlanX à n8n

Dans n8n, nous pouvons facilement intégrer des grands modèles linguistiques (LLM) tiers en configurant un nom de domaine d'API personnalisé et une clé (API Key).

Ce tutoriel expliquera en détail comment configurer et utiliser un modèle d'IA personnalisé dans n8n, en prenant https://api.codingplanx.ai comme exemple.

📋 Prérequis

Avant de commencer, assurez-vous de remplir les conditions suivantes :

n8n installé et en cours d'exécution (déploiement local ou version Cloud).
Une clé API de CodingPlanX (commençant généralement par sk-).
Connaître le nom du modèle spécifique que vous souhaitez appeler (par exemple : gpt-4o, claude-3-5-sonnet, etc.).

🛠️ Étape 1 : Créer des identifiants d'API (Credentials) dans n8n

Étant donné que la grande majorité des API personnalisées sont compatibles avec le format OpenAI, nous utiliserons les identifiants OpenAI intégrés à n8n pour la configuration.

Ouvrez le panneau n8n et cliquez sur Credentials dans le menu de gauche.
Cliquez sur le bouton + Add Credential en haut à droite.
Tapez OpenAI dans la barre de recherche, puis sélectionnez OpenAI API.

⚙️ Étape 2 : Configurer l'adresse de l'API personnalisée et la clé

Dans la page de configuration des identifiants qui s'ouvre, remplissez les paramètres comme suit :

Name (Nom de l'identifiant) : Donnez un nom facile à retenir, par exemple : CodingPlanX API.
API Key (Clé) : Saisissez votre clé API (sk-xxxxxx...).
Base URL (Étape cruciale) :
- Par défaut, n8n utilise l'adresse officielle d'OpenAI. Nous devons la remplacer.
- Trouvez le paramètre Base URL (si vous ne le voyez pas, cliquez sur Make a custom API call en bas ou assurez-vous que votre version de n8n permet de modifier la Base URL).
- Modifiez l'adresse en :
```
https://api.codingplanx.ai/v1
```
> 💡 Attention : La grande majorité des API compatibles avec le format OpenAI nécessitent le suffixe /v1 après le nom de domaine, veillez à ne pas l'oublier.
Cliquez sur le bouton Save (Enregistrer) en haut à droite. Si la configuration est correcte, le système affichera Connection tested successfully (Test de connexion réussi).

🧩 Étape 3 : Ajouter et configurer le nœud de modèle d'IA dans le workflow

Une fois les identifiants configurés, nous pouvons les utiliser dans un workflow.

Allez dans Workflows, cliquez sur + Add workflow pour créer un nouveau flux de travail.
Cliquez sur le signe + sur la toile, recherchez et ajoutez un nœud OpenAI (choisissez généralement Chat Model).
Cliquez pour ouvrir ce nœud et le configurer :
- Credential to connect with : Sélectionnez CodingPlanX API que vous venez de créer dans le menu déroulant.
- Model (Sélection du modèle) :
  - Comme nous utilisons une API personnalisée, la liste déroulante peut ne pas afficher directement votre modèle.
  - Cliquez sur l'icône ⚙️ (engrenage) à côté du champ Model ou sélectionnez le mode Expression / Custom.
  - Saisissez manuellement le nom du modèle que vous souhaitez utiliser, par exemple : gpt-3.5-turbo.

✅ Étape 4 : Test d'exécution

Connectez un nœud Manual Trigger (Déclencheur manuel) devant le nœud d'IA, ou connectez-le à votre flux Agent de base.
Saisissez un Prompt (invite) de test dans le nœud d'IA, par exemple : "Bonjour, présente-toi s'il te plaît."
Cliquez sur Execute Node (Exécuter le nœud) ou Test step.
Dans le panneau Output (Sortie) à droite, si vous voyez la réponse de l'IA, félicitations ! Le modèle personnalisé a été connecté avec succès ! 🎉

❓ Résolution des problèmes fréquents (FAQ)

Q1 : Que faire en cas d'erreur Invalid API Key ou AuthenticationError ?

Vérifiez si votre clé API a été copiée dans son intégralité, en vous assurant qu'il n'y a pas d'espaces superflus avant ou après.
Vérifiez si le solde de votre compte est suffisant.

Q2 : Erreur Resource not found ou 404 ?

Veuillez vérifier la Base URL saisie à l'étape 2. Assurez-vous d'avoir correctement saisi https://api.codingplanx.ai/v1 (vérifiez si vous avez oublié /v1 ou ajouté une barre oblique en trop).

Q3 : Erreur Model not found ?

Veuillez vérifier si le nom du modèle que vous avez saisi manuellement dans le nœud est correct. Les noms des modèles pris en charge par les plateformes tierces peuvent différer légèrement de ceux officiels, veuillez consulter la liste officielle des modèles de CodingPlanX.