Accueil / Guides / Utiliser Aider avec une API LLM gratuite

Utiliser Aider avec une API LLM gratuite

Aider est un programmeur en binôme open source pour le terminal. Il modifie les fichiers de votre dépôt git et crée des commits. Ce guide connecte Aider à des modèles gratuits via FreeLLMAPI. Il présente aussi les réglages d'Aider importants pour les modèles gratuits : format d'édition, modèle faible et taille de la carte du dépôt.

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

Étape 1 : installer FreeLLMAPI

FreeLLMAPI est une passerelle open source. Il fonctionne sur votre ordinateur dans Docker. Il regroupe les offres gratuites de 45 fournisseurs derrière une seule clé compatible OpenAI.

Installer sur macOS ou Linux

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

Ouvrez http://localhost:3001. Ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys. Copiez votre clé unifiée depuis la même page.

Étape 2 : connecter Aider

La commande de configuration écrit ~/.aider.conf.yml. Elle crée d'abord une sauvegarde du fichier existant.

Une seule commande

npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aider

Le fichier écrit par la commande ressemble à ceci :

~/.aider.conf.yml

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"

Le préfixe openai/ est obligatoire. Il indique à Aider d'envoyer le nom du modèle à une API compatible OpenAI. Pour utiliser des variables d'environnement sans fichier, procédez ainsi :

Variables d'environnement uniquement

export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/auto

Aider cherche .aider.conf.yml dans votre répertoire personnel, puis à la racine de votre dépôt git, puis dans le répertoire courant. Le fichier chargé en dernier est prioritaire. Un fichier de projet peut donc changer le modèle pour un seul dépôt.

Étape 3 : choisir les modèles

Aider envoie vos fichiers et une carte du dépôt dans chaque requête. Il n'a pas besoin de l'appel d'outils pour sa boucle d'édition principale, car il lit les modifications dans le texte du modèle. Une grande fenêtre de contexte et un bon suivi des instructions sont plus importants. Le tableau indique les modèles gratuits avec au moins 128K de contexte à ce jour.

Modèles gratuits pour Aider : contexte de 128K+, par intelligence
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3APINex, UnoRouter1M5 req/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
OuiNon
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 de plus1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashAPINex, Google AI Studio1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
OuiOui
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
Deepseek V4.1 FlashAPINex1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NonNon
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
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetNonNon
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 de plus262K30 req/min
250 req/jour
70,000 jetons/min
~6M
OuiOui

Affichage de 12 modèles gratuits sur 184 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.

Utilisez openai/auto pour laisser le routeur choisir un modèle. Utilisez openai/auto:smart pour privilégier les modèles les plus intelligents. Pour figer un seul modèle, utilisez openai/ suivi d'un identifiant du catalogue issu de GET /v1/models.

Vous pouvez aussi définir les modèles d'une session en ligne de commande. Cet exemple utilise les modèles les plus performants pour les modifications. Il utilise des modèles rapides pour les messages de commit et les résumés d'historique de chat :

Modèles pour une session

aider --model openai/auto:smart --weak-model openai/auto:fast

Pour un profil prévu, créez une chaîne de repli sur le tableau de bord FreeLLMAPI, par exemple une chaîne nommée coding. Utilisez ensuite --model openai/auto:coding. Un nom de profil inconnu renvoie une erreur 400, donc la requête ne passe pas vers une autre chaîne sans avertissement.

Réglages d'Aider pour les modèles gratuits

Aider connaît les réglages des modèles bien connus. Un modèle de passerelle tel que auto n'est pas connu, donc définissez ces valeurs vous-même.

RéglageRôleValeur recommandée pour les modèles gratuits
edit-formatLe format que le modèle utilise pour envoyer les modifications : whole, diff, diff-fenced ou udiffdiff pour les modèles performants. whole pour les modèles faibles, car il est plus simple mais envoie davantage de jetons.
weak-modelLe modèle pour les messages de commit et les résumés d'historique de chatopenai/auto:fast, pour que les petites tâches n'utilisent pas le quota de votre modèle performant
map-tokensLe nombre de jetons pour la carte du dépôt. 0 la désactive.1024 ou moins sur les petites offres gratuites
architectUn modèle planifie la modification et un modèle éditeur écrit les modificationsFacultatif. Il double le nombre de requêtes.

