Folosiți Aider cu un API LLM gratuit
Aider este un programator în pereche, open-source, pentru terminal. Editează fișiere în depozitul dvs. git și face commit-uri. Acest ghid conectează Aider la modele gratuite prin FreeLLMAPI. Arată și setările Aider importante pentru modelele gratuite: formatul de editare, modelul slab și dimensiunea repo map.
Codul, numele modelelor și etichetele live din catalog sunt afișate în engleză.
Pasul 1: Instalați FreeLLMAPI
FreeLLMAPI este un gateway open-source. Rulează pe calculatorul dvs. în Docker. Grupează nivelurile gratuite ale 45 furnizori în spatele unei singure chei compatibile cu OpenAI.
Instalare pe macOS sau Linux
curl -fsSL https://freellmapi.co/install.sh | bashDeschideți http://localhost:3001. Adăugați cel puțin două chei gratuite de la furnizori în pagina Keys. Copiați cheia unificată din aceeași pagină.
Pasul 2: Conectați Aider
Comanda de configurare scrie ~/.aider.conf.yml. Mai întâi face o copie de rezervă a fișierului existent.
O singură comandă
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>
aiderFișierul pe care îl scrie comanda arată așa:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"Prefixul openai/ este obligatoriu. Îi spune Aider să trimită numele modelului către un API compatibil cu OpenAI. Pentru a folosi variabile de mediu și niciun fișier, procedați așa:
Doar variabile de mediu
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider caută .aider.conf.yml în folderul de acasă, apoi în rădăcina depozitului git, apoi în folderul curent. Fișierul care se încarcă ultimul are prioritate. Un fișier de proiect poate deci schimba modelul pentru un singur depozit.
Pasul 3: Alegeți modele
Aider trimite fișierele dvs. și un repo map în fiecare cerere. Nu are nevoie de apel de instrumente pentru bucla principală de editare, pentru că citește modificările din textul modelului. Contează mai mult o fereastră de context mare și o bună urmare a instrucțiunilor. Tabelul arată modelele gratuite cu cel puțin 128K de context astăzi.
| Model | Gratuit pe | Context | Limite gratuite (cea mai bună ofertă) | Instrumente | Viziune |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 cereri/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Da | Nu |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 în plus | 1M | 40 cereri/min 40 RPM | Da | Da |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 cereri/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Da | Da |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Da | Nu |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| Deepseek V4.1 Flash | APINex | 1M | 5 cereri/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Nu | Nu |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 cereri/min 50 cereri/zi 50 req/day account-wide (1,000 after a $10 purchase) | Da | Da |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 cereri/min 50 cereri/zi Shared rate limit | Da | Nu |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Nu | Nu |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 în plus | 262K | 30 cereri/min 250 cereri/zi 70,000 tokeni/min ~6M | Da | Da |
Se afișează 12 din 184 modele gratuite care se potrivesc. Vezi toate modelele.
Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.
Folosiți openai/auto ca să lăsați routerul să aleagă un model. Folosiți openai/auto:smart ca să preferați modelele cu cea mai mare inteligență. Ca să fixați un singur model, folosiți openai/ și un ID din catalog de la GET /v1/models.
Puteți seta și modelele pentru o singură sesiune din linia de comandă. Acest exemplu folosește cele mai puternice modele pentru modificări. Folosește modele rapide pentru mesajele de commit și pentru rezumatele istoricului de chat:
Modele pentru o singură sesiune
aider --model openai/auto:smart --weak-model openai/auto:fastPentru un profil planificat, creați un lanț de rezervă în panoul de control FreeLLMAPI, de exemplu un lanț numit coding. Apoi folosiți --model openai/auto:coding. Un nume de profil necunoscut returnează o eroare 400, deci cererea nu merge pe alt lanț fără știrea dvs.
Setările Aider pentru modelele gratuite
Aider cunoaște setările pentru modelele bine cunoscute. Un model de gateway, precum auto, nu este cunoscut, deci setați aceste valori singur.
| Setare | Ce face | Valoare recomandată pentru modelele gratuite |
|---|---|---|
edit-format | Formatul în care modelul trimite modificările: whole, diff, diff-fenced sau udiff | diff pentru modele puternice. whole pentru modele slabe, pentru că este mai simplu, dar trimite mai mulți tokeni. |
weak-model | Modelul pentru mesajele de commit și pentru rezumatele istoricului de chat | openai/auto:fast, ca sarcinile mici să nu folosească cota modelului dvs. puternic |
map-tokens | Numărul de tokeni pentru repo map. 0 îl dezactivează. | 1024 sau mai puțin, pe nivelurile gratuite mici |
architect | Un model planifică modificarea, iar un model editor scrie modificările | Opțional. Dublează numărul de cereri. |
~/.aider.conf.yml cu setări pentru modelele gratuite
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: 1024Ca să dați Aider fereastra de context a unui model de gateway, adăugați un fișier .aider.model.metadata.json. Cheia este numele complet al modelului. Aider caută acest fișier în aceleași locuri ca fișierul de configurare.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Limite de cereri și failover
Nivelurile gratuite au limite pe minut și pe zi. FreeLLMAPI numără utilizarea fiecărei chei. Când un furnizor trimite o eroare 429, routerul trimite cererea la următorul model din lanțul dvs. Aider nu vede eroarea și continuă.
- Adăugați chei de la patru sau mai mulți furnizori. Mai mulți furnizori înseamnă mai multe cereri pe zi.
- Adăugați doar fișierele pe care vreți să le modificați, cu
/add. Fiecare fișier apare în fiecare cerere. - Folosiți
/clearîntre sarcini ca să trimiteți un istoric de chat mai scurt. Un istoric scurt scade și tokenii pe minut. - Folosiți
/dropca să scoateți fișierele care nu mai sunt necesare.
Depanare
| Problemă | Cauză | Remediere |
|---|---|---|
| „Model openai/auto: fereastra de context și costurile nu sunt cunoscute, se folosesc valori implicite.” | Aider nu cunoaște modelul de gateway | Acest avertisment este de obicei inofensiv. Ca să-l eliminați, adăugați .aider.model.metadata.json. |
| Modificarea nu a fost aplicată | Modelul nu a urmat formatul de editare | Folosiți --edit-format whole, sau un model mai puternic |
401 „Cheie API invalidă” | Aider trimite o cheie diferită, de exemplu dintr-un alt fișier de configurare | Verificați fișierele de configurare din folderul de acasă, din rădăcina git și din folderul curent |
| Aider apelează api.openai.com | Se folosește prefixul openai/, dar adresa de bază nu este setată | Setați openai-api-base sau OPENAI_API_BASE |
| „Toate modelele au atins limita de cereri după N încercări” | Toate cheile au atins limita | Adăugați chei de la mai mulți furnizori sau micșorați map-tokens |
Întrebări frecvente
Pot folosi Aider gratuit?
Da. Aider este open-source. Indicați-l spre FreeLLMAPI cu openai-api-base și prefixul de model openai/. Gateway-ul folosește niveluri gratuite de la furnizori, deci inferența costă 0 $.
Cum folosesc Aider cu un API compatibil OpenAI?
Setați OPENAI_API_BASE și OPENAI_API_KEY, apoi rulați aider --model openai/
Ce format de editare ar trebui să folosesc cu modelele gratuite?
Folosiți diff pentru modele puternice, pentru că trimite mai puțini tokeni. Dacă modificările nu se aplică, folosiți whole. Este mai simplu pentru modele slabe, dar trimite tot fișierul de fiecare dată.
Ce înseamnă mesajul „fereastra de context și costurile nu sunt cunoscute, se folosesc valori implicite”?
Aider nu cunoaște numele modelului, deci folosește valori implicite. Avertismentul este de obicei inofensiv. Adăugați .aider.model.metadata.json cu fereastra de context ca să-l eliminați.
Care model gratuit este cel mai bun pentru Aider?
Folosiți un model cu o fereastră de context mare și o bună urmare a instrucțiunilor. Tabelul din această pagină arată cele mai puternice modele gratuite cu 128K sau mai mult context astăzi.
Ghiduri înrudite
- Folosiți OpenCode cu un API LLM gratuit
- Folosiți Codex CLI cu modele gratuite
- Cele mai bune API-uri gratuite pentru modele de cod
- URL-uri de bază gratuite compatibile OpenAI
- API LLM gratuit cu context de 1 milion de tokeni
Surse
- Aider docs: OpenAI-compatible APIs (verificat 20 November 2026)
- Aider docs: YAML config file (verificat 20 November 2026)
- Aider docs: options reference (verificat 20 November 2026)
- Aider docs: edit formats (verificat 20 November 2026)
- Aider docs: model warnings (verificat 20 November 2026)
- Aider docs: advanced model settings (verificat 20 November 2026)
- FreeLLMAPI CLI generators (verificat 20 November 2026)