n8n

Le champ Base URL de l’identifiant OpenAI — https://api.kunavo.com/v1, en conservant le /v1 — place chaque OpenAI Chat Model d’un workflow n8n sur Kunavo ; le nœud de modèle lui-même n’a aucun champ d’endpoint.

Credentials  →  Create credential  →  OpenAI
  API Key                      sk-kn-...
  Organization ID (optional)   leave empty
  Base URL                     https://api.kunavo.com/v1     <- keep the /v1

Workflow  →  AI Agent or Basic LLM Chain  →  Chat Model: OpenAI Chat Model
  Credential to connect with   the OpenAI credential above
  Model                        ID mode:  claude-sonnet-5
  Use Responses API            on   → POST /v1/responses
                               off  → POST /v1/chat/completions

Étape par étape

1. Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
2. Dans n8n, créez des identifiants de type OpenAI. Saisissez la clé dans API Key, laissez Organization ID (optional) vide et remplacez la valeur par défaut https://api.openai.com/v1 de Base URL par https://api.kunavo.com/v1. Enregistrez.
3. Ajoutez un nœud AI Agent ou Basic LLM Chain, puis associez-lui un sous-nœud OpenAI Chat Model utilisant ces identifiants. Dans le champ Model, remplacez From List par ID et saisissez l’ID tel qu’il apparaît dans GET /v1/models, par exemple claude-sonnet-5. La liste fonctionne aussi, mais saisir l’ID rend le workflow plus lisible.
4. Choisissez si vous activez Use Responses API : laissez cette option activée, sauf si un outil de votre chaîne nécessite Chat Completions ou si vous souhaitez que le journal d’exécution de n8n affiche une requête de type chat completions.
5. Exécutez le workflow une fois avec une invite d’une ligne avant de le relier à un déclencheur. Une erreur 401 indique un problème de clé ; une erreur 404 avec le code missing_v1_prefix (ou, dans les anciennes exécutions, un message commençant par <!DOCTYPE html>) indique que /v1 a disparu de l’URL de base.

Vérifié avec Code source des identifiants OpenAI de n8n, balise n8n@2.41.4 le 1 octobre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans n8n.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.

Pourquoi l’URL de base se trouve dans les identifiants

Les anciens tutoriels définissent le point de terminaison dans le nœud de modèle. Dans le code source publié, l’option Base URL intégrée au nœud est masquée à partir de la version 1.1 de celui-ci. Le nœud que vous ajoutez aujourd’hui ne comporte donc pas ce champ, et c’est l’URL de base des identifiants qui compte. Ni la documentation d’OpenAI Chat Model de n8n ni sa page sur les identifiants ne décrivent ce champ ; le code source le fait, avec la description « Remplacer l’URL de base par défaut de l’API ». Le nœud HTTP Request constitue une autre méthode : elle fonctionne, mais vous devez alors construire manuellement la requête qu’un nœud AI Agent construit pour vous.

Activer ou désactiver Responses API

• Activée (valeur par défaut du nœud 1.3) — les requêtes sont envoyées à /v1/responses. C’est le seul mode qui affiche les Built-in Tools du nœud : Web Search, File Search et Code Interpreter. Ces outils sont hébergés par OpenAI ; personne ne les a testés via Kunavo. N’en faites pas une dépendance de votre workflow sans les avoir d’abord essayés.
• Désactivée — les requêtes sont envoyées à /v1/chat/completions, le format le plus largement pris en charge et celui à utiliser si un appel d’outil se comporte mal avec l’autre réglage.
• Les outils que vous associez à un AI Agent sont envoyés au modèle sous forme de définitions de fonctions. Cet aller-retour ne faisait pas partie de cette vérification ; effectuez donc un appel d’outil dans un workflow de test avant de vous y fier.

n8n et OpenRouter

n8n fournit un nœud OpenRouter Chat Model distinct avec ses propres identifiants OpenRouter. Ces identifiants comportent un champ API Key et une URL de base masquée, fixée à https://openrouter.ai/api/v1 ; le test appelle la route /key propre à OpenRouter. Le nœud OpenRouter ne peut donc communiquer qu’avec OpenRouter. Si vous souhaitez utiliser OpenRouter, servez-vous de ce nœud avec une clé OpenRouter ; rien d’autre sur cette page n’est nécessaire.

Tout autre point de terminaison compatible avec OpenAI, Kunavo compris, passe par OpenAI Chat Model et l’URL de base des identifiants OpenAI, comme indiqué plus haut. Faites votre choix selon les différences concrètes — les modèles dont vous avez besoin, le mode de paiement souhaité et votre préférence pour un solde commun à n8n et à vos autres outils — et non selon le nœud. La comparaison du côté de Kunavo est présentée dans Kunavo contre OpenRouter.

Maîtriser le coût d’un workflow sans surveillance

• La valeur par défaut de Max Retries est 2, et celle de Timeout, 60000 ms. Une requête qui expire est réessayée ; chaque nouvelle tentative constitue une requête facturée.
• Définissez Maximum Number of Tokens sur les nœuds exécutés pour chaque élément : une boucle sur 1 000 lignes multiplie le coût d’un appel.
• Utilisez une clé Kunavo distincte pour chaque workflow de production afin que la page d’utilisation indique lequel a dépensé quoi, et que vous puissiez en révoquer une sans toucher aux autres.

À quoi ressemblent les erreurs

• « 401 Missing or invalid API key » — l’URL de base est correcte, mais la clé ne l’est pas. Reproduit sur la version 2.41.4.
• « 404 <!DOCTYPE html>… », classée par LangChain comme MODEL_NOT_FOUND — message trompeur : le modèle est correct, mais il manque /v1 à l’URL de base et la requête a abouti sur le site Web. Reproduit sur la version 2.41.4.
• Message JSON indiquant que le modèle n’est pas disponible — l’ID du modèle ne correspond pas exactement à GET /v1/models.