~/.aider.conf.yml avec les réglages pour modèles gratuits

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024

Pour donner à Aider la fenêtre de contexte d'un modèle de passerelle, ajoutez un fichier .aider.model.metadata.json. La clé est le nom complet du modèle. Aider cherche ce fichier aux mêmes emplacements que le fichier de configuration.

~/.aider.model.metadata.json

{
  "openai/auto": {
    "max_input_tokens": 128000,
    "max_output_tokens": 8192,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Limites de débit et basculement

Les offres gratuites ont des limites par minute et par jour. FreeLLMAPI compte l'usage de chaque clé. Lorsqu'un fournisseur envoie une erreur 429, le routeur envoie la requête au modèle suivant de votre chaîne. Aider ne voit pas l'erreur et continue.

  • Ajoutez des clés d'au moins quatre fournisseurs. Plus de fournisseurs donnent plus de requêtes par jour.
  • Ajoutez seulement les fichiers que vous voulez modifier avec /add. Chaque fichier figure dans chaque requête.
  • Utilisez /clear entre les tâches pour envoyer un historique de chat plus court. Un historique court réduit aussi les jetons par minute.
  • Utilisez /drop pour retirer les fichiers dont vous n'avez plus besoin.

Dépannage

ProblèmeCauseSolution
« Model openai/auto: Unknown context window size and costs, using sane defaults. »Aider ne connaît pas le modèle de passerelleCet avertissement est en général sans danger. Pour le supprimer, ajoutez .aider.model.metadata.json.
La modification ne s'est pas appliquéeLe modèle n'a pas suivi le format d'éditionUtilisez --edit-format whole, ou un modèle plus performant
401 « Invalid API key »Aider envoie une autre clé, par exemple depuis un autre fichier de configurationVérifiez les fichiers de configuration du répertoire personnel, de la racine git et du répertoire courant
Aider appelle api.openai.comLe préfixe openai/ est utilisé, mais l'URL de base n'est pas définieDéfinissez openai-api-base ou OPENAI_API_BASE
« All models rate-limited after N attempts »Toutes les clés ont atteint leur limiteAjoutez des clés d'autres fournisseurs, ou réduisez map-tokens
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 Aider gratuitement ?

Oui. Aider est open source. Pointez-le vers FreeLLMAPI avec openai-api-base et le préfixe de modèle openai/. La passerelle utilise les offres gratuites des fournisseurs, donc l'inférence coûte 0 $.

Comment utiliser Aider avec une API compatible OpenAI ?

Définissez OPENAI_API_BASE et OPENAI_API_KEY, puis lancez aider --model openai/. Le préfixe openai/ est obligatoire. Vous pouvez mettre les mêmes valeurs dans .aider.conf.yml.

Quel format d'édition utiliser avec les modèles gratuits ?

Utilisez diff pour les modèles performants, car il envoie moins de jetons. Si les modifications ne s'appliquent pas, utilisez whole. Il est plus simple pour les modèles faibles, mais envoie le fichier complet à chaque fois.

Que signifie « Unknown context window size and costs, using sane defaults » ?

Aider ne connaît pas le nom du modèle, donc il utilise des valeurs par défaut. L'avertissement est en général sans danger. Ajoutez .aider.model.metadata.json avec la fenêtre de contexte pour le supprimer.

Quel modèle gratuit est le meilleur pour Aider ?

Utilisez un modèle avec une grande fenêtre de contexte et un bon suivi des instructions. Le tableau de cette page montre les modèles gratuits les plus performants avec 128K de contexte ou plus à ce jour.

Guides associés

Sources

Tous les guides · Parcourir tous les modèles gratuits