FR ▾
Obtenir une clé API

API compatible OpenAI dans n8n : Guide d'installation

Si vous avez recherché "openai compatible api n8n", la réponse courte est que vous ne modifiez que deux valeurs dans les identifiants OpenAI : l'URL de base et la clé API. Le reste du workflow reste identique à celui d'un nœud OpenAI standard.

Mis à jour le

Workflow d'automatisation isométrique avec des blocs connectés envoyant des données à un terminal API

Points clés

Ce dont vous avez besoin avant de commencer

Une instance n8n (cloud ou auto-hébergée) et une clé API de ce service. Si vous n'avez pas encore de clé, la page Clé API vous guide pour vous inscrire avec Google ou par e-mail et mot de passe. Les nouveaux utilisateurs peuvent obtenir 0,50 $ de crédit d'essai gratuit en un clic sur cette page, valable 7 jours et sans carte bancaire.

Trois valeurs sont à saisir dans n8n :

  • URL de base : https://api.onekeyllmapi.com/v1
  • Clé API : envoyée via Authorization: Bearer <key>, ce que n8n fait pour vous
  • ID de modèle : uncensored

Le service est une API LLM hébergée, textuelle uniquement, qui suit le format de requête OpenAI pour /v1/chat/completions, /v1/responses et /v1/models. Ce n'est pas l'API officielle d'aucun fournisseur de modèle, donc tout ce que n8n envoie à l'endpoint de chat OpenAI fonctionne ici tant qu'il s'agit d'une requête textuelle.

Étape 1 : Créer l'identifiant

Dans n8n, ouvrez Identifiants, choisissez Créer un identifiant et recherchez API OpenAI. Remplissez-le comme suit :

  1. Collez votre clé dans le champ Clé API.
  2. Laissez le champ ID Organisation vide.
  3. Remplacez l'URL de base par défaut par https://api.onekeyllmapi.com/v1. Conservez le /v1 à la fin et n'ajoutez pas /chat/completions.
  4. Enregistrez. n8n effectue un petit appel de test lors de l'enregistrement ; s'il échoue, passez à la section de dépannage ci-dessous.

Conservez un identifiant par environnement. Si vous exécutez une instance n8n de préproduction et une de production, attribuez à chacune sa propre clé afin de pouvoir suivre les dépenses séparément et révoquer l'une sans toucher à l'autre.

Étape 2 : Créer un workflow de chat simple

Commencez par le plus petit élément prouvant la connexion : un déclencheur manuel et un appel de modèle.

  1. Ajoutez un nœud Déclencheur manuel.
  2. Ajoutez un nœud OpenAI (ou le sous-nœud Modèle de chat OpenAI dans une chaîne LLM de base, selon votre version de n8n) et sélectionnez l'identifiant de l'étape 1.
  3. Pour le modèle, cherchez un moyen de saisir un ID manuellement. Les versions récentes de n8n proposent un mode Par ID à côté de la liste. Saisissez-y uncensored. La liste peut être vide ou ne montrer que des noms OpenAI, car n8n la filtre de son côté.
  4. Ajoutez un prompt tel que Résumez ce ticket de support en deux phrases et exécutez le nœud.

Si votre version de n8n impose de choisir dans une liste, utilisez l'approche Requête HTTP dans la section suivante. Elle fonctionne toujours car vous contrôlez toute la requête.

Appel de l'API avec le nœud Requête HTTP

Le nœud Requête HTTP est le moyen le plus prévisible d'appeler cette API depuis n8n, et il expose tous les paramètres acceptés par l'API, y compris seed, stop, top_p et tools. Configurez-le comme suit :

  • Méthode : POST
  • URL : https://api.onekeyllmapi.com/v1/chat/completions
  • Authentification : Type d'identifiant générique avec Authentification par en-tête, nom Authorization, valeur Bearer YOUR_KEY
  • Envoyer le corps : activé, type de contenu JSON

Corps (changez le champ en Expression si vous souhaitez insérer des données provenant de nœuds précédents) :

{
  "model": "uncensored",
  "messages": [
    {"role": "system", "content": "You are a concise assistant."},
    {"role": "user", "content": "Summarize this support ticket in two sentences."}
  ],
  "temperature": 0.4
}

Le texte de réponse se trouve à choices[0].message.content. Dans le nœud suivant, vous pouvez y faire référence avec {{ $json.choices[0].message.content }}.

Pour tester la même requête en dehors de n8n d'abord, exécutez ceci dans un terminal :

curl https://api.onekeyllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

Si curl fonctionne et n8n échoue, le problème vient des paramètres du nœud, et non de votre clé ou de votre solde.

Mode JSON pour les workflows qui analysent la sortie

Les workflows se cassent lorsqu'un modèle enveloppe les données dans du texte descriptif. Le mode JSON demande à l'API de retourner un objet JSON valide, que vous pouvez passer directement à un nœud Définir ou SI. Ajoutez response_format au corps :

