Accueil / Guides / API LLM gratuite pour n8n

API LLM gratuite pour n8n

n8n est un outil d'automatisation de workflows doté de nœuds IA. Son identifiant OpenAI contient un champ Base URL, ce qui permet d'envoyer les requêtes vers n'importe quelle API compatible OpenAI. Ce guide dirige ce champ vers FreeLLMAPI. FreeLLMAPI regroupe les offres gratuites de 45 fournisseurs derrière une seule clé et passe au fournisseur suivant lorsqu'une limite bloque une requête.

Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.

Prérequis

  • n8n, auto-hébergé ou sur n8n Cloud. Une instance cloud ne peut pas atteindre localhost sur votre ordinateur. Pour n8n Cloud, FreeLLMAPI doit avoir une adresse HTTPS publique.
  • FreeLLMAPI, installé avec Docker ou l'application de bureau. Ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys.
  • La clé unifiée de la page Keys de FreeLLMAPI. n8n n'utilise que cette clé.

Installer FreeLLMAPI (macOS ou Linux)

curl -fsSL https://freellmapi.co/install.sh | bash

L'URL de base dépend de l'emplacement de n8n. Dans un conteneur Docker, localhost désigne le conteneur, et non votre ordinateur.

n8n s'exécuteURL de base
Sur l'hôte (npm ou npx)http://localhost:3001/v1
Dans Docker Desktop (macOS, Windows)http://host.docker.internal:3001/v1
Dans Docker sous Linux, même hôte que FreeLLMAPIhttp://freellmapi:3001/v1, après avoir connecté le conteneur n8n au réseau Docker de FreeLLMAPI
n8n CloudL'adresse HTTPS publique de votre serveur FreeLLMAPI, avec /v1 à la fin

Étape 1 : créer l'identifiant OpenAI

  1. Dans n8n, ouvrez Credentials et créez un identifiant de type OpenAI.
  2. Dans API Key, collez votre clé unifiée FreeLLMAPI.
  3. Laissez Organization ID (optional) vide.
  4. Dans Base URL, remplacez https://api.openai.com/v1 par votre URL FreeLLMAPI, par exemple http://host.docker.internal:3001/v1.
  5. Enregistrez l'identifiant.

Tous les nœuds OpenAI qui utilisent cet identifiant envoient maintenant leurs requêtes à FreeLLMAPI. Vos vraies clés de fournisseurs restent dans FreeLLMAPI. Elles ne sont pas placées dans n8n.

Tester l'URL depuis le conteneur n8n

docker exec n8n wget -qO- \
  --header="Authorization: Bearer <unified-key>" \
  http://host.docker.internal:3001/v1/models | head -c 300

Étape 2 : créer un workflow AI Agent

Le nœud AI Agent a besoin d'un sous-nœud de modèle de chat et d'au moins un sous-nœud d'outil. Depuis n8n 1.82.0, chaque nœud AI Agent fonctionne en Tools Agent. L'agent envoie les définitions d'outils au modèle. Le modèle doit donc prendre en charge l'appel d'outils.

  1. Ajoutez un nœud Chat Trigger. Il vous donne une fenêtre de chat pour tester le workflow.
  2. Ajoutez un nœud AI Agent après le déclencheur.
  3. Connectez un sous-nœud OpenAI Chat Model à l'entrée Chat Model de l'agent. Sélectionnez votre identifiant FreeLLMAPI.
  4. Dans Model, passez le mode de From List à ID. Saisissez auto.
  5. Connectez un sous-nœud d'outil, par exemple l'outil Calculator ou un outil HTTP Request.
  6. Ouvrez le chat et envoyez un message de test.

Utilisez le mode ID pour le modèle. Le mode liste affiche le catalogue complet de FreeLLMAPI, qui contient aussi des modèles que vous ne pouvez pas encore appeler. Ces ID sont utiles dans n8n :

ID du modèleUtilisation
autoWorkflows généraux. Le routeur suit votre chaîne de repli.
auto:fastClassification, résumés courts et autres étapes à fort volume
auto:smartÉtapes d'agent qui doivent planifier ou choisir des outils
auto:reliableWorkflows planifiés qui ne doivent pas échouer
auto:<profile>Une chaîne de repli nommée, par exemple une chaîne qui ne contient que des modèles avec appel d'outils

Pour les étapes d'agent, ne gardez dans la chaîne que des modèles avec appel d'outils. Ces modèles gratuits prennent en charge l'appel d'outils actuellement :

Modèles gratuits avec appel d'outils et contexte de 128K+
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
OuiNon
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/jour
50 req/day account-wide (1,000 after a $10 purchase)
OuiOui
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/jour
Shared rate limit
OuiNon
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/jour
70,000 jetons/min
~6M
OuiOui

Affichage de 10 modèles gratuits sur 109 correspondants. Voir tous les modèles.

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

Use Responses API : laissez cette option désactivée sur le nœud OpenAI Chat Model. Les outils intégrés derrière elle (Web Search, File Search, Code Interpreter) sont des services OpenAI. La documentation de FreeLLMAPI ne décrit pas leur prise en charge. Utilisez plutôt les sous-nœuds d'outils n8n pour ces tâches.

Étape 3 : gérer les limites des offres gratuites

Un workflow qui parcourt 500 éléments envoie 500 requêtes. Les offres gratuites limitent le nombre de requêtes par minute et par jour. FreeLLMAPI compte le quota de chaque clé et passe au fournisseur suivant en cas d'erreur 429. Lorsque toutes les clés de la chaîne ont atteint leur limite, la passerelle renvoie 429 avec un en-tête Retry-After.

Définissez ces options pour qu'une limite courte n'arrête pas le workflow :

