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 :
- Collez votre clé dans le champ Clé API.
- Laissez le champ ID Organisation vide.
- 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. - 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.
- Ajoutez un nœud Déclencheur manuel.
- 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.
- 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é. - 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, valeurBearer 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ôme | Cause probable | Correction |
|---|---|---|
| 401 lors de l'enregistrement ou de l'exécution | Clé incorrecte, ou l'en-tête manque Bearer | Collez à nouveau la clé ; dans l'Authentification par en-tête, la valeur doit commencer par Bearer |
| 404 | L'URL de base contient une faute de frappe ou un chemin supplémentaire | Utilisez exactement https://api.onekeyllmapi.com/v1 dans les identifiants |
| Modèle non trouvé | L'ID du modèle n'est pas saisi comme uncensored | Passez à Mode par ID ou utilisez le nœud Requête HTTP |
| 429 avec concurrence | Plus 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 aval | La réponse est une chaîne, ou le prompt n'a pas nommé les clés | Analysez 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.