{
  "model": "uncensored",
  "response_format": {"type": "json_object"},
  "messages": [
    {"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
    {"role": "user", "content": "The delivery was late but support fixed it fast."}
  ]
}

Deux habitudes rendent cela fiable. Premièrement, dites le mot JSON et nommez les clés dans le prompt, car le mode JSON garantit la syntaxe, pas votre schéma. Deuxièmement, la réponse arrive toujours sous forme de chaîne dans message.content, alors ajoutez un nœud Code ou une expression avec JSON.parse() avant de lire les champs. Dans le nœud OpenAI, le même commutateur apparaît comme une option Format de réponse sous les options du nœud.

Gestion des erreurs 429 et autres

n8n exécute les éléments en parallèle, donc un lot de 50 lignes peut rapidement atteindre les limites. Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute ; une clé d'essai permet 2 et 60. Lorsque vous dépassez, l'API répond HTTP 429 avec le code rate_limited (trop par minute) ou concurrency (trop en même temps). En cas de surcharge temporaire, vous obtenez 429 avec un en-tête Retry-After: 5.

Paramètres pratiques dans n8n :

  • Ouvrez le nœud, allez dans Paramètres, activez Réessayer en cas d'échec, définissez Nombre max de tentatives à 3 ou 4 et Attente entre les tentatives à 5000 ms.
  • Placez un nœud Boucle sur les éléments (taille de lot de 4 à 6) avant l'appel de modèle afin de rester en dessous de 8 requêtes simultanées.
  • Sous les Paramètres du nœud, l'En cas d'erreur peut être défini pour continuer avec une sortie d'erreur, afin qu'une seule ligne défectueuse n'arrête pas l'exécution.

Pour une analyse plus approfondie des deux types de limite, lisez la documentation API. Les autres erreurs sont simples : un 401 signifie que la clé est incorrecte ou que l'en-tête manque le mot Bearer, et un 404 signifie généralement que l'URL de base contient une faute de frappe ou un segment de chemin supplémentaire.

Liste de dépannage

La plupart des échecs proviennent d'une courte liste de causes. Parcourez-la de haut en bas avant de soupçonner le service.

SymptômeCause probableCorrection
401 lors de l'enregistrement ou de l'exécutionClé incorrecte, ou l'en-tête manque BearerCollez à nouveau la clé ; dans l'Authentification par en-tête, la valeur doit commencer par Bearer
404L'URL de base contient une faute de frappe ou un chemin supplémentaireUtilisez exactement https://api.onekeyllmapi.com/v1 dans les identifiants
Modèle non trouvéL'ID du modèle n'est pas saisi comme uncensoredPassez à Mode par ID ou utilisez le nœud Requête HTTP
429 avec concurrencePlus de 8 exécutions simultanées (2 sur une clé d'essai)Traitez par lots avec Boucle sur les éléments et ajoutez des tentatives
Erreur d'analyse JSON en avalLa réponse est une chaîne, ou le prompt n'a pas nommé les clésAnalysez avec JSON.parse() et décrivez les clés dans le prompt système

Lorsque vous contactez le support, incluez l'en-tête de réponse X-Request-Id de l'appel ayant échoué. Dans n8n, vous pouvez afficher les en-têtes en activant Inclure les en-têtes de réponse et le statut dans les options du nœud Requête HTTP.

Tester sans dépenser beaucoup

Utilisez le crédit d'essai pendant que vous développez. Avec 2 requêtes simultanées et 60 requêtes par minute, une clé d'essai est lente pour les lots, mais suffisante pour vérifier un identifiant d'authentification, un prompt et la logique d'analyse. Passez à une clé complète lorsque vous déplacez le workflow vers un programme.

Coût et conception d'un workflow cohérent

La tarification est en paiement à l'usage : 0,15 $ par 1 M de tokens d'entrée et 0,50 $ par 1 M de tokens de sortie, prélevés sur le crédit prépayé. Un workflow qui classe 1 000 e-mails par jour avec 600 tokens d'entrée et 100 tokens de sortie par e-mail utilise 0,6 M de tokens d'entrée (0,09 $) et 0,1 M de tokens de sortie (0,05 $), soit environ 0,14 $ par jour. Les requêtes échouées ou refusées ne sont pas facturées, donc les réessais en cas d'erreur ne doublent pas la facture. Les détails sont sur la page de tarification.

Gardez les prompts courts, envoyez uniquement les champs dont le modèle a besoin, et définissez max_tokens lorsque vous savez que la réponse est brève. Si vous exécutez également des modèles sur votre propre machine, consultez l'article sur l'utilisation d'un LLM local via une API de style OpenAI, qui utilise les mêmes paramètres client.

Questions et réponses

Quels nœuds n8n fonctionnent avec une URL de base personnalisée ?

Tout nœud utilisant l'identifiant OpenAI peut l'utiliser, car le champ URL de base appartient à l'identifiant. Si un nœud n'expose pas le paramètre dont vous avez besoin, utilisez le nœud Requête HTTP.

Pourquoi la liste des modèles est-elle vide ou incorrecte dans n8n ?

n8n charge et filtre la liste de son côté. Saisissez l'ID de modèle uncensored à la main, ou utilisez le nœud HTTP Request où le modèle n'est qu'un champ dans le corps.

Puis-je utiliser le streaming dans n8n ?

L'API prend en charge le streaming via SSE, mais la plupart des nœuds n8n attendent la réponse complète avant de transmettre les données plus loin. Pour les workflows, un appel normal non streamé est plus simple.

Comment vérifier mon solde depuis un workflow ?

Appelez GET /v1/balance, ou consultez l'en-tête X-Balance-USD sur n'importe quelle réponse, et ajoutez un nœud IF qui vous alerte lorsqu'il passe en dessous d'un seuil.

Votre clé est à une étape de formulaire

Créez un compte, copiez la clé, modifiez l'URL de base. C'est tout ce qu'il faut pour la configuration.