OùRéglageValeur
OpenAI Chat Model, OptionsMax Retries3 à 5
OpenAI Chat Model, OptionsTimeout60000 ms ou plus pour les prompts longs
Paramètres du nœud (icône en forme d'engrenage)Retry On FailOn
Paramètres du nœudMax. Tries3
Paramètres du nœudWait Between Tries (ms)5000 ou plus
Nœud Loop Over ItemsBatch SizePetits lots, avec un nœud Wait entre eux

Ajoutez des clés d'autres fournisseurs pour augmenter le nombre total de requêtes par jour. Le tableau indique les limites gratuites par fournisseur dans le catalogue actuel.

FournisseurModèles gratuitsMax req/minMax req/jourMax jetons/minJetons/mois (un modèle)Modèle gratuit le plus performant
ElectronHub84---$0.25/week shared recurring creditQwen3.8 Flash (ElectronHub)
qwen3.8-flash
Cloudflare Workers AI39---~5-10MQwen 3.8 27B (Cloudflare Workers AI)
@cf/qwen/qwen3.8-27b
Inferbase38---5,000 requests/month; 100 requests and $0.50 usage/day sharedDeepSeek V4 Flash (fp8) (Inferbase)
deepseek-v4-flash:fp8
AI Horde31---Ongoing volunteer queue; availability variesGemma 4 31B Heretic (AI Horde)
koboldcpp/gemma-4-31B-it-heretic
ACLIDE29---€20/month shared internal usage credits · no cardQwen3.8 Max (ACLIDE)
qwen/qwen3.8-max:free
Google AI Studio21151,000250,000~3MGemini 3.8 Flash
gemini-3.8-flash
Api.Airforce2011,000-free · 1,000 req/day · 1 req/mingpt-oss-20b (Api.Airforce)
gpt-oss-20b
NVIDIA NIM1940--free · 40 RPMGLM 5.3 Flash (NV)
z-ai/glm-5.3-flash
Cohere172033-~1-2MCommand A+ (05-2026)
command-a-plus-05-2026
DreamPrompting141005,000-free · 500K tokens/day · 5,000 req/dayGemini 3.1 Flash-Lite
google/gemini-3.1-flash-lite

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

Utiliser le nœud HTTP Request

Vous pouvez aussi appeler FreeLLMAPI avec le nœud générique HTTP Request. Utilisez cette méthode lorsque vous avez besoin d'un paramètre que le nœud OpenAI n'affiche pas, ou lorsque vous voulez lire les en-têtes de réponse.

  • Méthode : POST
  • URL : http://host.docker.internal:3001/v1/chat/completions
  • En-tête : Authorization avec la valeur Bearer <unified-key>
  • Type de contenu du corps : JSON

Corps JSON

{
  "model": "auto:fast",
  "messages": [
    {"role": "system", "content": "Classify the ticket as billing, bug or other. Reply with one word."},
    {"role": "user", "content": "{{ $json.ticket_text }}"}
  ],
  "temperature": 0
}

La réponse se trouve dans choices[0].message.content. L'en-tête de réponse X-Routed-Via indique le fournisseur et le modèle qui ont répondu. Si le routeur a changé de fournisseur, X-Fallback-Attempts indique le nombre de tentatives échouées.

Dépannage

ProblèmeCauseSolution
Le test de l'identifiant échoue avec une erreur de connexionlocalhost pointe vers le conteneur n8nUtilisez host.docker.internal ou un réseau Docker partagé
Erreur 401Clé incorrecteCollez à nouveau la clé unifiée
La liste des modèles compte des centaines d'entréesLe mode liste lit le catalogue completUtilisez le mode ID et saisissez auto
L'agent répond mais n'utilise jamais d'outilLe modèle choisi ne prend pas en charge l'appel d'outilsUtilisez un modèle du tableau ci-dessus, ou un profil avec des modèles qui gèrent l'appel d'outils
Erreur 429 dans une longue boucleToutes les clés ont atteint leur limiteAjoutez des fournisseurs, utilisez des lots plus petits et activez Retry On Fail
Le nœud dépasse le délaiUn modèle gratuit lent avec un prompt longAugmentez Timeout, ou utilisez auto:fast
Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

Questions fréquentes

Puis-je utiliser une URL de base personnalisée avec le nœud OpenAI de n8n ?

Oui. L'identifiant OpenAI de n8n contient un champ Base URL. Renseignez une URL compatible OpenAI qui se termine par /v1, par exemple http://localhost:3001/v1 pour FreeLLMAPI.

Existe-t-il une API LLM gratuite pour n8n ?

Oui. Les offres gratuites des fournisseurs fonctionnent dans n8n via l'identifiant OpenAI. FreeLLMAPI regroupe de nombreuses offres gratuites derrière une seule clé. Chaque offre a ses propres limites de requêtes.

Quel modèle gratuit fonctionne avec le nœud AI Agent de n8n ?

Utilisez un modèle qui prend en charge l'appel d'outils, car le nœud AI Agent fonctionne en Tools Agent. Le tableau de cette page liste les modèles gratuits avec appel d'outils.

Comment empêcher les workflows n8n d'échouer à cause des limites de débit ?

Définissez Max Retries sur le nœud du modèle de chat, activez Retry On Fail dans les paramètres du nœud et traitez les éléments par petits lots. Ajoutez des clés d'autres fournisseurs pour augmenter le total quotidien.

Est-ce que n8n Cloud fonctionne avec une passerelle LLM auto-hébergée ?

Seulement si la passerelle a une adresse HTTPS publique. n8n Cloud ne peut pas atteindre localhost sur votre ordinateur.

Guides associés

Sources

Tous les guides · Parcourir tous les modèles gratuits